Package (Java Platform SE 8 )

java.lang.Object
- java.lang.Package

All Implemented Interfaces:

AnnotatedElement
```
public class 软件包
extends Object
implements AnnotatedElement
```
软件包对象包含关于一个java包的实施和规范的版本信息。这个版本的信息检索和加载类的实例提供 ClassLoader（ES）。通常情况下，它存储在分发的类中的清单中。
组成包的类可以实现一个特定的规范，如果是这样的规范标题，版本号和供应商字符串确定规范。应用程序可以问包是与一个特定的版本兼容，请参阅isCompatibleWith方法。

规范的版本号使用的语法，包括非负十进制整数的时期“分离。”，例如“2”或“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包中的所有类具有相同的封装对象。静态方法允许通过名称或已知的当前类装载器的所有包的集合被发现的包被发现。

另请参见：

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)` 如果存在此注释，则返回此元素的指定类型的注释，否则为空。
`Annotation[]`	`getAnnotations()` 返回此元素上的注释。
`<A extends Annotation> A[]`	`getAnnotationsByType(类<A> annotationClass)` 返回与此元素关联的注释。
`<A extends Annotation> A`	`getDeclaredAnnotation(类<A> annotationClass)` 返回此元素的指定类型的注释，如果这样的注释是直接存在的，否则为空。
`Annotation[]`	`getDeclaredAnnotations()` 返回直接在该元素上的注释。
`<A extends Annotation> A[]`	`getDeclaredAnnotationsByType(类<A> annotationClass)` 如果这样的注释直接存在或间接存在，则返回指定类型的该元素的注释（s）。
`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)` 如果在这个元素上存在指定类型的注释，则返回真，否则为假。
`boolean`	`isCompatibleWith(String desired)` 将此软件包的规范版本与所需版本进行比较。
`boolean`	`isSealed()` 如果此包被密封，则返回真。
`boolean`	`isSealed(URL url)` 如果此包相对于指定的代码源的地址密封，则返回真。
`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()
```
    返回此包实现的规范的标题。
    
    结果
    
    该规范标题，如果不知道，则返回空值。
  - getSpecificationVersion
```
public String getSpecificationVersion()
```
    返回此包实现的规范的版本号。这个版本的字符串必须是一个由“。”分隔的非负整数的序列，并且可能有前导零。当版本字符串进行比较时，最重要的数字进行比较。
    
    结果
    
    规格版本，如果不知道是否返回，则返回。
  - getSpecificationVendor
```
public String getSpecificationVendor()
```
    返回拥有并维护实现此包的类的规范的组织、供应商或公司的名称。
    
    结果
    
    规格供应商，如果不知道，则返回空值。
  - getImplementationTitle
```
public String getImplementationTitle()
```
    返回此包的标题。
    
    结果
    
    执行的标题，如果不知道，则返回空值。
  - getImplementationVersion
```
public String getImplementationVersion()
```
    返回此实现的版本。它包括通过实施供应商指派的任何字符串，没有任何特定的语法指定的或预期的java运行时。它可能会比较平等与其他包版本字符串用于此实现由这个供应商的这个包。
    
    结果
    
    版本的实现，如果不知道，则返回空值。
  - getImplementationVendor
```
public String getImplementationVendor()
```
    返回提供此实现的组织、供应商或公司的名称。
    
    结果
    
    实现此包的供应商。
  - isSealed
```
public boolean isSealed()
```
    如果此包被密封，则返回真。
    
    结果
    
    如果包是密封的，否则为假
  - isSealed
```
public boolean isSealed(URL url)
```
    如果此包相对于指定的代码源的地址密封，则返回真。
    
    参数
    
    url -源代码的URL
    
    结果
    
    如果这个软件包是密封的，则是正确的
  - isCompatibleWith
```
public boolean isCompatibleWith(String desired)
                         throws NumberFormatException
```
    将此软件包的规范版本与所需版本进行比较。如果此包规格版本号大于或等于所需的版本号，则返回真。
    版本号进行比较，通过顺序比较所需的和规范的字符串的相应组件。每个组件被转换为一个十进制整数和值比较。如果规格值大于所需的值，则返回。如果值小于假返回。如果值是相等的期间被跳过，和下一对组件进行比较。
    
    参数
    
    desired -所需的版本字符串。
    
    结果
    
    如果此包的版本号大于或等于所需的版本号，则为
    
    异常
    
    NumberFormatException -如果期望或当前版本不正确的虚线形式。
  - getPackage
```
public static 软件包 getPackage(String name)
```
    找到一个包的名字在电话 ClassLoader实例。来电者 ClassLoader实例对应的类的实例中找到包。如果用户 ClassLoader实例为空则由系统 ClassLoader实例加载包集查找指定的包。
    只有当类装入器用适当的属性创建了包实例时，包才有版本和规范的属性。通常情况下，这些属性被定义在伴随类的清单中。
    
    参数
    
    name -包的名称，例如，一个。
    
    结果
    
    请求名称的包。它可能是null如果没有包的信息可以从文件或代码库。
  - getPackages
```
public static 软件包[] getPackages()
```
    把所有的包，目前已知的呼叫者的 ClassLoader实例。这些包对应的加载通过或按名访问， ClassLoader实例类。如果来电者的 ClassLoader实例引导 ClassLoader实例，这可以通过在一些实现 null表示，只有包对应的引导 ClassLoader实例加载的类将返回。
    
    结果
    
    一个新的包被调用者 ClassLoader实例数组。一个零长度数组返回，如果没有人知道。
  - hashCode
```
public int hashCode()
```
    返回从包名计算的哈希代码。
    
    重写：
    
    hashCode 方法重写，继承类 Object
    
    结果
    
    从包名计算的哈希代码。
    
    另请参见：
    
    Object.equals(java.lang.Object)， System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    返回此包的字符串表示形式。它的值是字符串“包”和包名称。如果定义了包标题，则追加。如果定义了包版本，则追加。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    包的字符串表示形式。
  - getAnnotation
```
public <A extends Annotation> A getAnnotation(类<A> annotationClass)
```
    从接口复制的描述： AnnotatedElement
    
    如果存在此注释，则返回此元素的指定类型的注释，否则为空。
    
    Specified by:
    
    getAnnotation 接口 AnnotatedElement
    
    参数类型
    
    A -查询并返回如果目前的标注类型
    
    参数
    
    annotationClass -对应的注释类型的类对象
    
    结果
    
    如果此元素上存在指定的注释类型，此元素的注释将在其他元素上为空
    
    异常
    
    NullPointerException如果注释类是无效的
    
    从以下版本开始：
    
    一点五
  - isAnnotationPresent
```
public boolean isAnnotationPresent(类<? extends Annotation> annotationClass)
```
    如果在这个元素上存在指定类型的注释，则返回真，否则为假。此方法的设计主要是方便的标记注释。
    此方法返回的真实价值相当于：getAnnotation(annotationClass) != null
    
    默认方法的主体被指定为上面的代码。
    
    Specified by:
    
    isAnnotationPresent 接口 AnnotatedElement
    
    参数
    
    annotationClass -对应的注释类型的类对象
    
    结果
    
    如果在这个元素上存在指定的注释类型的注释，则为假
    
    异常
    
    NullPointerException如果注释类是无效的
    
    从以下版本开始：
    
    一点五
  - getAnnotationsByType
```
public <A extends Annotation> A[] getAnnotationsByType(类<A> annotationClass)
```
    从接口复制的描述： AnnotatedElement
    
    返回与此元素关联的注释。如果没有与此元素关联的批注，返回值是一个长度为0的数组。这种方法和 AnnotatedElement.getAnnotation(Class)之间的区别是，该方法检测如果它的参数是一个可重复的注释类型（年9.6），如果是这样的话，试图找到一个或更多的注释，通过“浏览”式容器标注。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。
    
    Specified by:
    
    getAnnotationsByType 接口 AnnotatedElement
    
    参数类型
    
    A -查询并返回如果目前的标注类型
    
    参数
    
    annotationClass -对应的注释类型的类对象
    
    结果
    
    所有此元素的注释都与此元素关联，如果关联的是指定的注释类型，其他的数组长度为零
    
    异常
    
    NullPointerException如果注释类是无效的
    
    从以下版本开始：
    
    一点八
  - getAnnotations
```
public Annotation[] getAnnotations()
```
    从接口复制的描述： AnnotatedElement
    
    返回此元素上的注释。如果这个元素上没有注释，则返回值是一个长度为0的数组。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。
    
    Specified by:
    
    getAnnotations 接口 AnnotatedElement
    
    结果
    
    在这个元素上的注释
    
    从以下版本开始：
    
    一点五
  - getDeclaredAnnotation
```
public <A extends Annotation> A getDeclaredAnnotation(类<A> annotationClass)
```
    从接口复制的描述： AnnotatedElement
    
    返回此元素的指定类型的注释，如果这样的注释是直接存在的，否则为空。此方法忽略了继承的注释。（如果没有直接在这个元素上的注释，返回空值。）
    
    Specified by:
    
    getDeclaredAnnotation 接口 AnnotatedElement
    
    参数类型
    
    A -查询，如果直接提出返回的标注类型
    
    参数
    
    annotationClass -对应的注释类型的类对象
    
    结果
    
    此元素的注释类型，如果直接存在于此元素，将为指定的注释类型，否则为
    
    异常
    
    NullPointerException如果注释类是无效的
    
    从以下版本开始：
    
    一点八
  - getDeclaredAnnotationsByType
```
public <A extends Annotation> A[] getDeclaredAnnotationsByType(类<A> annotationClass)
```
    从接口复制的描述： AnnotatedElement
    
    如果这样的注释直接存在或间接存在，则返回指定类型的该元素的注释（s）。此方法忽略了继承的注释。如果在这个元素上没有直接或间接存在指定的注释，则返回值是一个长度为0的数组。这种方法和 AnnotatedElement.getDeclaredAnnotation(Class)之间的区别是，该方法检测如果它的参数是一个可重复的注释类型（年9.6），如果是这样的话，试图找到一个或更多的注释，通过“浏览”式容器注释如果存在。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。
    
    Specified by:
    
    getDeclaredAnnotationsByType 接口 AnnotatedElement
    
    参数类型
    
    A -注释类型来查询并返回如果直接或间接存在
    
    参数
    
    annotationClass -对应的注释类型的类对象
    
    结果
    
    如果在这个元素上直接或间接地存在于该元素上的指定注释类型的所有此元素的注释，否则将是一个长度为零的数组
    
    异常
    
    NullPointerException如果注释类是无效的
    
    从以下版本开始：
    
    一点八
  - getDeclaredAnnotations
```
public Annotation[] getDeclaredAnnotations()
```
    从接口复制的描述： AnnotatedElement
    
    返回直接在该元素上的注释。此方法忽略了继承的注释。如果在这个元素上没有直接存在的注释，返回值是一个长度为0的数组。此方法的调用方可以自由修改返回的数组；它将对返回给其他调用方的数组没有影响。
    
    Specified by:
    
    getDeclaredAnnotations 接口 AnnotatedElement
    
    结果
    
    直接在这个元素上的注释
    
    从以下版本开始：
    
    一点五

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