クラスModule

java.lang.Object

java.lang.Module

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

AnnotatedElement

public final class Module extends Object implements AnnotatedElement

ランタイ� ・モジュール(namedまたは名前なし)を表します。

名前付きモジュールにはnameがあり、「モジュール層」を作成するためにモジュールのグラフがJava仮想マシンに定義されると、Java Virtual Machineによって構成されます。

名前のないモジュールには名前がありません。 ClassLoaderごとに名前のないモジュールがあり、getUnnamedModuleメソッドを呼び出して取得されます。 名前付きモジュールに存在しないすべての型は、その定義クラス・ローダーの名前なしモジュールのメンバーです。

パラメータであるパッケージ名、またはこのクラスで定義されたメソッドによって返されるパッケージ名は、「Java言語仕様」のセクション6.5.3で定義されているパッケージの完全修飾名です(例: "java.lang")。

特に指定しないかぎり、このクラスのメソッドにnull引数を渡すと、NullPointerExceptionがスローされます。

Java言語仕様を参照してく� さい:

7.7 モジュール宣言

導入されたバージョン:

9

関連� �目:

• Class.getModule()

メソッドのサマリー

修飾子と型	メソッド	説明
Module	addExports(String pn, Module other)	呼び出し元のモジュールがこのモジュールである� �合は、このモジュールを更新して、指定されたパッケージを指定されたモジュールにエクスポートします。
Module	addOpens(String pn, Module other)	このモジュールに、少なくとも呼出し元モジュールへのパッケージopenedがある� �合は、このモジュールを更新して、指定されたモジュールにパッケージを開きます。
Module	addReads(Module other)	呼び出し元のモジュールがこのモジュールである� �合は、このモジュールを更新して、指定されたモジュールを読み取ります。
Module	addUses(Class<?> service)	呼出し元のモジュールがこのモジュールである� �合、このモジュールを更新して、指定されたサービス・タイプにサービス依存を追� します。
boolean	canRead(Module other)	このモジュールが指定されたモジュールを読み取るかどうかを示します。
boolean	canUse(Class<?> service)	このモジュールに、指定されたサービス・タイプへのサービス依存があるかどうかを示します。
<T extends Annotation> T	getAnnotation(Class<T> annotationClass)	存在する� �合は、この要� の指定された型の注釈を返し、そうでない� �合はnullを返します。
Annotation[]	getAnnotations()	この要� に存在する注釈を返します。
ClassLoader	getClassLoader()	このモジュールのClassLoaderを返します。
Annotation[]	getDeclaredAnnotations()	この要� に直接存在する注釈を返します。
ModuleDescriptor	getDescriptor()	このモジュールのモジュール記述子を返すか、このモジュールが名前のないモジュールの� �合はnullを返します。
ModuleLayer	getLayer()	このモジュールを含むモジュール・レイヤーを返すか、このモジュールがモジュール・レイヤーにない� �合はnullを返します。
String	getName()	モジュール名を返すか、このモジュールが名前のないモジュールの� �合はnullを返します。
Set<String>	getPackages()	このモジュール内のパッケージのパッケージ名のセットを返します。
InputStream	getResourceAsStream(String name)	このモジュールのリソースを読み取るための入力ストリー� を返します。
boolean	isExported(String pn)	このモジュールが指定されたパッケージを無条件にエクスポートする� �合、trueを返します。
boolean	isExported(String pn, Module other)	このモジュールが指定されたパッケージを少なくとも指定されたモジュールにエクスポートする� �合、trueを返します。
boolean	isNamed()	このモジュールが名前付きモジュールである� �合は、trueを返します。
boolean	isNativeAccessEnabled()	このモジュールが「制限付き」メソッドにアクセスできる� �合は、trueを返します。
boolean	isOpen(String pn)	このモジュールに無条件にパッケージopenedがある� �合、trueを返します。
boolean	isOpen(String pn, Module other)	このモジュールに、少なくとも指定されたモジュールへのパッケージopenedがある� �合、trueを返します。
String	toString()	このモジュールの文字列表現を返します。

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

インタフェースjava.lang.reflect.AnnotatedElementで宣言されたメソッド

getAnnotationsByType, getDeclaredAnnotation, getDeclaredAnnotationsByType, isAnnotationPresent

メソッドの詳細

isNamed

public boolean isNamed()

このモジュールが名前付きモジュールである� �合は、trueを返します。

戻り値:

trueが名前付きモジュールの� �合

Java言語仕様を参照してく� さい:

7.7.5 名前なしモジュール

関連� �目:

• ClassLoader.getUnnamedModule()

getName

public String getName()

モジュール名を返すか、このモジュールが名前のないモジュールの� �合はnullを返します。

戻り値:

モジュール名

getClassLoader

public ClassLoader getClassLoader()

このモジュールのClassLoaderを返します。

戻り値:

このモジュールのクラス・ローダー

getDescriptor

public ModuleDescriptor getDescriptor()

このモジュールのモジュール記述子を返すか、このモジュールが名前のないモジュールの� �合はnullを返します。

戻り値:

このモジュールのモジュール記述子

getLayer

public ModuleLayer getLayer()

このモジュールを含むモジュール・レイヤーを返すか、このモジュールがモジュール・レイヤーにない� �合はnullを返します。 モジュール・レイヤーには名前付きモジュールが含まれているため、このメソッドは、名前なしモジュールで呼び出されると常にnullを返します。

「動的モジュール」は、実行時に生成される名前付きモジュールです。 動的モジュールは、モジュール・レイヤー内にある� �合とそうでない� �合があります。

戻り値:

このモジュールを含むモジュール・レイヤー

関連� �目:

• Proxy

isNativeAccessEnabled

public boolean isNativeAccessEnabled()

このモジュールが「制限付き」メソッドにアクセスできる� �合は、trueを返します。

戻り値:

このモジュールが「制限付き」メソッドにアクセスできる� �合はtrue。

導入されたバージョン:

22

canRead

public boolean canRead(Module other)

このモジュールが指定されたモジュールを読み取るかどうかを示します。 このメソッドは、このモジュールが自身を読み取るかどうかをテストするために呼び出された� �合、trueを返します。 また、名前のないモジュール(名前のないモジュールはすべてのモジュールを読み込む)で呼び出された� �合は、trueを返します。

パラメータ:

other - 他のモジュール

戻り値:

trueこのモジュールがotherを読み取る� �合

関連� �目:

• addReads(Module)

addReads

public Module addReads(Module other)

呼び出し元のモジュールがこのモジュールである� �合は、このモジュールを更新して、指定されたモジュールを読み取ります。 このメソッドは、otherがこのモジュール(すべてのモジュールが自分自身を読む)である� �合、このモジュールはノー・オペレーションであり、このモジュールは名前のないモジュール(名前のないモジュールはすべてのモジュールを読み込む)であるか、またはこのモジュールはすでにotherを読み込んでいます。

実装上のノート:

このメソッドによって追� された「エッジを読み取る」はweakであり、このモジュールに厳密にアクセス可能な� �合、otherがGCされるのを防ぐことはできません。

パラメータ:

other - 他のモジュール

戻り値:

このモジュール

スロー:

IllegalCallerException - これが名前付きモジュールで、呼び出し元のモジュールがこのモジュールでない� �合

関連� �目:

• canRead(java.lang.Module)

isExported

public boolean isExported(String pn, Module other)

このモジュールが指定されたパッケージを少なくとも指定されたモジュールにエクスポートする� �合、trueを返します。

このメソッドは、このモジュール内のパッケージが自身にエクスポートされるかどうかをテストするために呼び出された� �合、trueを返します。 名前のないモジュールで呼び出されると、常にtrueが返されます。 指定されたモジュールにopenのパッケージは、実行時にそのモジュールにエクスポートされるとみなされるため、このメソッドは、パッケージが指定されたモジュールにオープンされている� �合はtrueを返します。

このメソッドは、指定されたモジュールがこのモジュールを読み取るかどうかをチェックしません。

パラメータ:

pn - パッケージ名

other - 他のモジュール

戻り値:

trueこのモジュールがパッケージを少なくとも指定されたモジュールにエクスポートする� �合

関連� �目:

• ModuleDescriptor.exports()
• addExports(String,Module)

isOpen

public boolean isOpen(String pn, Module other)

このモジュールに、少なくとも指定されたモジュールへのパッケージopenedがある� �合、trueを返します。

このメソッドは、このモジュール内のパッケージが自身に対して開いているかどうかをテストするために呼び出された� �合、trueを返します。 モジュール内のパッケージを含むopenモジュールで呼び出されると、trueが返されます。 名前のないモジュールで呼び出されると、常にtrueが返されます。

このメソッドは、指定されたモジュールがこのモジュールを読み取るかどうかをチェックしません。

APIのノート:

パッケージpをモジュールMにオープンすると、Mのコードでパッケージのすべてのタイプに対して「深い反射」を実行できます。 さらに、Mがこのモジュールを読み取ると、パッケージpでdefine classesを許可されているLookupオブジェクトを取得できます。

パラメータ:

pn - パッケージ名

other - 他のモジュール

戻り値:

trueこのモジュールがパッケージを少なくとも指定されたモジュールにopenedしている� �合

関連� �目:

• ModuleDescriptor.opens()
• addOpens(String,Module)
• AccessibleObject.setAccessible(boolean)
• MethodHandles.privateLookupIn(java.lang.Class<?>, java.lang.invoke.MethodHandles.Lookup)

isExported

public boolean isExported(String pn)

このモジュールが指定されたパッケージを無条件にエクスポートする� �合、trueを返します。

このメソッドは、名前のないモジュールで呼び出されると、常にtrueを返します。 無条件にopenedのパッケージは、実行時に無条件にエクスポートされたとみなされるため、パッケージが無条件にオープンされた� �合、このメソッドはtrueを返します。

このメソッドは、指定されたモジュールがこのモジュールを読み取るかどうかをチェックしません。

パラメータ:

pn - パッケージ名

戻り値:

このモジュールが無条件にパッケージをエクスポートする� �合はtrue

関連� �目:

• ModuleDescriptor.exports()

isOpen

public boolean isOpen(String pn)

このモジュールに無条件にパッケージopenedがある� �合、trueを返します。

このメソッドは、名前のないモジュールで呼び出されると、常にtrueを返します。 さらに、モジュール内のパッケージを含むopenモジュールで呼び出されると、常にtrueが返されます。

このメソッドは、指定されたモジュールがこのモジュールを読み取るかどうかをチェックしません。

APIのノート:

パッケージpをモジュールMにオープンすると、Mのコードでパッケージのすべてのタイプに対して「深い反射」を実行できます。 さらに、Mがこのモジュールを読み取ると、パッケージpでdefine classesを許可されているLookupオブジェクトを取得できます。

パラメータ:

pn - パッケージ名

戻り値:

trueこのモジュールがパッケージを無条件でopenedしている� �合

関連� �目:

• ModuleDescriptor.opens()
• AccessibleObject.setAccessible(boolean)
• MethodHandles.privateLookupIn(java.lang.Class<?>, java.lang.invoke.MethodHandles.Lookup)

addExports

public Module addExports(String pn, Module other)

呼び出し元のモジュールがこのモジュールである� �合は、このモジュールを更新して、指定されたパッケージを指定されたモジュールにエクスポートします。

このメソッドは、パッケージが指定されたモジュールにすでに(またはopen)をエクスポートしている� �合には効果がありません。

APIのノート:

「Java Virtual Machine仕様」の5.4.3の� �で指定されているように、リンケージ・エラーのためにシンボリック参照を解決しようとする試みが失敗した� �合、それ以降の参照の解決は常に、最初の解決試行の結果としてスローされたものと同じエラーで失敗します。

パラメータ:

pn - パッケージ名

other - モジュール

戻り値:

このモジュール

スロー:

IllegalArgumentException - pnがnullの� �合、またはこれが名前付きモジュールであり、パッケージpnがこのモジュールのパッケージでない� �合

IllegalCallerException - これが名前付きモジュールで、呼び出し元のモジュールがこのモジュールでない� �合

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

5.4.3 解決方法

関連� �目:

• isExported(String,Module)

addOpens

public Module addOpens(String pn, Module other)

このモジュールに、少なくとも呼出し元モジュールへのパッケージopenedがある� �合は、このモジュールを更新して、指定されたモジュールにパッケージを開きます。 このメソッドを使用してパッケージを開くと、プライベート・アクセスをサポートするAPI、またはデフォルトのJava言語アクセス制御チェックをバイパスまたは抑制する方法を使用するときに、パッケージ内のすべてのタイプ、およびすべてのメンバー(パブリック・タイプとそのパブリック・メンバーのみではない)が、指定されたモジュールによって反� されます。

このメソッドは、パッケージが指定されたモジュールに対してすでにopenである� �合には効果がありません。

APIのノート:

このメソッドは、「消費者モジュール」が修飾されたopenを使用して「APIモジュール」へのパッケージを開くが、コンシューマ・モジュール内のクラスのメンバーへのリフレクティブ・アクセスが別のモジュールのコードに委任される� �合に使用できます。 APIモジュールのコードは、このメソッドを使用して、コンシューマ・モジュールのパッケージを他のモジュールにオープンできます。

パラメータ:

pn - パッケージ名

other - モジュール

戻り値:

このモジュール

スロー:

IllegalArgumentException - pnがnullの� �合、またはこれが名前付きモジュールであり、パッケージpnがこのモジュールのパッケージでない� �合

IllegalCallerException - これが名前付きモジュールで、このモジュールが少なくとも呼び出し元のモジュールにパッケージを開いていない� �合

関連� �目:

• isOpen(String,Module)
• AccessibleObject.setAccessible(boolean)
• MethodHandles.privateLookupIn(java.lang.Class<?>, java.lang.invoke.MethodHandles.Lookup)

addUses

public Module addUses(Class<?> service)

呼出し元のモジュールがこのモジュールである� �合、このモジュールを更新して、指定されたサービス・タイプにサービス依存を追� します。 このメソッドは、他のモジュールのかわりにServiceLoaderを呼び出すフレー� ワーク、またはフレー� ワークが他のコードによってサービス・タイプへの参照を渡されるフレー� ワークで使用することを目的としています。 このメソッドは、名前のないモジュールまたは自動モジュールで呼び出された� �合、no-opです。

このメソッドでは、resolveAndBindは再実行されません。

パラメータ:

service - サービス型

戻り値:

このモジュール

スロー:

IllegalCallerException - これが名前付きモジュールで、呼び出し元のモジュールがこのモジュールでない� �合

関連� �目:

• canUse(Class)
• ModuleDescriptor.uses()

canUse

public boolean canUse(Class<?> service)

このモジュールに、指定されたサービス・タイプへのサービス依存があるかどうかを示します。 このメソッドは、名前のないモジュールまたは自動モジュールで呼び出されると、常にtrueを返します。

パラメータ:

service - サービス型

戻り値:

このモジュールがサービス型stを使用する� �合はtrue

関連� �目:

• addUses(Class)

getPackages

public Set<String> getPackages()

このモジュール内のパッケージのパッケージ名のセットを返します。

名前付きモジュールの� �合、返されるセットにはモジュール内の各パッケージの要� が含まれます。

名前のないモジュールの� �合、返されるセットには、名前のないモジュール内のhas been definedが持つ各パッケージの要� が含まれます。

戻り値:

このモジュール内のパッケージのパッケージ名のセット

getAnnotation

public <T extends Annotation> T getAnnotation(Class<T> annotationClass)

存在する� �合は、この要� の指定された型の注釈を返し、そうでない� �合はnullを返します。 このメソッドは、名前のないモジュールで呼び出されたときにnullを返します。

このメソッドによって返される注釈は宣言注釈であることに注意してく� さい。

定義:

getAnnotation、インタフェースAnnotatedElement

型パラメータ:

T - 問合せ対象および存在する� �合は戻す注釈のタイプ

パラメータ:

annotationClass - 注釈型に対応するClassオブジェクト

戻り値:

存在する� �合は、この要� の指定された注釈型の注釈。そうでない� �合はnull

getAnnotations

public Annotation[] getAnnotations()

この要� に存在する注釈を返します。 この要� に存在する注釈がない� �合、戻り値は長さ0の配列です。 このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。 このメソッドは、名前のないモジュールで呼び出されたときに空の配列を返します。

このメソッドによって返される注釈は宣言注釈であることに注意してく� さい。

定義:

getAnnotations、インタフェースAnnotatedElement

戻り値:

この要� に存在する注釈

getDeclaredAnnotations

public Annotation[] getDeclaredAnnotations()

この要� に直接存在する注釈を返します。 このメソッドは継承された注釈を無視します。 この要� に直接存在する注釈がない� �合、戻り値は長さ0の配列です。 このメソッドの呼出し元は、返された配列を自由に変更することができ、これはほかの呼出し元に返された配列に影響を及ぼしません。 このメソッドは、名前のないモジュールで呼び出されたときに空の配列を返します。

このメソッドによって返される注釈は宣言注釈であることに注意してく� さい。

定義:

getDeclaredAnnotations、インタフェースAnnotatedElement

戻り値:

この要� に直接存在する注釈

getResourceAsStream

public InputStream getResourceAsStream(String name) throws IOException

このモジュールのリソースを読み取るための入力ストリー� を返します。 nameパラメータは、リソースを識別する'/'区切りのパス名です。 Class.getResourceAsStreamと同様に、このメソッドはモジュールのクラス・ローダーfindResource(String,String)メソッドに委任し、モジュール名(モジュールが無名の� �合はnull)およびリソースの名前で呼び出します。 リソース名の先� �にスラッシュがある� �合は、委任の前に削除されます。

名前付きモジュール内のリソースは、他のモジュールのコードで特定できないように、encapsulatedになります。 リソースを見つけるかどうかは、次のように判断されます:

• リソース名が".class"で終わる� �合は、カプセル化されません。
• 「パッケージ名」は、リソース名から導出されます。 パッケージ名がモジュール内のpackageである� �合、そのリソースは、パッケージがopenで、少なくともコール元のモジュールにしか配置できません。 リソースがモジュール内のパッケージに含まれていない� �合、そのリソースはカプセル化されません。

前述のリソースの「パッケージ名」は、名前の最後の'/'より前にある文字のサブシーケンスから導出され、サブシーケンス内の各'/'文字を'.'に置き換えます。 パッケージ名の導出時に先� �のスラッシュは無視されます。 たとえば、"a/b/c/foo.properties"という名前のリソースに導出されたパッケージ名は"a.b.c"です。 "META-INF"は有効なパッケージ名ではないため、"META-INF/MANIFEST.MF"という名前のリソース名はカプセル化されません。

このメソッドは、リソースがこのモジュールにないか、リソースがカプセル化されていて、呼出し側が見つけられない� �合にnullを返します。

パラメータ:

name - リソース名

戻り値:

リソースまたはnullを読み取るための入力ストリー�

スロー:

IOException - 入出力エラーが発生した� �合

関連� �目:

• Class.getResourceAsStream(String)

toString

public String toString()

このモジュールの文字列表現を返します。 名前付きモジュールの� �合、表現は文字列"module"、スペース、モジュール名の� �になります。 名前のないモジュールの� �合、表現は文字列"unnamed module"、スペース、および名前のないモジュールを識別する実装固有の文字列です。

オーバーライド:

toString、クラスObject

戻り値:

このモジュールの文字列表現