クラスClassLoader
- 直系の既知のサブクラス:
SecureClassLoader
ClassLoaderは抽象クラスです。 クラスのバイナリ名を指定すると、クラス・ローダーはクラスの定義を構成するデータを見つけるか生成します。 一般的な方法としては、名前をファイル名に変換して、ファイル・システムからその名前の「クラス・ファイル」を読み込みます。
すべてのClassオブジェクトには、そのオブジェクトを定義したClassLoaderへのreferenceが含まれます。
配列クラスのClassオブジェクトは、クラス・ローダーでは作成されませんが、Javaランタイムで必要とされるとおりに自動的に作成されます。 配列クラスのクラス・ローダー(Class.getClassLoader()から返される)は、その要素の型のクラス・ローダーと同じになります。要素の型がプリミティブ型の場合、配列クラスはクラス・ローダーを持ちません。
アプリケーションは、Java仮想マシンがクラスを動的にロードする方法を拡張するために、ClassLoaderのサブクラスを実装します。
クラスをロードすることに加えて、クラス・ローダーはリソースの特定も担当します。 リソースは、抽象的な'/'-separatedパス名で識別されるデータ(".class"ファイル、構成データ、またはイメージなど)です。 リソースは通常、アプリケーションまたはライブラリにパッケージ化されているため、アプリケーションまたはライブラリ内のコードでリソースを見つけることができます。 場合によっては、リソースが他のライブラリに配置されるように含まれています。
ClassLoaderクラスは、委任モデルを使用してクラスおよびリソースを検索します。 ClassLoaderの各インスタンスには、関連付けられた親クラス・ローダーがあります。 ClassLoaderインスタンスは、クラスまたはリソースの検索をリクエストされると、そのクラスまたはリソース自体の検索を試みる前に、そのクラスまたはリソースの検索を親クラス・ローダーに委譲します。
クラスの同時ロードをサポートするクラス・ローダーは、「並列対応」クラス・ローダーと呼ばれ、ClassLoader.registerAsParallelCapableメソッドを呼び出してクラス初期化時に自身を登録する必要があります。 ClassLoaderクラスは、デフォルトでパラレル対応として登録されています。 ただしそのサブクラスについては、並行可能な場合には自身を登録する必要があります。 委任モデルが厳密に階層化されていない環境では、クラス・ローダーはパラレルに対応している必要があります。そうしないと、クラス・ロード・プロセス(loadClassメソッドを参照してください)の間、ローダー・ロックが保持されるため、クラス・ロードによってデッドロックが発生する可能性があります。
ランタイム組み込みクラス・ローダー
Javaランタイムには、次の組み込みクラス・ローダーがあります:ブートストラップ・クラス・ローダー。 これは、仮想マシンの組込みクラス・ローダーで、通常は
nullとして表され、親を持ちません。「プラットフォーム・クラス・ローダー」。 プラットフォーム・クラス・ローダーは、「プラットフォーム・クラス」のロードを担当します。 プラットフォーム・クラスには、Java SEプラットフォームAPI、その実装クラス、およびプラットフォーム・クラス・ローダーまたはその祖先によって定義されたJDK固有のランタイム・クラスが含まれます。 プラットフォーム・クラス・ローダーは、
ClassLoaderインスタンスの親として使用できます。プラットフォーム・クラス・ローダーに定義されたモジュールのアップグレード/オーバーライドを可能にするために、アップグレードされたモジュールが定義されたモジュールをプラットフォーム・クラス・ローダーとその祖先以外のクラス・ローダーに読み込む場合、プラットフォーム・クラス・ローダーは他のクラス・ローダーに委譲する必要があります。アプリケーション・クラス・ローダーなどがあります。 言い換えれば、プラットフォーム・クラス・ローダーとその祖先以外のクラス・ローダーに定義された名前付きモジュールのクラスは、プラットフォーム・クラス・ローダーに可視である可能性があります。
「システム・クラス・ローダー」。 「アプリケーション・クラス・ローダー」とも呼ばれ、プラットフォーム・クラス・ローダーとは異なります。 システム・クラス・ローダーは、通常、アプリケーション・クラス・パス、モジュール・パスおよびJDK固有のツールでクラスを定義するために使用されます。 プラットフォーム・クラス・ローダーはシステム・クラス・ローダーの親または祖先であるため、システム・クラス・ローダーはその親に委任することでプラットフォーム・クラスをロードできます。
通常、Java仮想マシンは、プラットフォームに依存しない方法でローカル・ファイル・システムからクラスをロードします。 ただし、ファイルから作成できないクラスもあります。このようなクラスは、ネットワークなどのほかのソースから作成したり、アプリケーションが構築したりします。 メソッドdefineClassは、バイトの配列をクラスClassのインスタンスに変換します。 この新たに定義されたクラスのインスタンスは、Class.newInstanceを使用して作成できます。
クラス・ローダーで作成したオブジェクトのメソッドとコンストラクタは、ほかのクラスを参照できます。 参照されるclass(es)を決定するために、Java仮想マシンは、最初にクラスを作成したクラス・ローダーのloadClassメソッドを呼び出します。
たとえば、アプリケーションはネットワーク・クラス・ローダーを作成して、サーバーからクラス・ファイルをダウンロードできます。 コードは次のようになります。
ClassLoader loader = new NetworkClassLoader(host, port);
Object main = loader.loadClass("Main", true).newInstance();
. . .
ネットワーク・クラス・ローダー・サブクラスは、ネットワークからクラスをロードするために、メソッドfindClassおよびloadClassDataを定義する必要があります。 クラスを構成するバイトをダウンロードしたら、メソッドdefineClassを使用してクラス・インスタンスを作成する必要があります。 実装の例を次に示します。
class NetworkClassLoader extends ClassLoader {
String host;
int port;
public Class findClass(String name) {
byte[] b = loadClassData(name);
return defineClass(name, b, 0, b.length);
}
private byte[] loadClassData(String name) {
// load the class data from the connection
. . .
}
}
バイナリ名
ClassLoaderのメソッドにStringパラメータとして提供されるクラス名は、「Java言語仕様」で定義されているバイナリ名である必要があります。
次に、有効なクラス名の例を示します。
"java.lang.String" "javax.swing.JSpinner$DefaultEditor" "java.security.KeyStore$Builder$FileBuilder$1" "java.net.URLClassLoader$3$1"
ClassLoaderのメソッドへのStringパラメータとして指定されたパッケージ名は、空の文字列(名前のないパッケージを示す)または「Java言語仕様」で定義された完全修飾名でなければなりません。
- Java言語仕様を参照してください:
-
「6.7 完全修飾名と正規名」
「13.1 バイナリの形式」 - 導入されたバージョン:
- 1.0
- 関連項目:
-
コンストラクタのサマリー
コンストラクタ修飾子コンストラクタ説明protectedメソッドgetSystemClassLoader()によって親クラス・ローダーとして返されたClassLoaderを使用して、新しいクラス・ローダーを作成します。protectedClassLoader(ClassLoader parent) 指定された親クラス・ローダーを使って、委譲のために新しいクラス・ローダーを作成します。protectedClassLoader(String name, ClassLoader parent) 指定された名前の新しいクラス・ローダーを作成し、指定された親クラス・ローダーを使用して委任します。 -
メソッドのサマリー
修飾子と型メソッド説明voidこのクラス・ローダーのデフォルトのアサーション・ステータスをfalseに設定し、クラス・ローダーに関連付けられたパッケージ・デフォルトまたはクラス・アサーション・ステータス設定を破棄します。protected final Class<?> defineClass(byte[] b, int off, int len) 非推奨。protected final Class<?> defineClass(String name, byte[] b, int off, int len) バイトの配列をクラスClassのインスタンスに変換します。protected final Class<?> defineClass(String name, byte[] b, int off, int len, ProtectionDomain protectionDomain) 指定されたProtectionDomainを使用して、バイトの配列をクラスClassのインスタンスに変換します。protected final Class<?> defineClass(String name, ByteBuffer b, ProtectionDomain protectionDomain) 指定されたProtectionDomainを使用して、ByteBufferをクラスClassのインスタンスに変換します。protected PackagedefinePackage(String name, String specTitle, String specVersion, String specVendor, String implTitle, String implVersion, String implVendor, URL sealBase) このClassLoaderにnameでパッケージを定義します。protected Class<?> 指定されたバイナリ名を持つクラスを探します。protected Class<?> このクラス・ローダーに定義されているモジュール内で、指定された「バイナリ名」を持つクラスを検索します。protected StringfindLibrary(String libname) ネイティブ・ライブラリの絶対パス名を返します。protected final Class<?> findLoadedClass(String name) protected URLfindResource(String name) 指定された名前を持つリソースを検索します。protected URLfindResource(String moduleName, String name) このクラス・ローダーに定義されているモジュール内のリソースへのURLを返します。protected Enumeration<URL> findResources(String name) 指定された名前を持つすべてのリソースを表すURLオブジェクトの列挙を返します。protected final Class<?> findSystemClass(String name) 指定されたバイナリ名を持つクラスを探して、必要に応じてロードします。protected ObjectgetClassLoadingLock(String className) クラス・ロード操作用のロック・オブジェクトを返します。final PackagegetDefinedPackage(String name) このクラス・ローダーによって定義された、指定されたnameのPackageを返します。final Package[]このクラス・ローダーによって定義されたすべてのPackageを返します。getName()このクラス・ローダーの名前を返すか、このクラス・ローダーの名前が指定されていない場合はnullを返します。protected PackagegetPackage(String name) 非推奨。複数のクラス・ローダーが互いに委譲して同じパッケージ名を持つクラスを定義し、そのようなローダーの1つがgetPackageのルックアップ動作に依存して親ローダーからPackageを返す場合、Packageによって公開されるプロパティは期待どおりにならない場合があります残りのプログラム。protected Package[]このクラス・ローダーとその祖先によって定義されたすべてのPackageを返します。final ClassLoader委譲のための親クラス・ローダーを返します。static ClassLoaderプラットフォーム・クラス・ローダーを返します。getResource(String name) 指定された名前を持つリソースを検索します。getResourceAsStream(String name) 指定されたリソースを読み込む入力ストリームを返します。getResources(String name) 指定された名前を持つすべてのリソースを検索します。static ClassLoaderシステム・クラス・ローダーを返します。static URLgetSystemResource(String name) クラスをロードするために使用される検索パスから、指定された名前のリソースを探します。static InputStreamクラスをロードするのに使用される検索パスから、指定された名前のリソースを、読込み用にオープンします。static Enumeration<URL> getSystemResources(String name) クラスをロードするために使用される検索パスから、指定された名前のすべてのリソースを探します。final Moduleこのクラス・ローダーの名前のないModuleを返します。final booleanこのクラス・ローダーが「並列対応」、それ以外の場合はfalseとして登録されている場合はtrueを返します。Class<?> 指定されたバイナリ名を持つクラスをロードします。protected Class<?> 指定されたバイナリ名を持つクラスをロードします。protected static boolean呼び出し元を「並列対応」として登録します。protected final voidresolveClass(Class<?> c) 指定されたクラスをリンクします。指定された名前を持つすべてのリソースのURLである要素を持つストリームを返します。voidsetClassAssertionStatus(String className, boolean enabled) このクラス・ローダーの指定されたトップレベル・クラスおよびそこに含まれるネストされたクラス内に対して、目的のアサーション・ステータスを設定します。voidsetDefaultAssertionStatus(boolean enabled) このクラス・ローダーのデフォルトのアサーション・ステータスを設定します。voidsetPackageAssertionStatus(String packageName, boolean enabled) 指定されたパッケージ・デフォルトのアサーション・ステータスを設定します。protected final voidsetSigners(Class<?> c, Object[] signers) クラスの署名者を設定します。
-
コンストラクタの詳細
-
ClassLoader
protected ClassLoader(String name, ClassLoader parent) 指定された名前の新しいクラス・ローダーを作成し、指定された親クラス・ローダーを使用して委任します。- APIのノート:
- 親が
null(ブートストラップ・クラス・ローダー用)として指定されている場合、すべてのプラットフォーム・クラスが表示される保証はありません。 - パラメータ:
name- クラス・ローダー名; 名前が付けられていない場合はnullparent- 親クラス・ローダー- スロー:
IllegalArgumentException- 指定された名前が空の場合。- 導入されたバージョン:
- 9
-
ClassLoader
protected ClassLoader(ClassLoader parent) 指定された親クラス・ローダーを使って、委譲のために新しいクラス・ローダーを作成します。- APIのノート:
- 親が
null(ブートストラップ・クラス・ローダー用)として指定されている場合、すべてのプラットフォーム・クラスが表示される保証はありません。 - パラメータ:
parent- 親クラス・ローダー- 導入されたバージョン:
- 1.2
-
ClassLoader
protected ClassLoader()メソッドgetSystemClassLoader()によって親クラス・ローダーとして返されたClassLoaderを使用して、新しいクラス・ローダーを作成します。
-
-
メソッドの詳細
-
getName
public String getName()このクラス・ローダーの名前を返すか、このクラス・ローダーの名前が指定されていない場合はnullを返します。- APIのノート:
- このメソッドは、互換性のために最終ではありません。 このメソッドがオーバーライドされる場合、このメソッドは、このクラス・ローダーがインスタンス化されたときに指定された名前と同じ名前を返す必要があります。
- 戻り値:
- このクラス・ローダーの名前。このクラス・ローダーの名前がない場合は
null。 - 導入されたバージョン:
- 9
-
loadClass
public Class<?> loadClass(String name) throws ClassNotFoundException 指定されたバイナリ名を持つクラスをロードします。 このメソッドでのクラスの検索方法は、loadClass(String, boolean)メソッドの場合と同じです。 Java仮想マシンがこのメソッドを呼び出して、クラス参照を解決します。 このメソッドを呼び出すことは、loadClass(name, false)を呼び出すことと同じです。- パラメータ:
name- クラスのバイナリ名- 戻り値:
- 結果の
Classオブジェクト - スロー:
ClassNotFoundException- クラスが見つからなかった場合
-
loadClass
protected Class<?> loadClass(String name, boolean resolve) throws ClassNotFoundException 指定されたバイナリ名を持つクラスをロードします。 このメソッドのデフォルト実装では、次の順序でクラスを検索します。クラスがすでにロードされていないかチェックするために
findLoadedClass(String)を呼び出す。親クラス・ローダーで
loadClassメソッドを呼び出します。 親がnullの場合、代わりに仮想マシンに組み込まれたクラス・ローダーが使用されます。findClass(String)メソッドを呼び出してクラスを探す。
前述のステップでクラスが見つかり、
resolveフラグがtrueの場合、このメソッドは結果のClassオブジェクトに対してresolveClass(Class)メソッドを呼び出します。ClassLoaderのサブクラスは、このメソッドではなくfindClass(String)をオーバーライドすることをお薦めします。オーバーライドされないかぎり、このメソッドは、クラス・ロード・プロセス全体で
getClassLoadingLockメソッドの結果に対して同期化されます。- パラメータ:
name- クラスのバイナリ名resolve-trueの場合、クラスを解決- 戻り値:
- 結果の
Classオブジェクト - スロー:
ClassNotFoundException- クラスが見つからなかった場合
-
getClassLoadingLock
クラス・ロード操作用のロック・オブジェクトを返します。- APIのノート:
- このメソッドにより、パラレル対応クラス・ローダーは、複数のスレッドがデッドロックなしでクラスを同時にロードできるように、よりきめ細かいロック・スキームを実装できます。 非パラレル対応のクラス・ローダーの場合、
ClassLoaderオブジェクトは、クラスのロード操作中に同期されます。 非階層委任を持つクラス・ローダーは、デッドロックを防ぐために「パラレル対応として登録」である必要があります。 - 実装要件:
- この
ClassLoaderオブジェクトがパラレル対応として登録されている場合、このメソッドは、指定されたクラス名に関連付けられた専用オブジェクトを返します。 それ以外の場合、このメソッドは、このClassLoaderオブジェクトを返します。 - パラメータ:
className- ロードするクラスの名前- 戻り値:
- クラス・ロード処理用のロック
- スロー:
NullPointerException- パラレル対応として登録され、classNameがnullの場合- 導入されたバージョン:
- 1.7
- 関連項目:
-
findClass
protected Class<?> findClass(String name) throws ClassNotFoundException 指定されたバイナリ名を持つクラスを探します。 このメソッドは、クラスをロードするために委任モデルに従うクラス・ローダー実装によってオーバーライドされ、リクエストされたクラスの親クラス・ローダーをチェックした後、loadClassメソッドによって呼び出されます。- 実装要件:
- デフォルトの実装では、
ClassNotFoundExceptionがスローされます。 - パラメータ:
name- クラスのバイナリ名- 戻り値:
- 結果の
Classオブジェクト - スロー:
ClassNotFoundException- クラスが見つからなかった場合- 導入されたバージョン:
- 1.2
-
findClass
このクラス・ローダーに定義されているモジュール内で、指定された「バイナリ名」を持つクラスを検索します。 モジュールからのロードをサポートするクラス・ローダー実装は、このメソッドをオーバーライドする必要があります。- APIのノート:
- このメソッドは、クラスが見つからなかった場合に
ClassNotFoundExceptionをスローするのではなく、nullを返します。 - 実装要件:
moduleNameがnullのとき、findClass(String)を呼び出すことによって、デフォルトの実装がクラスを見つけようとします。 そうでなければ、nullを返します。- パラメータ:
moduleName- モジュール名。またはnullを使用して、このクラス・ローダーの「名前のないモジュール」内のクラスを見つけますname- クラスのバイナリ名- 戻り値:
- 結果の
Classオブジェクト、またはクラスが見つからない場合はnull。 - 導入されたバージョン:
- 9
-
defineClass
@Deprecated(since="1.1") protected final Class<?> defineClass(byte[] b, int off, int len) throws ClassFormatError 非推奨。バイトの配列をクラスClassのインスタンスに変換します。Classを使用する前に解決する必要があります。 このメソッドは非推奨です。バイナリ名を最初の引数として取るバージョンの方が安全であるため、そのバージョンを使用するようにしてください。- パラメータ:
b- クラス・データを構成するバイト。off+len-1を介したoffの位置のバイトは、「Java Virtual Machine仕様」で定義されている有効なクラス・ファイルの形式である必要があります。off- クラス・データのbの開始オフセットlen- クラス・データの長さ- 戻り値:
- 指定したクラス・データから作成された
Classオブジェクト - スロー:
ClassFormatError- データが有効なクラスを含まなかった場合IndexOutOfBoundsException-offまたはlenのいずれかが負の場合、またはoff+lenがb.lengthより大きい場合。SecurityException- このクラスとは異なる一連の証明書で署名されたクラスを含むパッケージにこのクラスを追加しようとした場合、または「java.」で始まる完全指定名を持つパッケージ内でクラスを定義しようとした場合。- 関連項目:
-
defineClass
protected final Class<?> defineClass(String name, byte[] b, int off, int len) throws ClassFormatError バイトの配列をクラスClassのインスタンスに変換します。Classを使用する前に解決する必要があります。このメソッドは、新しく定義されたクラスにデフォルトの
ProtectionDomainを割り当てます。ProtectionDomainのgetPermissionsメソッドは、常にnullを返します。 デフォルトの保護ドメインは、defineClassの最初の起動時に作成され、後続の起動時に再使用されます。クラスに特定の
ProtectionDomainを割り当てるには、引数の1つとしてProtectionDomainを取るdefineClassメソッドを使用します。このメソッドは、
Class(そのようなパッケージがこのクラス・ローダーでまだ定義されていない場合)のパッケージに対応するこのクラス・ローダー内のパッケージを定義します。 定義されたパッケージの名前は、バイト配列bで指定されたクラスの「バイナリ名」から派生します。 定義されたパッケージのその他のプロパティは、Packageで指定されたものです。- パラメータ:
name- クラスの予想される「バイナリ名」、または不明な場合はnullb- クラス・データを構成するバイト。off+len-1を介したoffの位置のバイトは、「Java Virtual Machine仕様」で定義されている有効なクラス・ファイルの形式である必要があります。off- クラス・データのbの開始オフセットlen- クラス・データの長さ- 戻り値:
- 指定したクラス・データから作成された
Classオブジェクト。 - スロー:
ClassFormatError- データが有効なクラスを含まなかった場合IndexOutOfBoundsException-offまたはlenのいずれかが負の場合、またはoff+lenがb.lengthより大きい場合。SecurityException- このクラス(符号なし)とは異なる証明書セットによって署名されたクラスを含むパッケージにこのクラスを追加しようとした場合、またはnameが"java."で始まる場合。- 導入されたバージョン:
- 1.1
- 関連項目:
-
defineClass
protected final Class<?> defineClass(String name, byte[] b, int off, int len, ProtectionDomain protectionDomain) throws ClassFormatError 指定されたProtectionDomainを使用して、バイトの配列をクラスClassのインスタンスに変換します。指定された
ProtectionDomainがnullの場合、defineClass(String, byte[], int, int)のドキュメントで指定されているように、デフォルトの保護ドメインがクラスに割り当てられます。 最初にクラスを解決してからでなければ、クラスを使用することはできません。パッケージで定義される最初のクラスにより、そのパッケージ内で続いて定義されたすべてのクラスに必要な、証明書の正確なセットが決まります。 クラスの証明書のセットは、クラスの
ProtectionDomain内のCodeSourceから取得されます。 そのパッケージに追加されるすべてのクラスに同じ証明書セットが含まれている必要があります。そうでない場合、SecurityExceptionがスローされます。nameがnullの場合、このチェックは実行されないことに注意してください。 必ず、定義するクラスのバイナリ名をバイトとともに渡すようにしてください。 このようにして渡すと、定義するクラスは実際に考えたとおりのクラスになります。指定された
nameが"java."で始まる場合は、「プラットフォーム・クラス・ローダー」またはその祖先によってのみ定義できます。定義されていない場合は、SecurityExceptionがスローされます。nameがnullでない場合は、バイト配列bで指定されたクラスの「バイナリ名」と等しい必要があります。そうでない場合は、NoClassDefFoundErrorがスローされます。このメソッドは、
Class(そのようなパッケージがこのクラス・ローダーでまだ定義されていない場合)のパッケージに対応するこのクラス・ローダー内のパッケージを定義します。 定義されたパッケージの名前は、バイト配列bで指定されたクラスの「バイナリ名」から派生します。 定義されたパッケージのその他のプロパティは、Packageで指定されたものです。- パラメータ:
name- クラスの予想される「バイナリ名」、または不明な場合はnullb- クラス・データを構成するバイト。off+len-1を介したoffの位置のバイトは、「Java Virtual Machine仕様」で定義されている有効なクラス・ファイルの形式である必要があります。off- クラス・データのbの開始オフセットlen- クラス・データの長さprotectionDomain- クラスのProtectionDomain- 戻り値:
- データから作成された
Classオブジェクト、およびProtectionDomain。 - スロー:
ClassFormatError- データが有効なクラスを含まなかった場合NoClassDefFoundError-nameがnullでなく、bで指定されたクラスの「バイナリ名」と等しくない場合IndexOutOfBoundsException-offまたはlenのいずれかが負の場合、またはoff+lenがb.lengthより大きい場合。SecurityException- このクラスとは異なる証明書セットによって署名されたクラスを含むパッケージにこのクラスを追加しようとした場合、またはnameが"java."で始まり、このクラス・ローダーがプラットフォーム・クラス・ローダーまたはその祖先ではない場合。
-
defineClass
protected final Class<?> defineClass(String name, ByteBuffer b, ProtectionDomain protectionDomain) throws ClassFormatError 指定されたProtectionDomainを使用して、ByteBufferをクラスClassのインスタンスに変換します。 指定されたProtectionDomainがnullの場合、defineClass(String, byte[], int, int)のドキュメントで指定されているように、デフォルトの保護ドメインがクラスに割り当てられます。 最初にクラスを解決してからでなければ、クラスを使用することはできません。パッケージの証明書のセット、クラス名の制限、およびクラスの定義済みパッケージを決定する、パッケージで定義されている最初のクラスに関する規則は、
defineClass(String, byte[], int, int, ProtectionDomain)のドキュメントで指定されているものと同じです。cl
.defineClass(name,bBuffer,pd)という形式のこのメソッドを呼び出すと、文とまったく同じ結果になります...
byte[] temp = new byte[bBuffer.remaining()];
bBuffer.get(temp);cl.defineClass(name, temp, 0, temp.length, pd)を返します- パラメータ:
name- クラスの予想される「バイナリ名」。不明な場合はnullb- クラス・データを構成するバイト。b.position()からb.position() + b.limit() -1までの位置のバイトは、「Java Virtual Machine仕様」で定義されている有効なクラス・ファイルの形式である必要があります。protectionDomain- クラスのProtectionDomain、またはnull。- 戻り値:
- データから作成された
Classオブジェクト、およびProtectionDomain。 - スロー:
ClassFormatError- データが有効なクラスを含まなかった場合。NoClassDefFoundError-nameがnullでなく、bで指定されたクラスの「バイナリ名」と等しくない場合SecurityException- このクラスと異なる証明書セットで署名されたクラスを含むパッケージにこのクラスを追加しようとした場合、またはnameが"java."で始まる場合。- 導入されたバージョン:
- 1.5
- 関連項目:
-
resolveClass
protected final void resolveClass(Class<?> c) 指定されたクラスをリンクします。 クラス・ローダーはこのメソッドを使って、クラスをリンクします。 クラスcがすでにリンクされている場合、このメソッドは単に返します。 それ以外の場合、クラスは「Java言語仕様」の"実行"の章で説明されているようにリンクされます。- パラメータ:
c- リンクするクラス- スロー:
NullPointerException-cがnullの場合。- 関連項目:
-
findSystemClass
protected final Class<?> findSystemClass(String name) throws ClassNotFoundException 指定されたバイナリ名を持つクラスを探して、必要に応じてロードします。このメソッドはシステム・クラス・ローダー(
getSystemClassLoader()を参照)を使ってそのクラスをロードします。 返されるClassオブジェクトには、複数のClassLoaderが関連付けられている場合があります。 ほとんどのクラス・ローダーはfindClass(String)のみをオーバーライドする必要があるため、通常、ClassLoaderのサブクラスはこのメソッドを呼び出す必要はありません。- パラメータ:
name- クラスのバイナリ名- 戻り値:
- 指定した
nameのClassオブジェクト - スロー:
ClassNotFoundException- クラスが見つからなかった場合- 関連項目:
-
findLoadedClass
-
setSigners
-
findResource
protected URL findResource(String moduleName, String name) throws IOException このクラス・ローダーに定義されているモジュール内のリソースへのURLを返します。 モジュールからのロードをサポートするクラス・ローダー実装は、このメソッドをオーバーライドする必要があります。- APIのノート:
- このメソッドは、
Class.getResource、Class.getResourceAsStreamおよびModule.getResourceAsStreamメソッドの基礎です。Module.getResourceAsStreamで指定されたカプセル化の規則の対象ではありません。 - 実装要件:
moduleNameがnullのとき、findResource(String)を呼び出すことによって、デフォルトの実装はリソースを見つけようとします。 そうでなければ、nullを返します。- パラメータ:
moduleName- モジュール名。またはnullを使用して、このクラス・ローダーの「名前のないモジュール」内のリソースを検索name- リソース名- 戻り値:
- リソースのURL。リソースが見つからなかった場合、リソースを見つけるためにURLを作成できなかった場合、またはクラス・ローダーに定義された指定の名前のモジュールがない場合、
null。 - スロー:
IOException- 入出力エラーが発生した場合- 導入されたバージョン:
- 9
- 関連項目:
-
getResource
指定された名前を持つリソースを検索します。 リソースは、クラス・コードからコード位置に依存しない方法でアクセス可能なデータ(イメージ、オーディオ、テキストなど)です。リソースの名前は、リソースを識別する
/で区切られたパス名です。名前付きモジュールのリソースは、
Module.getResourceAsStreamで指定されたカプセル化ルールの影響を受けます。 また、リソースの名前が".class"で終わる特殊なケースを除き、このメソッドは、パッケージがopenedで無条件に(このメソッドの呼び出し元がリソースと同じモジュール内にあっても)の場合にのみ、指定されたモジュールのパッケージ内のリソースを検索します。- APIのノート:
- 複数のモジュールが同じクラス・ローダーに定義されており、複数のモジュールに指定した名前のリソースが含まれている場合、そのモジュールが検索される順序は指定されず、非常に予測できない場合があります。 このメソッドをオーバーライドするときは、実装によっていずれかの委譲が
getResources(String)メソッドと確実に一致するようになることをお薦めします。 - 実装要件:
- デフォルトの実装では、最初にリソースの親クラス・ローダーを検索します。親が
nullの場合、仮想マシンに組み込まれているクラス・ローダーのパスが検索されます。 見つからなければ、このメソッドはfindResource(String)を呼び出してリソースを探します。 - パラメータ:
name- リソース名- 戻り値:
- リソースを読み取るための
URLオブジェクト。リソースが見つからなかった場合、リソースを見つけるためにURLを構築できなかった場合、またはリソースが無条件にオープンされていないパッケージ内にある場合、null。 - スロー:
NullPointerException-nameがnullである場合- 導入されたバージョン:
- 1.1
-
getResources
public Enumeration<URL> getResources(String name) throws IOException 指定された名前を持つすべてのリソースを検索します。 リソースは、クラス・コードからコード位置に依存しない方法でアクセス可能なデータ(イメージ、オーディオ、テキストなど)です。リソースの名前は、リソースを識別する
/区切りのパス名です。名前付きモジュールのリソースは、
Module.getResourceAsStreamで指定されたカプセル化ルールの影響を受けます。 また、リソースの名前が".class"で終わる特殊なケースを除き、このメソッドは、パッケージがopenedで無条件に(このメソッドの呼び出し元がリソースと同じモジュール内にあっても)の場合にのみ、指定されたモジュールのパッケージ内のリソースを検索します。- APIのノート:
- 複数のモジュールが同じクラス・ローダーに定義されており、複数のモジュールに指定した名前のリソースが含まれている場合、順序付けは指定されず、非常に予測できない可能性があります。 このメソッドをオーバーライドするときは、実装によっていずれかの委譲が
getResource(String)メソッドと確実に一致するようになることをお薦めします。 これにより、列挙のnextElementメソッドから返される最初の要素が必ず、getResource(String)メソッドが返すリソースと同じものになるはずです。 - 実装要件:
- デフォルトの実装では、最初にリソースの親クラス・ローダーを検索します。親が
nullの場合、仮想マシンに組み込まれているクラス・ローダーのパスが検索されます。 次に、findResources(String)を呼び出して、このクラス・ローダー内の名前のリソースを検索します。 親クラス・ローダーを検索した後にfindResourcesで見つかった要素が検索されたURLを要素とする列挙を返します。 - パラメータ:
name- リソース名- 戻り値:
- リソースの
URLオブジェクトの列挙。 リソースが見つからなかった場合、列挙は空になる。URLを構築できないか、無条件にオープンされていないパッケージ内にあるリソースは、列挙では返されません。 - スロー:
IOException- 入出力エラーが発生した場合NullPointerException-nameがnullである場合- 導入されたバージョン:
- 1.2
-
resources
指定された名前を持つすべてのリソースのURLである要素を持つストリームを返します。 リソースは、クラス・コードからコード位置に依存しない方法でアクセス可能なデータ(イメージ、オーディオ、テキストなど)です。リソースの名前は、リソースを識別する
/区切りのパス名です。リソースは、返されたストリームが評価されるときに検出されます。 評価の結果が
IOExceptionの場合、I/O例外はUncheckedIOExceptionにラップされ、その後スローされます。名前付きモジュールのリソースは、
Module.getResourceAsStreamで指定されたカプセル化ルールの影響を受けます。 また、リソースの名前が".class"で終わる特殊なケースを除き、このメソッドは、パッケージがopenedで無条件に(このメソッドの呼び出し元がリソースと同じモジュール内にあっても)の場合にのみ、指定されたモジュールのパッケージ内のリソースを検索します。- APIのノート:
- このメソッドをオーバーライドするときは、実装によっていずれかの委譲が
getResource(String)メソッドと確実に一致するようになることをお薦めします。 これにより、ストリームによって返される最初の要素が、getResource(String)メソッドが返すリソースと同じであることが保証されます。 - 実装要件:
- デフォルトの実装では、
getResourcesを呼び出して、指定された名前を持つすべてのリソースを検索し、列挙内の要素をソースとして持つストリームを返します。 - パラメータ:
name- リソース名- 戻り値:
- リソース
URLオブジェクトのストリーム。 リソースが見つからない場合、ストリームは空になります。URLを構築できないか、無条件にオープンされていないパッケージ内にあるリソースは、ストリームには含まれません。 - スロー:
NullPointerException-nameがnullである場合- 導入されたバージョン:
- 9
-
findResource
指定された名前を持つリソースを検索します。 クラス・ローダーの実装は、このメソッドをオーバーライドする必要があります。名前付きモジュールのリソースの場合、メソッドは、
ModulegetResourceAsStreamメソッドで指定されたカプセル化のルールを実装する必要があります。 また、パッケージが無条件にopenedでないかぎり、名前付きモジュールのパッケージで".class"以外のリソースを検出することはできません。- 実装要件:
- デフォルトの実装では
nullを返します。 - パラメータ:
name- リソース名- 戻り値:
- リソースを読み取るための
URLオブジェクト。リソースが見つからなかった場合、リソースを見つけるためにURLを構築できなかった場合、またはリソースが無条件にオープンされていないパッケージ内にある場合、null。 - 導入されたバージョン:
- 1.2
-
findResources
protected Enumeration<URL> findResources(String name) throws IOException 指定された名前を持つすべてのリソースを表すURLオブジェクトの列挙を返します。 クラス・ローダーの実装は、このメソッドをオーバーライドする必要があります。名前付きモジュールのリソースの場合、メソッドは、
ModulegetResourceAsStreamメソッドで指定されたカプセル化のルールを実装する必要があります。 また、パッケージが無条件にopenedでないかぎり、名前付きモジュールのパッケージで".class"以外のリソースを検出することはできません。- 実装要件:
- デフォルトの実装は、要素を含まない列挙型を返します。
- パラメータ:
name- リソース名- 戻り値:
- リソースの
URLオブジェクトの列挙。 リソースが見つからなかった場合、列挙は空になる。URLを構築できないか、無条件にオープンされていないパッケージ内にあるリソースは、列挙では返されません。 - スロー:
IOException- 入出力エラーが発生した場合- 導入されたバージョン:
- 1.2
-
registerAsParallelCapable
protected static boolean registerAsParallelCapable()呼び出し元を「並列対応」として登録します。 登録が成功するのは、次の条件をすべて満たす場合だけです。- 呼出し元のインスタンスが1つも作成されていない
- 呼出し元のすべてのスーパー・クラス(Objectクラスは除く)が並行可能として登録されている
いったんクラス・ローダーを並行可能として登録すると、それを元に戻す方法はありません。
このメソッドが、コール元が
ClassLoaderのサブクラスでないコンテキストからコールされる場合、またはスタック(例、JNIアタッチ・スレッドから直接コールされる場合)にコール元フレームがない場合、IllegalCallerExceptionがスローされます。- 戻り値:
- 呼出し側がパラレル対応として正常に登録された場合は
true、それ以外の場合はfalse。 - スロー:
IllegalCallerException- コール元がClassLoaderのサブクラスでない場合- 導入されたバージョン:
- 1.7
- 関連項目:
-
isRegisteredAsParallelCapable
public final boolean isRegisteredAsParallelCapable()このクラス・ローダーが「並列対応」、それ以外の場合はfalseとして登録されている場合はtrueを返します。- 戻り値:
- このクラス・ローダーがパラレル対応の場合は
true、それ以外の場合はfalse。 - 導入されたバージョン:
- 9
- 関連項目:
-
getSystemResource
クラスをロードするために使用される検索パスから、指定された名前のリソースを探します。 このメソッドはシステム・クラス・ローダー(getSystemClassLoader()を参照)を使ってリソースを見つけます。名前付きモジュールのリソースは、
Module.getResourceAsStreamで指定されたカプセル化ルールの影響を受けます。 また、リソースの名前が".class"で終わる特殊なケースを除き、このメソッドは、パッケージが無条件にopenedの場合にのみ、指定されたモジュールのパッケージ内のリソースを検索します。- パラメータ:
name- リソース名- 戻り値:
- リソースへの
URL。リソースが見つからなかった場合、リソースを見つけるためにURLを構築できなかった場合、またはリソースが無条件にオープンされていないパッケージ内にある場合、null。 - 導入されたバージョン:
- 1.1
-
getSystemResources
public static Enumeration<URL> getSystemResources(String name) throws IOException クラスをロードするために使用される検索パスから、指定された名前のすべてのリソースを探します。 したがって、見つかったリソースは、URLオブジェクトのEnumerationとして返されます。検索順については、
getSystemResource(String)のドキュメントを参照してください。名前付きモジュールのリソースは、
Module.getResourceAsStreamで指定されたカプセル化ルールの影響を受けます。 また、リソースの名前が".class"で終わる特殊なケースを除き、このメソッドは、パッケージが無条件にopenedの場合にのみ、指定されたモジュールのパッケージ内のリソースを検索します。- パラメータ:
name- リソース名- 戻り値:
- リソースの
URLオブジェクトの列挙。 リソースが見つからなかった場合、列挙は空になる。URLを構築できないか、無条件にオープンされていないパッケージ内にあるリソースは、列挙では返されません。 - スロー:
IOException- 入出力エラーが発生した場合- 導入されたバージョン:
- 1.2
-
getResourceAsStream
public InputStream getResourceAsStream(String name) 指定されたリソースを読み込む入力ストリームを返します。検索順については、
getResource(String)のドキュメントを参照してください。名前付きモジュールのリソースは、
Module.getResourceAsStreamで指定されたカプセル化ルールの影響を受けます。 また、リソースの名前が".class"で終わる特殊なケースを除き、このメソッドは、パッケージが無条件にopenedの場合にのみ、指定されたモジュールのパッケージ内のリソースを検索します。- パラメータ:
name- リソース名- 戻り値:
- リソースを読み取るための入力ストリーム。リソースが見つからない場合、またはリソースが無条件にオープンされていないパッケージ内にある場合は、
null。 - スロー:
NullPointerException-nameがnullである場合- 導入されたバージョン:
- 1.1
-
getSystemResourceAsStream
public static InputStream getSystemResourceAsStream(String name) クラスをロードするのに使用される検索パスから、指定された名前のリソースを、読込み用にオープンします。 このメソッドはシステム・クラス・ローダー(getSystemClassLoader()を参照)を使ってリソースを見つけます。名前付きモジュールのリソースは、
Module.getResourceAsStreamで指定されたカプセル化ルールの影響を受けます。 また、リソースの名前が".class"で終わる特殊なケースを除き、このメソッドは、パッケージが無条件にopenedの場合にのみ、指定されたモジュールのパッケージ内のリソースを検索します。- パラメータ:
name- リソース名- 戻り値:
- リソースを読み取るための入力ストリーム。リソースが見つからない場合、またはリソースが無条件にオープンされていないパッケージ内にある場合は、
null。 - 導入されたバージョン:
- 1.1
-
getParent
public final ClassLoader getParent()委譲のための親クラス・ローダーを返します。 一部の実装では、ブートストラップ・クラス・ローダーを表すためにnullを使用できます。 このクラス・ローダーの親がブートストラップ・クラス・ローダーの場合、このメソッドはこのような実装でnullを返します。- 戻り値:
- 親
ClassLoader - 導入されたバージョン:
- 1.2
-
getUnnamedModule
public final Module getUnnamedModule()このクラス・ローダーの名前のないModuleを返します。- 戻り値:
- このクラス・ローダーの無名Module
- 導入されたバージョン:
- 9
- 関連項目:
-
getPlatformClassLoader
public static ClassLoader getPlatformClassLoader()プラットフォーム・クラス・ローダーを返します。 すべての「プラットフォーム・クラス」は、プラットフォーム・クラス・ローダーから参照できます。- 実装上のノート:
- 組み込みプラットフォーム・クラス・ローダーの名前は
"platform"です。 - 戻り値:
- プラットフォーム
ClassLoader。 - 導入されたバージョン:
- 9
-
getSystemClassLoader
public static ClassLoader getSystemClassLoader()システム・クラス・ローダーを返します。 これは、新しいClassLoaderインスタンスのデフォルトの委任の親であり、通常、アプリケーションの起動に使用されるクラス・ローダーです。このメソッドは、最初にランタイムの起動シーケンスの初期に呼び出され、その時点でシステム・クラス・ローダーが作成されます。 このクラス・ローダーは、メイン・アプリケーション・スレッド(たとえば、メイン・クラスの
mainメソッドを呼び出すスレッドです)のコンテキスト・クラス・ローダーになります。デフォルトのシステム・クラス・ローダーは、このクラスの実装依存インスタンスです。
このメソッドが最初に呼び出されたときにシステム・プロパティ"
java.system.class.loader"が定義されている場合、このプロパティの値はシステム・クラス・ローダーとして返されるクラスの名前になります。 クラスはデフォルトのシステム・クラス・ローダーを使用してロードされ、委任の親として使用されるClassLoader型の単一パラメータをとるpublicコンストラクタを定義する必要があります。 次に、このコンストラクタを使用し、デフォルトのシステム・クラス・ローダーをパラメータに指定して、インスタンスが作成されます。 結果として得られるクラス・ローダーは、システム・クラス・ローダーとして定義されます。 構築中、クラス・ローダーはgetSystemClassLoader()をコールしないように十分に注意する必要があります。 システム・クラス・ローダーの循環初期化が検出されると、IllegalStateExceptionがスローされます。- 実装上のノート:
- システム・クラス・ローダーをオーバーライドするシステム・プロパティは、VMがほぼ完全に初期化されるまで検査されません。 起動時にこのメソッドを実行するコードは、システムが完全に初期化されるまで戻り値をキャッシュしないように注意してください。
組み込みシステム・クラス・ローダーの名前は
"app"です。 VMの初期化中にシステム・プロパティ"java.class.path"が読み取られ、クラス・パスが決定されます。 "java.class.path"プロパティの空の値は、初期モジュール(メイン・クラスを含むモジュール)の名前が付いているか、名前がないかによって、異なる方法で解釈されます: 名前付きの場合、組込みシステム・クラス・ローダーにはクラス・パスがなく、アプリケーション・モジュール・パスを使用してクラスおよびリソースを検索します。そうでない場合、名前がない場合は現在の作業ディレクトリへのクラス・パスが設定されます。クラス・パス上のJARファイルには、クラス・パスに含める依存JARファイルを指定するための
Class-Pathマニフェスト属性が含まれる場合があります。Class-Pathエントリは、(詳細は、「JARファイルの仕様」を参照してください。)の妥当性について特定の条件を満たしている必要があります。 無効なClass-Pathエントリは無視されます。 デバッグの目的で、jdk.net.URLClassPath.showIgnoredClassPathEntriesシステム・プロパティがtrueに設定されている場合、無視されたエントリをコンソールに出力できます。 - 戻り値:
- システム
ClassLoader - スロー:
IllegalStateException- "java.system.class.loader"プロパティで指定されたクラス・ローダーの作成中に再帰的に呼び出された場合。Error- システム・プロパティ"java.system.class.loader"が定義されているが、指定されたクラスをロードできなかった場合、プロバイダ・クラスは必要なコンストラクタを定義しないか、そのコンストラクタが呼び出されたときに例外をスローします。 エラーの根本原因は、Throwable.getCause()メソッドを使用して取得できる。
-
definePackage
protected Package definePackage(String name, String specTitle, String specVersion, String specVendor, String implTitle, String implVersion, String implVendor, URL sealBase) このClassLoaderにnameでパッケージを定義します。「パッケージ名」は、クラス・ローダー内で一意である必要があり、作成後に再定義または変更することはできません。
クラス・ローダーが、バージョン情報などの特定のプロパティを持つパッケージを定義する場合、クラス・ローダーは、
defineClassをコールする前にこのdefinePackageメソッドをコールする必要があります。 それ以外の場合、defineClassメソッドは、新しく定義されたクラスのパッケージに対応するパッケージをこのクラス・ローダーに定義します。この定義済パッケージのプロパティは、Packageで指定されます。- APIのノート:
- JAR内のクラスのパッケージを定義したいクラス・ローダーは、通常、JARのマニフェストの仕様タイトルと実装タイトル、バージョンおよびベンダーを使用します。 パッケージがJARのマニフェストでsealedとして指定されている場合、通常、JARファイルの
URLがsealBaseとして使用されます。 このクラス・ローダーで定義されたパッケージ'p'のクラスが複数のJARからロードされる場合、Packageオブジェクトには、定義されたパッケージ'p'の最初のクラスと、パッケージ'p'を明示的に定義するために最初に読み込まれるJARのマニフェストに応じて、異なる情報が含まれることがあります。クラス・ローダーは、「名前付きモジュール」でパッケージを明示的に定義するためにこのメソッドをコールしないことを強くお薦めします。かわりに、クラスが「定義されている」の場合、パッケージは自動的に定義されます。
Packageを明示的に定義することが望ましい場合は、名前付きモジュール内のすべてのパッケージが、Packageで指定されたプロパティで定義されていることを確認する必要があります。 それ以外の場合、名前付きモジュールの一部のPackageオブジェクトは、たとえば異なるシール・ベースでシールされる場合があります。 - パラメータ:
name- 「パッケージ名」specTitle- 仕様のタイトルspecVersion- 仕様のバージョンspecVendor- 仕様のベンダーimplTitle- 実装のタイトルimplVersion- 実装のバージョンimplVendor- 実装のベンダーsealBase-null以外の場合、このパッケージは、指定されたコード・ソースURLオブジェクトに関してシールされます。 そうでない場合、パッケージはシールされない- 戻り値:
- 新しく定義された
Packageオブジェクト - スロー:
NullPointerException-nameがnullの場合。IllegalArgumentException- 指定されたnameのパッケージがこのクラス・ローダーによってすでに定義されている場合- Java Virtual Machine仕様を参照してください:
-
5.3 作成およびロード
- 導入されたバージョン:
- 1.2
- 関連項目:
-
getDefinedPackage
このクラス・ローダーによって定義された、指定されたnameのPackageを返します。- パラメータ:
name- 「パッケージ名」- 戻り値:
- このクラス・ローダーによって定義された指定された名前の
Package、または見つからなければnull - スロー:
NullPointerException-nameがnullの場合。- Java Virtual Machine仕様を参照してください:
-
5.3 作成およびロード
- 導入されたバージョン:
- 9
-
getDefinedPackages
public final Package[] getDefinedPackages()このクラス・ローダーによって定義されたすべてのPackageを返します。 返された配列には、同じ名前のPackageが重複していません。- APIのノート:
- このメソッドは、既存の
getPackages()メソッドとの一貫性を保つために、SetまたはStreamではなく配列を返します。 - 戻り値:
- このクラス・ローダーによって定義された
Packageオブジェクトの配列。このクラス・ローダーによってパッケージが定義されていない場合、長さがゼロの配列。 - Java Virtual Machine仕様を参照してください:
-
5.3 作成およびロード
- 導入されたバージョン:
- 9
-
getPackage
@Deprecated(since="9") protected Package getPackage(String name) 非推奨。複数のクラス・ローダーが互いに委譲して同じパッケージ名を持つクラスを定義し、そのようなローダーの1つがgetPackageのルックアップ動作に依存して親ローダーからPackageを返す場合、Packageによって公開されるプロパティは期待どおりにならない場合があります残りのプログラム。 たとえば、Packageは、子ローダーによって定義されたpackage-info.classファイルに注釈が存在する場合でも、親ローダーによって定義されたpackage-info.classファイルからのみ注釈を公開します。 より堅牢なアプローチは、指定されたクラス・ローダーのPackageを返すgetDefinedPackage(java.lang.String)メソッドを使用することです。このクラス・ローダーとその祖先で、nameによってパッケージを検索します。このクラス・ローダーが指定された名前の
Packageを定義すると、Packageが返されます。 それ以外の場合、このクラス・ローダーの祖先は、指定された名前のPackageを再帰的に(親による親)で検索されます。- APIのノート:
platform class loaderはアプリケーション・クラス・ローダーに委任できますが、アプリケーション・クラス・ローダーはその祖先ではありません。 プラットフォーム・クラス・ローダーで呼び出された場合、このメソッドはアプリケーション・クラス・ローダーに定義されているパッケージを検出しません。- パラメータ:
name- 「パッケージ名」- 戻り値:
- このクラス・ローダーまたはその祖先によって定義された指定された名前の
Package、または見つからない場合はnull。 - スロー:
NullPointerException-nameがnullの場合。- 導入されたバージョン:
- 1.2
- 関連項目:
-
getPackages
protected Package[] getPackages()このクラス・ローダーとその祖先によって定義されたすべてのPackageを返します。 返される配列には、同じパッケージ名の複数のPackageオブジェクトを含めることができます。各オブジェクトは、クラス・ローダー階層内の異なるクラス・ローダーによって定義されます。- APIのノート:
platform class loaderは、アプリケーション・クラス・ローダーに委任できます。 つまり、アプリケーション・クラス・ローダーに定義されているモジュール内のパッケージは、プラットフォーム・クラス・ローダーから参照できます。 一方、アプリケーション・クラス・ローダーは祖先ではないため、プラットフォーム・クラス・ローダーで起動された場合、このメソッドはアプリケーション・クラス・ローダーに定義されているパッケージを返しません。- 戻り値:
- このクラス・ローダーとその祖先によって定義された
Packageオブジェクトの配列 - 導入されたバージョン:
- 1.2
- 関連項目:
-
findLibrary
-
setDefaultAssertionStatus
public void setDefaultAssertionStatus(boolean enabled) このクラス・ローダーのデフォルトのアサーション・ステータスを設定します。 この設定により、将来、このクラス・ローダーによってロードされ初期化されるクラスのアサーションがデフォルトで有効か無効かが決まります。 この設定をパッケージ単位またはクラス単位でオーバーライドするには、setPackageAssertionStatus(String, boolean)またはsetClassAssertionStatus(String, boolean)を呼び出します。- パラメータ:
enabled- このクラス・ローダーによってロードされたクラスがアサーションをデフォルトで有効にする場合はtrue、アサーションをデフォルトで無効にする場合はfalse。- 導入されたバージョン:
- 1.4
-
setPackageAssertionStatus
public void setPackageAssertionStatus(String packageName, boolean enabled) 指定されたパッケージ・デフォルトのアサーション・ステータスを設定します。 パッケージ・デフォルトのアサーション・ステータスにより、指定されたパッケージまたはその「サブパッケージ」のどれかに属する、将来初期化されるクラスのアサーション・ステータスが決まります。pという名前のパッケージのサブパッケージは、名前が"
p."で始まる任意のパッケージです。 たとえば、javax.swing.textはjavax.swingのサブパッケージで、java.utilとjava.lang.reflectは両方ともjavaのサブパッケージです。1つのクラスに複数のパッケージ・デフォルトが適用される場合は、そのクラスにもっとも関連性の高いパッケージ・デフォルトが、ほかのパッケージ・デフォルトに優先して使用されます。 たとえば、
javax.langとjavax.lang.reflectの両方にパッケージのデフォルトが関連付けられている場合、後者のパッケージのデフォルトはjavax.lang.reflectのクラスに適用されます。パッケージ・デフォルトは、クラス・ローダーのデフォルトのアサーション・ステータスよりも優先されます。ただし、
setClassAssertionStatus(String, boolean)を呼び出すことで、クラス単位でオーバーライドできます。- パラメータ:
packageName- パッケージ・デフォルトのアサーション・ステータスを設定するパッケージ名。null値は、"current" (「Java言語仕様」の7.4.2に関する項を参照してください。)である名前のないパッケージを示しますenabled- このクラス・ローダーによってロードされ、指定されたパッケージまたはそのサブパッケージに属するクラスがデフォルトで有効になっている場合は、true。アサーションがデフォルトで無効になっている場合は、false。- 導入されたバージョン:
- 1.4
-
setClassAssertionStatus
public void setClassAssertionStatus(String className, boolean enabled) このクラス・ローダーの指定されたトップレベル・クラスおよびそこに含まれるネストされたクラス内に対して、目的のアサーション・ステータスを設定します。 この設定は、クラス・ローダーのデフォルトのアサーション・ステータス、およびパッケージ単位で適用可能なデフォルトに優先されます。 指定されたクラスが初期化済みの場合、このメソッドは無効になります (クラスの初期化後にアサーション・ステータスを変更することはできないため)。指定されたクラスがトップ・レベルのクラスではない場合、この呼出しは、どのクラスのアサーション・ステータスに対しても影響を与えません。
- パラメータ:
className- アサーション・ステータスを設定するトップ・レベルのクラスの完全指定クラス名。enabled- (およびif)の初期化時に指定されたクラスでアサーションを有効にする場合はtrue、クラスでアサーションを無効にする場合はfalse。- 導入されたバージョン:
- 1.4
-
clearAssertionStatus
public void clearAssertionStatus()このクラス・ローダーのデフォルトのアサーション・ステータスをfalseに設定し、クラス・ローダーに関連付けられたパッケージ・デフォルトまたはクラス・アサーション・ステータス設定を破棄します。 このメソッドを利用すると、クラス・ローダーがコマンド行または永続的なアサーション・ステータス設定をすべて無視するため、「クリーンな状態で」起動できます。- 導入されたバージョン:
- 1.4
-
defineClass(String, byte[], int, int)に置き換えられます