Package (Java Platform SE 8 )

java.lang.Object
- java.lang.Package

All Implemented Interfaces:

AnnotatedElement
```
public class 软件包
extends Object
implements AnnotatedElement
```
软件包对象包含有关Java包的实现和规范的版本信息。该版本信息由加载该类的ClassLoader实例检索并提供。通常，它存储在与类分发的清单中。
构成包的一组类可以实现特定的规范，如果是这样，则规范标题，版本号和供应商字符串标识该规范。应用程序可以询问该软件包是否与特定版本兼容，有关详细信息，请参阅isCompatibleWith方法。

规范版本号使用由句点“。”分隔的非负十进制整数组成的语法，例如“2.0”或“1.2.3.4.5.6.7”。这允许使用可扩展数字来表示主要，次要，微型等版本。版本规范由以下形式语法描述：

SpecificationVersion:

Digits RefinedVersion_opt

RefinedVersion:

. Digits

. Digits RefinedVersion

Digits:

Digit

Digits

Digit:

any character for which Character.isDigit(char) returns true, e.g. 0, 1, 2, ...

实施标题，版本和供应商字符串标识一个实现，并且可以方便地提供，以便在发生问题时对所涉及的包进行准确的报告。所有三个实现字符串的内容都是供应商特定的。实现版本字符串没有指定的语法，应该仅与所需版本标识符相等才能进行比较。

在每个ClassLoader实例中，来自同一个java包的所有类都具有相同的Package对象。静态方法允许通过名称找到一个包，或者找到当前类加载器已知的所有包的集合。

另请参见：

ClassLoader.definePackage(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.net.URL)

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`<A extends Annotation> A`	`getAnnotation(类<A> annotationClass)` 返回该元素的，如果这样的注释，否则返回null指定类型的注释。
`Annotation[]`	`getAnnotations()` 返回此元素上存在的注释。
`<A extends Annotation> A[]`	`getAnnotationsByType(类<A> annotationClass)` 返回与此元素相关联的注释。
`<A extends Annotation> A`	`getDeclaredAnnotation(类<A> annotationClass)` 如果这样的注释直接存在，则返回指定类型的元素注释，否则返回null。
`Annotation[]`	`getDeclaredAnnotations()` 返回直接存在于此元素上的注释。
`<A extends Annotation> A[]`	`getDeclaredAnnotationsByType(类<A> annotationClass)` 如果此类注释直接存在或间接存在，则返回该元素的注释（指定类型）。
`String`	`getImplementationTitle()` 返回此包的标题。
`String`	`getImplementationVendor()` 返回提供此实施的组织，供应商或公司的名称。
`String`	`getImplementationVersion()` 返回这个实现的版本。
`String`	`getName()` 返回此包的名称。
`static 软件包`	`getPackage(String name)` 在呼叫者 `ClassLoader`实例中按名称查找包。
`static 软件包[]`	`getPackages()` 获取目前为呼叫者的 `ClassLoader`实例所知道的所有软件包。
`String`	`getSpecificationTitle()` 返回此程序包实现的规范的标题。
`String`	`getSpecificationVendor()` 返回拥有和维护实现此程序包的类的规范的组织，供应商或公司的名称。
`String`	`getSpecificationVersion()` 返回此程序包实现的规范的版本号。
`int`	`hashCode()` 返回从包名称计算的哈希码。
`boolean`	`isAnnotationPresent(类<? extends Annotation> annotationClass)` 如果此元素上存在指定类型的注释，则返回true，否则返回false。
`boolean`	`isCompatibleWith(String desired)` 将该软件包的规格版本与所需版本进行比较。
`boolean`	`isSealed()` 如果封装密封，则返回true。
`boolean`	`isSealed(URL url)` 如果这个包是针对指定的代码源URL密封的，则返回true。
`String`	`toString()` 返回此包的字符串表示形式。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, notify, notifyAll, wait, wait, wait

- 方法详细信息
  - getName
```
public String getName()
```
    返回此包的名称。
    
    结果
    
    如在 The Java™ Language Specification部分6.5.3中定义这个包的完全合格的名称，例如， 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()
```
    返回提供此实施的组织，供应商或公司的名称。
    
    结果
    
    实施该包的供应商
  - isSealed
```
public boolean isSealed()
```
    如果封装密封，则返回true。
    
    结果
    
    如果包装密封，则为真，否则为false
  - isSealed
```
public boolean isSealed(URL url)
```
    如果这个包是针对指定的代码源URL密封的，则返回true。
    
    参数
    
    url - 代码源网址
    
    结果
    
    如果这个包是相对于url密封的，则为true
  - isCompatibleWith
```
public boolean isCompatibleWith(String desired)
                         throws NumberFormatException
```
    将该软件包的规格版本与所需版本进行比较。如果此包规范版本号大于或等于所需版本号，则返回true。
    通过顺序比较期望和规格字符串的相应组件来比较版本号。每个组件都被转换为十进制整数，并将值进行比较。如果规格值大于所需值，则返回true。如果返回值小于false。如果值相等，则会跳过周期，并比较下一对组件。
    
    参数
    
    desired - 所需版本的版本字符串。
    
    结果
    
    如果此软件包的版本号大于或等于所需的版本号，则为true
    
    异常
    
    NumberFormatException - 如果所需或当前版本不是正确的点缀形式。
  - getPackage
```
public static 软件包 getPackage(String name)
```
    在呼叫者ClassLoader实例中按名称查找包。调用者ClassLoader实例用于查找与命名类相对应的包实例。如果呼叫者ClassLoader实例为空，则会搜索由系统ClassLoader实例加载的包的集合以查找命名的包。
    仅当类加载器使用适当的属性创建包实例时，包才具有版本和规范的属性。通常，这些属性在伴随类的清单中定义。
    
    参数
    
    name - 一个包名，例如java.lang。
    
    结果
    
    请求的名称的包。如果存档或代码库中没有可用的软件包信息，它可能为null。
  - getPackages
```
public static 软件包[] getPackages()
```
    获取目前为呼叫者的ClassLoader实例知道的所有包。这些包对应于通过或通过名称加载到该ClassLoader实例的类。如果调用者的ClassLoader实例是引导ClassLoader实例，这在一些实现中可以由null表示，则仅返回与引导ClassLoader实例加载的类对应的ClassLoader 。
    
    结果
    
    一组新的包，已知的呼叫者ClassLoader实例。如果没有知道，则返回零长度数组。
  - hashCode
```
public int hashCode()
```
    返回从包名称计算的哈希码。
    
    重写：
    
    hashCode在类别 Object
    
    结果
    
    从包名称计算的哈希码。
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    返回此包的字符串表示形式。它的值是字符串“package”和包名称。如果定义了包标题，则将其附加。如果定义了包版本，则会附加它。
    
    重写：
    
    toString在类别 Object
    
    结果
    
    包的字符串表示形式。
  - getAnnotation
```
public <A extends Annotation> A getAnnotation(类<A> annotationClass)
```
    说明从界面： AnnotatedElement复制
    
    返回该元素的，如果这样的注释，否则返回null指定类型的注释。
    
    Specified by:
    
    getAnnotation在界面 AnnotatedElement
    
    参数类型
    
    A - 要查询的注释类型，如果存在则返回
    
    参数
    
    annotationClass - 对应于注释类型的Class对象
    
    结果
    
    该元素的注释指定的注释类型，如果存在于此元素，否则为null
    
    异常
    
    NullPointerException - 如果给定的注释类为空
    
    从以下版本开始：
    
    1.5
  - isAnnotationPresent
```
public boolean isAnnotationPresent(类<? extends Annotation> annotationClass)
```
    如果此元素上存在指定类型的注释，则返回true，否则返回false。该方法主要用于方便访问标记注释。
    此方法返回的真值相当于： getAnnotation(annotationClass) != null
    
    默认方法的主体被指定为上述代码。
    
    Specified by:
    
    isAnnotationPresent在界面 AnnotatedElement
    
    参数
    
    annotationClass - 对应于注释类型的Class对象
    
    结果
    
    如果此元素上存在指定注释类型的注释，则为true，否则为false
    
    异常
    
    NullPointerException - 如果给定的注释类为空
    
    从以下版本开始：
    
    1.5
  - getAnnotationsByType
```
public <A extends Annotation> A[] getAnnotationsByType(类<A> annotationClass)
```
    说明从界面： AnnotatedElement复制
    
    返回与此元素相关联的注释 。如果没有与此元素相关联的注释，则返回值为长度为0.的数组。此方法与AnnotatedElement.getAnnotation(Class)之间的区别在于此方法检测其参数是否为可重复注释类型 （JLS 9.6），如果是，则尝试通过“查看”容器注释来查找该类型的一个或多个注释。该方法的调用者可以自由修改返回的数组; 它将对返回给其他调用者的数组没有影响。
    
    Specified by:
    
    getAnnotationsByType在界面 AnnotatedElement
    
    参数类型
    
    A - 查询的注释类型，如果存在则返回
    
    参数
    
    annotationClass - 对应于注释类型的Class对象
    
    结果
    
    如果与此元素相关联，则指定注释类型的所有元素注释，否则为长度为零的数组
    
    异常
    
    NullPointerException - 如果给定的注释类为空
    
    从以下版本开始：
    
    1.8
  - getAnnotations
```
public Annotation[] getAnnotations()
```
    说明从界面： AnnotatedElement复制
    
    返回此元素上存在的注释。如果没有存在于此元素上注解，返回值是长度为0这种方法的调用者可以随意修改返回的数组的数组; 它将对返回给其他调用者的数组没有影响。
    
    Specified by:
    
    getAnnotations在界面 AnnotatedElement
    
    结果
    
    此元素上出现的注释
    
    从以下版本开始：
    
    1.5
  - getDeclaredAnnotation
```
public <A extends Annotation> A getDeclaredAnnotation(类<A> annotationClass)
```
    说明从界面： AnnotatedElement复制
    
    如果这样的注释直接存在 ，则返回指定类型的元素注释，否则返回null。此方法忽略继承的注释。（如果此元素上没有注释，则返回null）
    
    Specified by:
    
    getDeclaredAnnotation在界面 AnnotatedElement
    
    参数类型
    
    A - 要查询的注释类型，如果直接出现则返回
    
    参数
    
    annotationClass - 对应于注释类型的Class对象
    
    结果
    
    如果直接出现在该元素上，则指定注释类型的元素注释，否则为null
    
    异常
    
    NullPointerException - 如果给定的注释类为空
    
    从以下版本开始：
    
    1.8
  - getDeclaredAnnotationsByType
```
public <A extends Annotation> A[] getDeclaredAnnotationsByType(类<A> annotationClass)
```
    说明从界面： AnnotatedElement复制
    
    如果此类注释直接存在或间接存在，则返回该元素的注释（指定类型）。此方法忽略继承的注释。如果在该元素上没有直接或间接存在的指定注释，则返回值是长度为0的数组。此方法与AnnotatedElement.getDeclaredAnnotation(Class)之间的区别在于该方法检测其参数是否是可重复注释类型 （JLS 9.6），以及如果是，尝试通过“查看”容器注释（如果存在）来查找该类型的一个或多个注释。该方法的调用者可以自由修改返回的数组; 它将对返回给其他调用者的数组没有影响。
    
    Specified by:
    
    getDeclaredAnnotationsByType在界面 AnnotatedElement
    
    参数类型
    
    A - 直接或间接出现的查询和返回的注释类型
    
    参数
    
    annotationClass - 对应于注释类型的Class对象
    
    结果
    
    指定注释类型的所有这些元素的注释，如果直接或间接地存在于该元素上，否则为长度为零的数组
    
    异常
    
    NullPointerException - 如果给定的注释类为空
    
    从以下版本开始：
    
    1.8
  - getDeclaredAnnotations
```
public Annotation[] getDeclaredAnnotations()
```
    说明从界面： AnnotatedElement复制
    
    返回直接存在于此元素上的注释。此方法忽略继承的注释。如果此元素上没有直接显示的注释，则返回值为长度为0的数组。此方法的调用者可以自由修改返回的数组; 它将对返回给其他调用者的数组没有影响。
    
    Specified by:
    
    getDeclaredAnnotations在界面 AnnotatedElement
    
    结果
    
    此元素上直接显示的注释
    
    从以下版本开始：
    
    1.5

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Package

方法摘要

Methods inherited from class java.lang.Object

方法详细信息

getName

getSpecificationTitle

getSpecificationVersion

getSpecificationVendor

getImplementationTitle

getImplementationVersion

getImplementationVendor

isSealed

isSealed

isCompatibleWith

getPackage

getPackages

hashCode

toString

getAnnotation

isAnnotationPresent

getAnnotationsByType

getAnnotations

getDeclaredAnnotation

getDeclaredAnnotationsByType

getDeclaredAnnotations