java.lang.Package

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

public class Package extends Object implements AnnotatedElement

クラス・ローダーに関連付けられたランタイ� ・パッケージに関するメタデータを表します。メタデータには、注釈、バージョニングおよびシールが含まれます。

ランタイ� ・パッケージの注釈は、ランタイ� ・パッケージのクラスと同じコード・ソースでpackage-info.classから読み取られます。

ランタイ� ・パッケージを構成するクラスのセットは、特定の仕様を実装できます。仕様のタイトル、バージョンおよびベンダー(仕様の所有者/保守者を示す)は、Packageが定義されている� �合に指定できます。アプリケーションは、Package.isCompatibleWith(String)メソッドを使用して、Packageが特定の仕様バージョンと互換性があるかどうかを尋ねることができます。また、Packageの定義時に、ランタイ� ・パッケージを構成する実際のクラスに関する情� �を提供できます。この情� �は、実装のタイトル、バージョンおよびベンダー(クラスの供給者を示す)で構成されます。

Packageは、ClassLoader.definePackage(String, String, String, String, String, String, String, URL)メソッドを使用して明示的に定義できます。発信者は、仕様と実装のタイトル、バージョン、およびベンダーを提供します。呼び出し元は、パッケージがsealedかどうかを示します。ランタイ� ・パッケージ内のクラスが定義されているときに、ランタイ� ・パッケージに対してPackageが明示的に定義されていない� �合は、次のように、クラスの定義クラス・ローダーによってPackageが自動的に定義されます。

名前付きモジュールのクラスに対して自動的に定義されたPackageには、次のプロパティがあります:

パッケージの名前は、クラスの「バイナリ名」から導出されます。名前付きモジュール内のクラスは名前付きパッケージ内にある必要があるため、派生名は空にはなりません。
パッケージは、コード・ソースとして「モジュールのロケーション」でシールされます(わかっている� �合)。
仕様および実装のタイトル、バージョンおよびベンダーは指定されていません。
パッケージ上の注釈は、前述のようにpackage-info.classから読み取られます。

名前のないモジュールのクラスに対して自動的に定義されたPackageには、次のプロパティがあります:

パッケージの名前は、"" (名前のないパッケージのクラスの� �合)または(名前付きパッケージのクラス用)クラスの「バイナリ名」から派生したものです。
パッケージはシールされていません。
仕様および実装のタイトル、バージョンおよびベンダーは指定されていません。
パッケージ上の注釈は、前述のようにpackage-info.classから読み取られます。

Packageは、Package.getPackage(String)およびClassLoader.getDefinedPackage(String)メソッドを使用して取得できます。クラス・ローダーによって定義されるすべてのPackageは、Package.getPackages()およびClassLoader.getDefinedPackages()メソッドを使用して取得できます。

実装上のノート:

「組み込みクラス・ローダー」は、「名前付きモジュール」内のパッケージのPackageオブジェクトを明示的に定義しません。代わりに、それらのパッケージは自動的に定義され、仕様と実装のバージョニング情� �はありません。

Java Virtual Machine仕様を参照してく� さい:

5.3 作成およびロード

導入されたバージョン:

1.2

関連� �目:

メソッドのサマリー

修飾子と型

メソッド

説明

<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()

このパッケージを実装したベンダーを返します。不明な� �合は、nullが返されます。

String

getImplementationVersion()

この実装のバージョンを返します。

String

getName()

このパッケージの名前を返します。

static Package

getPackage(String name)

非推奨。
複数のクラス・ローダーが互いに委譲して同じパッケージ名を持つクラスを定義し、そのようなローダーの1つがgetPackageのルックアップ動作に依存して親ローダーからPackageを返す� �合、Packageによって公開されるプロパティは期待どおりにならない� �合があります残りのプログラ� 。

static Package[]

getPackages()

呼出し元のクラス・ローダーとその祖先によって定義されたすべてのPackageを返します。

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言語仕様」のセクション6.5.3で定義されているこのパッケージの完全修飾名(例: java.lang)
- getSpecificationTitle
  
  public String getSpecificationTitle()
  
  このパッケージが実装する仕様のタイトルを返します。
  
  戻り値:
  
  仕様タイトルが不明な� �合は、nullが返されます。
- getSpecificationVersion
  
  public String getSpecificationVersion()
  
  このパッケージが実装する仕様のバージョン番号を返します。このバージョン文字列は、� でない10進整数を"."で区切って並べる必要があり、先� �にゼロを付けることができます。バージョン文字列が比較されると、最上位番号が比較されます。
  仕様バージョン番号では、ピリオド"."で区切られた� でない10進整数("2.0"や"1.2.3.4.5.6.7"など)で構成される構文を使用します。この形式によって、メジャー、マイナー、マイクロなどのバージョンを表現するように、番号を拡張することができます。仕様のバージョン番号は、次の正規文法によって記述されます。
  
  SpecificationVersion:
  Digits RefinedVersion_opt
  RefinedVersion:
  . Digits
  . 数字RefinedVersion
  Digits:
  数字
  Digits
  Digit:
  Character.isDigit(char)がtrueを返す任意の文字(0、1、2など)
  
  戻り値:
  
  仕様バージョンが不明な� �合は、nullが返されます。
- getSpecificationVendor
  
  public String getSpecificationVendor()
  
  このパッケージを実装するクラスの仕様を所有して保持する組織、ベンダー、または会社の名前を返します。
  
  戻り値:
  
  仕様ベンダーが不明な� �合は、nullが返されます。
- getImplementationTitle
  
  public String getImplementationTitle()
  
  このパッケージのタイトルを返します。
  
  戻り値:
  
  実装のタイトルがわからない� �合は、nullが返されます。
- getImplementationVersion
  
  public String getImplementationVersion()
  
  この実装のバージョンを返します。この実装のベンダーによって割り当てられた文字列からなり、Java実行時には特定の構文は指定または予期されません。これは、このパッケージのベンダーによる実装で使用されるその他のパッケージ・バージョン文字列と等価かどうが比較されることがあります。
  
  戻り値:
  
  実装のバージョンが不明な� �合は、nullが返されます。
- getImplementationVendor
  
  public String getImplementationVendor()
  
  このパッケージを実装したベンダーを返します。不明な� �合は、nullが返されます。
  
  戻り値:
  
  このパッケージを実装したベンダーがわからない� �合は、nullが返されます。
- isSealed
  
  public boolean isSealed()
  
  このパッケージがシールされる� �合は、trueを返します。
  
  APIのノート:
  
  「パッケージのシール」は、「シール済クラスまたはインタフェース」とは関係がありません。パッケージ・シールは、名前のないモジュールのクラスに定義されたJARファイルに固有です。 Packageをシール済パッケージとして定義する方法の詳細は、Packageクラス仕様を参照してく� さい。
  
  戻り値:
  
  パッケージがシールされる� �合はtrue、そうでない� �合はfalse。
- isSealed
  
  public boolean isSealed(URL url)
  
  指定されたコード・ソースurlに対してこのパッケージが封印されている� �合はtrueを返します。
  
  APIのノート:
  
  「パッケージのシール」は、「シール済クラスまたはインタフェース」とは関係がありません。パッケージ・シールは、名前のないモジュールのクラスに定義されたJARファイルに固有です。 Packageをシール済パッケージとして定義する方法の詳細は、Packageクラス仕様を参照してく� さい。
  
  パラメータ:
  
  url - コード・ソースURL
  
  戻り値:
  
  指定されたurlに関してこのパッケージが封印されている� �合はtrue
- isCompatibleWith
  
  public boolean isCompatibleWith(String desired) throws NumberFormatException
  
  このパッケージの仕様のバージョンを目的のバージョンと比較します。このパッケージの仕様のバージョン番号が目的のバージョン番号以上の� �合は、trueが返されます。
  バージョン番号は、目的の文字列と仕様の文字列の対応するコンポーネントを� �番に比較することによって比較されます。各コンポーネントは10進整数として変換され、値として比較されます。仕様の値が目的の値より大きい� �合、trueが返されます。値が目的の値より小さい� �合、falseが返されます。値が等しい� �合、ピリオドはスキップされ、次のコンポーネントのペアが比較されます。
  
  パラメータ:
  
  desired - 目的のバージョンのバージョン文字列。
  
  戻り値:
  
  このパッケージのバージョン番号が目的のバージョン番号以上の� �合はtrue
  
  スロー:
  
  NumberFormatException - 現在のバージョンが不明であるか、目的のバージョンまたは現在のバージョンが正しい点付き形式でない� �合。
- getPackage
  @Deprecated(since="9") public static Package getPackage(String name)
  
  非推奨。
  複数のクラス・ローダーが互いに委譲して同じパッケージ名を持つクラスを定義し、そのようなローダーの1つがgetPackageのルックアップ動作に依存して親ローダーからPackageを返す� �合、Packageによって公開されるプロパティは期待どおりにならない� �合があります残りのプログラ� 。たとえば、Packageは、子ローダーによって定義されたpackage-info.classファイルに注釈が存在する� �合でも、親ローダーによって定義されたpackage-info.classファイルからのみ注釈を公開します。より� �牢なアプローチは、指定されたクラス・ローダーのPackageを返すClassLoader.getDefinedPackage(java.lang.String)メソッドを使用することです。
  
  呼び出し元のクラス・ローダーとその祖先で、名前でパッケージを検索します。
  呼出し元のクラス・ローダーが、指定された名前のPackageを定義すると、Packageが返されます。それ以外の� �合は、コール元のクラス・ローダーの祖先が、指定された名前のPackageを再帰的に(親による親)で検索されます。
  このメソッドの呼出しは、呼出し元のクラス・ローダーであるClassLoaderインスタンスでClassLoader.getPackage(java.lang.String)をコールすることと同じです。
  
  パラメータ:
  
  name - パッケージ名("java.lang"など)。
  
  戻り値:
  
  呼出し元のクラス・ローダーまたはその祖先によって定義された指定された名前のPackage、または見つからない� �合はnull。
  
  スロー:
  
  NullPointerException - nameがnullの� �合。
  
  関連� �目:
  
  ClassLoader.getDefinedPackage(java.lang.String)
- getPackages
  public static Package[] getPackages()
  
  呼出し元のクラス・ローダーとその祖先によって定義されたすべてのPackageを返します。返される配列には、同じパッケージ名の複数のPackageオブジェクトを含めることができます。各オブジェクトは、クラス・ローダー階層内の異なるクラス・ローダーによって定義されます。
  このメソッドの呼出しは、呼出し元のクラス・ローダーであるClassLoaderインスタンスでClassLoader.getPackages()をコールすることと同じです。
  
  戻り値:
  
  このクラス・ローダーとその祖先によって定義されたPackageオブジェクトの配列
  
  関連� �目:
  
  ClassLoader.getDefinedPackages()
- 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)
  
  存在する� �合は、この要� の指定された型の注釈を返し、そうでない� �合は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)
  
  この要� に関連付けられている注釈を返します。この要� に関連付けられている注釈がない� �合、戻り値は長さ0の配列です。このメソッドとAnnotatedElement.getAnnotation(Class)の違いは、引数が「繰返し可能な注釈タイプ」 (JLS 9.6)であるかどうかをこのメソッドが検出し、その� �合、"検索"がコンテナ注釈を使用してそのタイプの注釈を検索しようとすることです。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。
  このメソッドによって返される注釈は宣言注釈であることに注意してく� さい。
  
  定義:
  
  getAnnotationsByType、インタフェースAnnotatedElement
  
  型パラメータ:
  
  A - 問合せ対象および存在する� �合は戻す注釈のタイプ
  
  パラメータ:
  
  annotationClass - 注釈型に対応するClassオブジェクト
  
  戻り値:
  
  この要� に関連付けられている� �合は、この要� の指定された注釈型のすべての注釈。そうでない� �合は長さ0の配列
  
  スロー:
  
  NullPointerException - 指定された注釈クラスがnullの� �合
  
  導入されたバージョン:
  
  1.8
- getAnnotations
  
  public Annotation[] getAnnotations()
  
  この要� に存在する注釈を返します。この要� に存在する注釈がない� �合、戻り値は長さ0の配列です。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。
  このメソッドによって返される注釈は宣言注釈であることに注意してく� さい。
  
  定義:
  
  getAnnotations、インタフェースAnnotatedElement
  
  戻り値:
  
  この要� に存在する注釈
  
  導入されたバージョン:
  
  1.5
- getDeclaredAnnotation
  
  public <A extends Annotation> A getDeclaredAnnotation(Class<A> annotationClass)
  
  直接存在する� �合は、この要� の指定された型の注釈を返し、そうでない� �合は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)であるかどうかをこのメソッドが検出し、ある� �合は"検索"がコンテナ注釈(存在する� �合)を検出しようとする点です。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。
  
  定義:
  
  getDeclaredAnnotationsByType、インタフェースAnnotatedElement
  
  型パラメータ:
  
  A - 直接的または間接的に存在する� �合に問い合せて返す注釈のタイプ
  
  パラメータ:
  
  annotationClass - 注釈型に対応するClassオブジェクト
  
  戻り値:
  
  この要� に直接または間接的に存在する� �合は、この要� の指定された注釈型のすべての注釈。そうでない� �合は長さ0の配列
  
  スロー:
  
  NullPointerException - 指定された注釈クラスがnullの� �合
  
  導入されたバージョン:
  
  1.8
- getDeclaredAnnotations
  
  public Annotation[] getDeclaredAnnotations()
  
  この要� に直接存在する注釈を返します。このメソッドは継承された注釈を無視します。この要� に直接存在する注釈がない� �合、戻り値は長さ0の配列です。このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。
  このメソッドによって返される注釈は宣言注釈であることに注意してく� さい。
  
  定義:
  
  getDeclaredAnnotations、インタフェースAnnotatedElement
  
  戻り値:
  
  この要� に直接存在する注釈
  
  導入されたバージョン:
  
  1.5

クラス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