Package (Java Platform SE 8)

java.lang.Object
- java.lang.Package

すべての実装されたインタフェース:

AnnotatedElement
```
public class Package
extends Object
implements AnnotatedElement
```
Packageオブジェクトには、Javaパッケージの実装と仕様に関するバージョン情報が含まれます。このバージョン管理情報は、クラスをロードしたClassLoaderインスタンスにより取得され、使用可能になります。通常、クラスにより分散されるマニフェスト内に格納されます。
パッケージを構成するクラスのセットは特定の仕様を実装する場合があり、その場合は仕様タイトル、バージョン番号、およびベンダー文字列がその仕様を特定します。アプリケーションは、パッケージが特定のバージョンと互換性があるかどうかを確認できます。詳細は、isCompatibleWithメソッドを参照してください。
仕様のバージョン番号は、負でない10進数の整数からなり、「2.0」や「1.2.3.4.5.6.7」のようにピリオドで区切られています。この形式によって、メジャー、マイナー、マイクロなどのバージョンを表現するように、番号を拡張することができます。仕様のバージョン番号は、次の正規文法によって記述されます。

SpecificationVersion:
Digits RefinedVersion_opt
RefinedVersion:
. Digits
. Digits RefinedVersion
Digits:
Digit
Digits
Digit:
Character.isDigit(char)がtrueを返す任意の文字(0、1、2など)

実装のタイトル、バージョン、およびベンダー文字列は実装を特定し、問題が発生したときに影響を受けるパッケージを正確に報告できるようにします。3つの実装文字列の内容はすべて、ベンダー固有です。実装バージョン文字列には指定された構文はなく、目的のバージョン識別子と等価かどうかの比較だけが行われます。
各ClassLoaderインスタンス内では、同じJavaパッケージからのすべてのクラスが同じPackageオブジェクトを持ちます。staticメソッドにより、名前、または検索対象の現在のクラス・ローダーに知られているすべてのパッケージのセットで、パッケージを検索できます。

関連項目:

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)

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`<A extends Annotation> A`	`getAnnotation(Class<A> annotationClass)` 存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。
`Annotation[]`	`getAnnotations()` この要素に存在する注釈を返します。
`<A extends Annotation> A[]`	`getAnnotationsByType(Class<A> annotationClass)` この要素に関連付けられている注釈を返します。
`<A extends Annotation> A`	`getDeclaredAnnotation(Class<A> annotationClass)` 直接存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。
`Annotation[]`	`getDeclaredAnnotations()` この要素に直接存在する注釈を返します。
`<A extends Annotation> A[]`	`getDeclaredAnnotationsByType(Class<A> annotationClass)` 直接存在するか間接的に存在する場合は、この要素の指定された型の注釈を返します。
`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()` このパッケージがシールされる場合は、trueを返します。
`boolean`	`isSealed(URL url)` このパッケージが指定されたコード・ソースURLに対してシールされる場合は、trueを返します。
`String`	`toString()` このPackageの文字列表現を返します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, notify, notifyAll, wait, wait, wait

- メソッドの詳細
  - getName
```
public String getName()
```
    このパッケージの名前を返します。
    
    戻り値:
    
    『Java(tm)言語仕様』のセクション6.5.3に定義されている、このパッケージの完全指定名。たとえば、java.lang
  - getSpecificationTitle
```
public String getSpecificationTitle()
```
    このパッケージが実装する仕様のタイトルを返します。
    
    戻り値:
    
    仕様タイトル、不明な場合はnull。
  - getSpecificationVersion
```
public String getSpecificationVersion()
```
    このパッケージが実装する仕様のバージョン番号を返します。このバージョン番号は、「.」で区切られた一連の負でない10進数の整数でなければならず、先頭にゼロが付くことがあります。バージョン文字列が比較されると、最上位番号が比較されます。
    
    戻り値:
    
    仕様のバージョン番号、不明な場合は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を返します。
    
    戻り値:
    
    パッケージがシールされる場合はtrue、そうでない場合はfalse。
  - isSealed
```
public boolean isSealed(URL url)
```
    このパッケージが指定されたコード・ソースURLに対してシールされる場合は、trueを返します。
    
    パラメータ:
    
    url - コード・ソースURL
    
    戻り値:
    
    このパッケージがURLに対してシールされる場合はtrue
  - isCompatibleWith
```
public boolean isCompatibleWith(String desired)
                         throws NumberFormatException
```
    このパッケージの仕様のバージョンを目的のバージョンと比較します。このパッケージの仕様のバージョン番号が目的のバージョン番号以上の場合は、trueが返されます。
    バージョン番号は、目的の文字列と仕様の文字列の対応するコンポーネントを順番に比較することによって比較されます。各コンポーネントは10進整数として変換され、値として比較されます。仕様の値が目的の値より大きい場合、trueが返されます。値が目的の値より小さい場合、falseが返されます。値が等しい場合、ピリオドはスキップされ、次のコンポーネントのペアが比較されます。
    
    パラメータ:
    
    desired - 目的のバージョンのバージョン文字列。
    
    戻り値:
    
    このパッケージのバージョン番号が目的のバージョン番号以上の場合はtrue
    
    例外:
    
    NumberFormatException - 目的のバージョンまたは現在のバージョンがドットで区切られた正しい形式でない場合。
  - getPackage
```
public static Package getPackage(String name)
```
    呼出し側のClassLoaderインスタンス内の名前でパッケージを検索します。呼出し側のClassLoaderインスタンスは、指定されたクラスに対応するパッケージ・インスタンスを検索するために使用されます。呼出し側のClassLoaderインスタンスがnullの場合、システムのClassLoaderインスタンスによりロードされたパッケージのセットが検索されて、指定されたパッケージが検索されます。
    パッケージは、クラス・ローダーが適切な属性を持つパッケージ・インスタンスを生成した場合にだけ、バージョンと仕様の属性を持ちます。通常、それらの属性は、クラスに付属するマニフェストに定義されます。
    
    パラメータ:
    
    name - パッケージ名、たとえば、java.lang。
    
    戻り値:
    
    要求された名前のパッケージ。アーカイブまたはコード・ベースからパッケージの情報が利用できない場合は、nullになることがある。
  - getPackages
```
public static Package[] getPackages()
```
    呼出し側の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の文字列表現を返します。この値は、文字列「package」とパッケージ名です。パッケージのタイトルが定義されている場合、それが付加されます。パッケージのバージョンが定義されている場合、それが付加されます。
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    
    パッケージの文字列表現。
  - getAnnotation
```
public <A extends Annotation> A getAnnotation(Class<A> annotationClass)
```
    インタフェースからコピーされた説明: AnnotatedElement
    
    存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。
    
    定義:
    
    getAnnotation、インタフェース: AnnotatedElement
    
    型パラメータ:
    
    A - 問合せの対象であり、存在する場合に返される注釈の型
    
    パラメータ:
    
    annotationClass - 注釈型に対応するClassオブジェクト
    
    戻り値:
    
    存在する場合は、この要素の指定された注釈型の注釈。そうでない場合はnull
    
    例外:
    
    NullPointerException - 指定された注釈クラスがnullの場合
    
    導入されたバージョン:
    
    1.5
  - isAnnotationPresent
```
public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)
```
    指定された型の注釈がこの要素に存在する場合はtrueを返し、そうでない場合はfalseを返します。このメソッドは、主にマーカー注釈への簡易アクセスを目的に設計されています。
    このメソッドによって返されるtrue値は、getAnnotation(annotationClass) != nullと同等です。
    デフォルト・メソッドの本体は、前述のコードとして指定されています。
    
    定義:
    
    isAnnotationPresent、インタフェース: AnnotatedElement
    
    パラメータ:
    
    annotationClass - 注釈型に対応するClassオブジェクト
    
    戻り値:
    
    指定された注釈型の注釈がこの要素に存在する場合はtrue、そうでない場合はfalse
    
    例外:
    
    NullPointerException - 指定された注釈クラスがnullの場合
    
    導入されたバージョン:
    
    1.5
  - getAnnotationsByType
```
public <A extends Annotation> A[] getAnnotationsByType(Class<A> annotationClass)
```
    インタフェースからコピーされた説明: AnnotatedElement
    
    この要素に関連付けられている注釈を返します。この要素に関連付けられている注釈がない場合、戻り値は長さ0の配列です。このメソッドとAnnotatedElement.getAnnotation(Class)の違いは、このメソッドではその引数が繰返し可能な注釈型 (JLS 9.6)であるかどうかが検出され、繰返し可能な注釈型である場合は、コンテナ注釈を調べることで、その型の1つ以上の注釈の検索が試みられることです。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。
    
    定義:
    
    getAnnotationsByType、インタフェース: AnnotatedElement
    
    型パラメータ:
    
    A - 問合せの対象であり、存在する場合に返される注釈の型
    
    パラメータ:
    
    annotationClass - 注釈型に対応するClassオブジェクト
    
    戻り値:
    
    この要素に関連付けられている場合は、この要素の指定された注釈型のすべての注釈。そうでない場合は長さ0の配列
    
    例外:
    
    NullPointerException - 指定された注釈クラスがnullの場合
    
    導入されたバージョン:
    
    1.8
  - getAnnotations
```
public Annotation[] getAnnotations()
```
    インタフェースからコピーされた説明: AnnotatedElement
    
    この要素に存在する注釈を返します。この要素に存在する注釈がない場合、戻り値は長さ0の配列です。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。
    
    定義:
    
    getAnnotations、インタフェース: AnnotatedElement
    
    戻り値:
    
    この要素に存在する注釈
    
    導入されたバージョン:
    
    1.5
  - getDeclaredAnnotation
```
public <A extends Annotation> A getDeclaredAnnotation(Class<A> annotationClass)
```
    インタフェースからコピーされた説明: AnnotatedElement
    
    直接存在する場合は、この要素の指定された型の注釈を返し、そうでない場合はnullを返します。このメソッドは継承された注釈を無視します。(この要素に直接存在する注釈がない場合は、nullを返します。)
    
    定義:
    
    getDeclaredAnnotation、インタフェース: AnnotatedElement
    
    型パラメータ:
    
    A - 問合せの対象であり、直接存在する場合に返される注釈の型
    
    パラメータ:
    
    annotationClass - 注釈型に対応するClassオブジェクト
    
    戻り値:
    
    直接存在する場合は、この要素の指定された注釈型の注釈。そうでない場合はnull
    
    例外:
    
    NullPointerException - 指定された注釈クラスがnullの場合
    
    導入されたバージョン:
    
    1.8
  - getDeclaredAnnotationsByType
```
public <A extends Annotation> A[] getDeclaredAnnotationsByType(Class<A> annotationClass)
```
    インタフェースからコピーされた説明: AnnotatedElement
    
    直接存在するか間接的に存在する場合は、この要素の指定された型の注釈を返します。このメソッドは継承された注釈を無視します。この要素に直接または間接的に存在する指定された注釈がない場合、戻り値は長さ0の配列です。このメソッドとAnnotatedElement.getDeclaredAnnotation(Class)の違いは、このメソッドではその引数が繰返し可能な注釈型 (JLS 9.6)であるかどうかが検出され、繰返し可能な注釈型である場合は、コンテナ注釈(存在する場合)を調べることで、その型の1つ以上の注釈の検索が試みられることです。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。
    
    定義:
    
    getDeclaredAnnotationsByType、インタフェース: AnnotatedElement
    
    型パラメータ:
    
    A - 問合せの対象であり、直接または間接的に存在する場合に返される注釈の型
    
    パラメータ:
    
    annotationClass - 注釈型に対応するClassオブジェクト
    
    戻り値:
    
    この要素に直接または間接的に存在する場合は、この要素の指定された注釈型のすべての注釈。そうでない場合は長さ0の配列
    
    例外:
    
    NullPointerException - 指定された注釈クラスがnullの場合
    
    導入されたバージョン:
    
    1.8
  - getDeclaredAnnotations
```
public Annotation[] getDeclaredAnnotations()
```
    インタフェースからコピーされた説明: AnnotatedElement
    
    この要素に直接存在する注釈を返します。このメソッドは継承された注釈を無視します。この要素に直接存在する注釈がない場合、戻り値は長さ0の配列です。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。
    
    定義:
    
    getDeclaredAnnotations、インタフェース: AnnotatedElement
    
    戻り値:
    
    この要素に直接存在する注釈
    
    導入されたバージョン:
    
    1.5

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスPackage

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

メソッドの詳細

getName

getSpecificationTitle

getSpecificationVersion

getSpecificationVendor

getImplementationTitle

getImplementationVersion

getImplementationVendor

isSealed

isSealed

isCompatibleWith

getPackage

getPackages

hashCode

toString

getAnnotation

isAnnotationPresent

getAnnotationsByType

getAnnotations

getDeclaredAnnotation

getDeclaredAnnotationsByType

getDeclaredAnnotations