|
|||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | ||||||||
java.lang
类 Package
java.lang.Objectjava.lang.Package
- 所有已实现的接口：
- AnnotatedElement
-
public class Package
- extends Object
- implements AnnotatedElement
Package 对象包含有关 Java 包的实现和规范的版本信息。通过用于加载类的 ClassLoader
组成包的类集可以实现一个特定规范，如此一来，就可以通过规范标题、版本号和供应商字符串来标识该规范。应用程序可以询问包是否与特定版本兼容，有关详细信息，请参阅 isCompatibleWith
规范的版本号使用了一个由句点 "." 分隔的十进制正整数组成的语法，例如 "2.0" 或 "1.2.3.4.5.6.7"。这允许使用可扩展的编号来表示主版本号、次版本号、缩微版本号，等等。版本规范是由下列形式的语法描述的：
- SpecificationVersion:
- Digits RefinedVersionopt
- RefinedVersion:
.Digits.Digits RefinedVersion- Digits:
- Digit
- Digits
- Digit:
Character.isDigit(char)会对其返回true的任何字符，如 0、1、2……
实现标题、版本和供应商字符串共同标识了一个实现，并且可以很方便地使用它们来支持出现问题时所涉及的包的准确报告。三个实现字符串内容都是特定于供应商的。实现版本字符串没有特定的语法，并且应该只在为了使它们等同于所需的版本标识符时对它们进行比较。
在每一个 ClassLoader 实例中，相同 java 包中的所有类都有相同的 Package 对象。静态方法允许通过名称或当前类加载器已知的所有包的集合来找到包。
| 方法摘要 | ||
|---|---|---|
|
getAnnotation(Class<A> annotationClass) 如果存在该元素的指定类型的注释，则返回这些注释，否则返回 null。 |
|
Annotation[] |
getAnnotations() 返回此元素上存在的所有注释。 |
|
Annotation[] |
getDeclaredAnnotations() 返回直接存在于此元素上的所有注释。 |
|
String |
getImplementationTitle() 返回此包的标题。 |
|
String |
getImplementationVendor() 返回提供该实现的组织、供应商或公司的名称。 |
|
String |
getImplementationVersion() 返回该实现的版本。 |
|
String |
getName() 返回此包的名称。 |
|
static Package |
getPackage(String name) 通过调用方的 ClassLoader 实例中的名称找到一个包。 |
|
static Package[] |
getPackages() 获得调用方的 ClassLoader 实例当前已知的所有包。 |
|
String |
getSpecificationTitle() 返回此包实现的规范标题。 |
|
String |
getSpecificationVendor() 返回拥有并维护实现此包的类规范的组织、供应商或公司的名称。 |
|
String |
getSpecificationVersion() 返回此包实现的规范的版本号。 |
|
int |
hashCode() 返回从包名称计算的哈希代码。 |
|
boolean |
isAnnotationPresent(Class<? extends Annotation> annotationClass) 如果指定类型的注释存在于此元素上，则返回 true，否则返回 false。 |
|
boolean |
isCompatibleWith(String desired) 比较此包的规范版本和所需版本。 |
|
boolean |
isSealed() 如果此包是密封的，则返回 ture。 |
|
boolean |
isSealed(URL url) 如果此包对于指定的代码源 url 是密封的，则返回 ture。 |
|
String |
toString() 返回此 Package 的字符串表示形式。 |
|
| 从类 java.lang.Object 继承的方法 |
|---|
clone, equals, finalize, getClass, notify, notifyAll, wait, wait, wait |
| 方法详细信息 |
|---|
getName
public String getName()
- 返回此包的名称。
-
-
- 返回：
- 使用 Java 语言用于包的点表示法 (dot notation) 的那个包的名称。比如 java.lang
getSpecificationTitle
public String getSpecificationTitle()
- 返回此包实现的规范标题。
-
-
- 返回：
- 规范的标题，如果不知道此标题，则返回 null。
getSpecificationVersion
public String getSpecificationVersion()
- 返回此包实现的规范的版本号。该版本字符串必须是以 "." 分隔的十进制正整数的序列，并可能有前导零。在比较版本字符串时，比较最重要的数字。
-
-
- 返回：
- 规范版本，如果不知道该版本，则返回 null。
getSpecificationVendor
public String getSpecificationVendor()
- 返回拥有并维护实现此包的类规范的组织、供应商或公司的名称。
-
-
- 返回：
- 规范的供应商，如果不知道此供应商，则返回 null。
getImplementationTitle
public String getImplementationTitle()
- 返回此包的标题。
-
-
- 返回：
- 实现的标题，如果不知道此标题，则返回 null。
getImplementationVersion
public String getImplementationVersion()
- 返回该实现的版本。它由该实现的供应商分配的任何字符串组成，并且没有任何由 Java 运行时指定或需要的特定语法。可以对实现的版本进行比较，使其等同于此包的供应商用于该实现的其他包版本字符串。
-
-
- 返回：
- 实现的版本，如果不知道此版本，则返回 null。
getImplementationVendor
public String getImplementationVendor()
- 返回提供该实现的组织、供应商或公司的名称。
-
-
- 返回：
- 实现此包的供应商。
