ClassLoader (Java Platform SE 8)

java.lang.Object
- java.lang.ClassLoader

直系の既知のサブクラス:

SecureClassLoader
```
public abstract class ClassLoader
extends Object
```
クラス・ローダーは、クラスのロードを担当するオブジェクトです。ClassLoaderクラスは抽象クラスです。クラスのバイナリ名を指定すると、クラス・ローダーはクラスの定義を構成するデータを見つけるか生成します。一般的な方法としては、名前をファイル名に変換して、ファイル・システムからその名前の「クラス・ファイル」を読み込みます。
すべてのClassオブジェクトには、それを定義したClassLoaderへの参照が含まれています。
配列クラスのClassオブジェクトは、クラス・ローダーによっては作成されず、Java Runtimeの要求に応じて自動的に作成されます。配列クラスのクラス・ローダー(Class.getClassLoader()から返される)は、その要素の型のクラス・ローダーと同じになります。要素の型がプリミティブ型の場合、配列クラスはクラス・ローダーを持ちません。
アプリケーションは、Java仮想マシンが動的にクラスをロードするように拡張するために、ClassLoaderのサブクラスを実装します。
クラス・ローダーは一般的に、セキュリティ・マネージャがセキュリティ・ドメインを示すために使われます。
ClassLoaderクラスは、委譲モデルを使ってクラスとリソースを探します。ClassLoaderの各インスタンスは、関連する親クラス・ローダーを持ちます。クラスまたはリソースを見つけるために呼び出されると、ClassLoaderインスタンスはそれ自体でクラスまたはリソースの検索を試みる前に、その検索を親クラスに委譲します。「ブートストラップ・クラス・ローダー」と呼ばれる仮想マシンの組込みクラス・ローダーはそれ自体では親を持たず、ClassLoaderインスタンスの親として動作します。
クラスの並行ロードをサポートするクラス・ローダーは並行可能なクラス・ローダーと呼ばれ、そのクラス初期化時にClassLoader.registerAsParallelCapableメソッドを呼び出して自身を登録する必要があります。ClassLoaderクラスはデフォルトで並行可能として登録されます。ただしそのサブクラスについては、並行可能な場合には自身を登録する必要があります。
委譲モデルが厳密に階層化されていない環境では、クラス・ローダーは並行可能である必要があります。そうでないと、クラス・ロード・プロセス中にローダーのロックが保持されるため、クラス・ロード時にデッドロックが発生する可能性があります(loadClassメソッドを参照)。
通常、Java仮想マシンは、プラットフォームに依存しない方法でローカル・ファイル・システムからクラスをロードします。たとえば、UNIXシステムでは仮想マシンは、CLASSPATH環境変数によって定義されたディレクトリからクラスをロードします。
ただし、ファイルから作成できないクラスもあります。このようなクラスは、ネットワークなどのほかのソースから作成したり、アプリケーションが構築したりします。defineClassメソッドは、バイトの配列をClassクラスのインスタンスに変換します。この新しく定義されたクラスのインスタンスを作成するには、Class.newInstanceを使用します。
クラス・ローダーで作成したオブジェクトのメソッドとコンストラクタは、ほかのクラスを参照できます。参照するクラスを判定するために、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(tm)言語仕様』で規定されたバイナリ名である必要があります。
次に、有効なクラス名の例を示します。
```
   "java.lang.String"
   "javax.swing.JSpinner$DefaultEditor"
   "java.security.KeyStore$Builder$FileBuilder$1"
   "java.net.URLClassLoader$3$1"
 
```
導入されたバージョン:

1.0

関連項目:

resolveClass(Class)

コンストラクタのサマリー

コンストラクタ
修飾子	コンストラクタと説明
`protected`	`ClassLoader()` `getSystemClassLoader()`メソッドから返された`ClassLoader`を親クラス・ローダーとして使用し、新しいクラス・ローダーを作成します。
`protected`	`ClassLoader(ClassLoader parent)` 指定された親クラス・ローダーを使って、委譲のために新しいクラス・ローダーを作成します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`void`	`clearAssertionStatus()` このクラス・ローダーのデフォルトのアサーション・ステータスを`false`に設定し、クラス・ローダーに関連付けられたパッケージ・デフォルトまたはクラスのアサーション・ステータス設定をすべて破棄します。
`protected Class<?>`	`defineClass(byte[] b, int off, int len)` 非推奨。 `defineClass(String, byte[], int, int)`に置き換えられています。
`protected Class<?>`	`defineClass(String name, byte[] b, int off, int len)` バイトの配列を`Class`クラスのインスタンスに変換します。
`protected Class<?>`	`defineClass(String name, byte[] b, int off, int len, ProtectionDomain protectionDomain)` オプションの`ProtectionDomain`を使って、バイトの配列を`Class`クラスのインスタンスに変換します。
`protected Class<?>`	`defineClass(String name, ByteBuffer b, ProtectionDomain protectionDomain)` オプションの`ProtectionDomain`を使って、`ByteBuffer`をクラス`Class`のインスタンスに変換します。
`protected Package`	`definePackage(String name, String specTitle, String specVersion, String specVendor, String implTitle, String implVersion, String implVendor, URL sealBase)` この`ClassLoader`で名前を使ってパッケージを定義します。
`protected Class<?>`	`findClass(String name)` 指定されたバイナリ名を持つクラスを探します。
`protected String`	`findLibrary(String libname)` ネイティブ・ライブラリの絶対パス名を返します。
`protected Class<?>`	`findLoadedClass(String name)` このローダーがこのバイナリ名を持つクラスの起動ローダーとしてJava仮想マシンにより記録されていた場合は、指定されたバイナリ名を持つクラスを返します。
`protected URL`	`findResource(String name)` 指定された名前を持つリソースを検索します。
`protected Enumeration<URL>`	`findResources(String name)` 指定された名前を持つすべてのリソースを表す`URL`オブジェクトの列挙を返します。
`protected Class<?>`	`findSystemClass(String name)` 指定されたバイナリ名を持つクラスを探して、必要に応じてロードします。
`protected Object`	`getClassLoadingLock(String className)` クラス・ロード操作用のロック・オブジェクトを返します。
`protected Package`	`getPackage(String name)` このクラス・ローダーかその祖先のどれかによって定義された`Package`を返します。
`protected Package[]`	`getPackages()` このクラス・ローダーとその祖先によって定義されたすべての`Package`を返します。
`ClassLoader`	`getParent()` 委譲のための親クラス・ローダーを返します。
`URL`	`getResource(String name)` 指定された名前を持つリソースを検索します。
`InputStream`	`getResourceAsStream(String name)` 指定されたリソースを読み込む入力ストリームを返します。
`Enumeration<URL>`	`getResources(String name)` 指定された名前を持つすべてのリソースを検索します。
`static ClassLoader`	`getSystemClassLoader()` 委譲のためのシステム・クラス・ローダーを返します。
`static URL`	`getSystemResource(String name)` クラスをロードするために使用される検索パスから、指定された名前のリソースを探します。
`static InputStream`	`getSystemResourceAsStream(String name)` クラスをロードするのに使用される検索パスから、指定された名前のリソースを、読込み用にオープンします。
`static Enumeration<URL>`	`getSystemResources(String name)` クラスをロードするために使用される検索パスから、指定された名前のすべてのリソースを探します。
`Class<?>`	`loadClass(String name)` 指定されたバイナリ名を持つクラスをロードします。
`protected Class<?>`	`loadClass(String name, boolean resolve)` 指定されたバイナリ名を持つクラスをロードします。
`protected static boolean`	`registerAsParallelCapable()` 呼出し元を並行可能として登録します。
`protected void`	`resolveClass(Class<?> c)` 指定されたクラスをリンクします。
`void`	`setClassAssertionStatus(String className, boolean enabled)` このクラス・ローダーの指定されたトップレベル・クラスおよびそこに含まれるネストされたクラス内に対して、目的のアサーション・ステータスを設定します。
`void`	`setDefaultAssertionStatus(boolean enabled)` このクラス・ローダーのデフォルトのアサーション・ステータスを設定します。
`void`	`setPackageAssertionStatus(String packageName, boolean enabled)` 指定されたパッケージ・デフォルトのアサーション・ステータスを設定します。
`protected void`	`setSigners(Class<?> c, Object[] signers)` クラスの署名者を設定します。

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

- コンストラクタの詳細
  - ClassLoader
```
protected ClassLoader(ClassLoader parent)
```
    指定された親クラス・ローダーを使って、委譲のために新しいクラス・ローダーを作成します。
    セキュリティ・マネージャがある場合はそのcheckCreateClassLoaderメソッドが呼び出されます。これはセキュリティ例外となる場合があります。
    
    パラメータ:
    
    parent - 親クラス・ローダー
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckCreateClassLoaderメソッドが新しいクラス・ローダーの作成を許可しない場合
    
    導入されたバージョン:
    
    1.2
  - ClassLoader
```
protected ClassLoader()
```
    getSystemClassLoader()メソッドから返されたClassLoaderを親クラス・ローダーとして使用し、新しいクラス・ローダーを作成します。
    セキュリティ・マネージャがある場合はそのcheckCreateClassLoaderメソッドが呼び出されます。これはセキュリティ例外となる場合があります。
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckCreateClassLoaderメソッドが新しいクラス・ローダーの作成を許可しない場合
- メソッドの詳細
  - 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
```
    指定されたバイナリ名を持つクラスをロードします。このメソッドのデフォルト実装では、次の順序でクラスを検索します。
    1. クラスがすでにロードされていないかチェックするためにfindLoadedClass(String)を呼び出す。
    2. 親クラス・ローダーでloadClassメソッドを呼び出す。親がnullの場合、仮想マシンに組み込まれたクラス・ローダーが代わりに使用される。
    3. findClass(String)メソッドを呼び出してクラスを探す。
    上記の手順でクラスが見つかった場合、resolveフラグがtrueのときには、このメソッドは見つかったClassオブジェクトに対してresolveClass(Class)メソッドを呼び出します。
    ClassLoaderのサブクラスでは、このメソッドではなくfindClass(String)をオーバーライドすることをお薦めします。
    
    このメソッドは、オーバーライドされないかぎり、クラスのロード処理中に、getClassLoadingLockメソッドの結果に対して同期を行います。
    パラメータ:
    
    name - クラスのバイナリ名
    
    resolve - trueの場合は、クラスを解決する
    
    戻り値:
    
    結果として得られるClassオブジェクト
    
    例外:
    
    ClassNotFoundException - クラスが見つからなかった場合
  - getClassLoadingLock
```
protected Object getClassLoadingLock(String className)
```
    クラス・ロード操作用のロック・オブジェクトを返します。下位互換性のため、このメソッドのデフォルト実装は次のように動作します。このClassLoaderオブジェクトが並行可能として登録されている場合、このメソッドは、指定されたクラス名に関連付けられた専用オブジェクトを返します。それ以外の場合、メソッドはこのClassLoaderオブジェクトを返します。
    
    パラメータ:
    
    className - ロードするクラスの名前
    
    戻り値:
    
    クラス・ロード処理用のロック
    
    例外:
    
    NullPointerException - 並行可能として登録されていて、classNameがnullの場合
    
    導入されたバージョン:
    
    1.7
    
    関連項目:
    
    loadClass(String, boolean)
  - findClass
```
protected Class<?> findClass(String name)
                      throws ClassNotFoundException
```
    指定されたバイナリ名を持つクラスを探します。このメソッドは、クラスをロードするための委譲モデルに準拠するクラス・ローダー実装によってオーバーライドされ、必要なクラスの親クラス・ローダーのチェック後にloadClassメソッドによって呼び出されます。デフォルトの実装はClassNotFoundExceptionをスローします。
    
    パラメータ:
    
    name - クラスのバイナリ名
    
    戻り値:
    
    結果として得られるClassオブジェクト
    
    例外:
    
    ClassNotFoundException - クラスが見つからなかった場合
    
    導入されたバージョン:
    
    1.2
  - defineClass
```
@Deprecated
protected final Class<?> defineClass(byte[] b,
                                                 int off,
                                                 int len)
                                          throws ClassFormatError
```
    非推奨。defineClass(String, byte[], int, int)に置き換えられています。
    
    バイトの配列をClassクラスのインスタンスに変換します。最初にClassを解決してからでなければ、それを使用することはできません。このメソッドは非推奨です。バイナリ名を最初の引数として取るバージョンの方が安全であるため、そのバージョンを使用するようにしてください。
    
    パラメータ:
    
    b - クラス・データを構成するバイト。offからoff+len-1までの位置にあるbyteは、『Java(tm)仮想マシン仕様』で定義される有効なクラス・ファイルの形式を持つ
    
    off - クラス・データのb内での開始オフセット
    
    len - クラス・データの長さ
    
    戻り値:
    
    指定されたクラス・データから作成されたClassオブジェクト
    
    例外:
    
    ClassFormatError - データが有効なクラスを含まなかった場合
    
    IndexOutOfBoundsException - offまたはlenが負の場合、またはoff+lenがb.lengthより大きい場合
    
    SecurityException - このクラスとは異なる一連の証明書で署名されたクラスを含むパッケージにこのクラスを追加しようとした場合、または「java.」で始まる完全指定名を持つパッケージ内でクラスを定義しようとした場合。
    
    関連項目:
    
    loadClass(String, boolean), resolveClass(Class)
  - defineClass
```
protected final Class<?> defineClass(String name,
                                     byte[] b,
                                     int off,
                                     int len)
                              throws ClassFormatError
```
    バイトの配列をClassクラスのインスタンスに変換します。最初にClassを解決してからでなければ、それを使用することはできません。
    このメソッドは、新しく定義されたクラスにデフォルトのProtectionDomainを割り当てます。ProtectionDomainには事実上、Policy.getPolicy().getPermissions(new CodeSource(null, null))の呼出し時に返されるのと同じアクセス権のセットが付与されます。デフォルト・ドメインは、defineClassの初回呼出し時に作成され、以降の呼出し時には再利用されます。
    特定のProtectionDomainをクラスに割り当てるには、ProtectionDomainをその引数の1つとしてとるdefineClassメソッドを使用します。
    
    パラメータ:
    
    name - クラスの予想されるバイナリ名。不明な場合はnull
    
    b - クラス・データを構成するバイト。offからoff+len-1までの位置にあるbyteは、『Java(tm)仮想マシン仕様』で定義される有効なクラス・ファイルの形式を持つ
    
    off - クラス・データのb内での開始オフセット
    
    len - クラス・データの長さ
    
    戻り値:
    
    指定されたクラス・データから作成されたClassオブジェクト。
    
    例外:
    
    ClassFormatError - データが有効なクラスを含まなかった場合
    
    IndexOutOfBoundsException - offまたはlenが負の場合、またはoff+lenがb.lengthより大きい場合
    
    SecurityException - このクラス(未署名)とは異なる証明書セットを使って署名されたクラスを含むパッケージに、このクラスを追加しようとした場合、またはnameが「java.」で始まる場合。
    
    導入されたバージョン:
    
    1.1
    
    関連項目:
    
    loadClass(String, boolean), resolveClass(Class), CodeSource, SecureClassLoader
  - defineClass
```
protected final Class<?> defineClass(String name,
                                     byte[] b,
                                     int off,
                                     int len,
                                     ProtectionDomain protectionDomain)
                              throws ClassFormatError
```
    オプションのProtectionDomainを使って、バイトの配列をClassクラスのインスタンスに変換します。ドメインがnullの場合、defineClass(String, byte[], int, int)のドキュメントで指定されているように、デフォルト・ドメインがクラスに割り当てられます。最初にクラスを解決してからでなければ、クラスを使用することはできません。
    パッケージで定義される最初のクラスにより、そのパッケージ内で続いて定義されたすべてのクラスに必要な、証明書の正確なセットが決まります。クラスの証明書のセットは、そのクラスのProtectionDomain内のCodeSourceから取得します。そのパッケージに追加されたクラスには同一の証明書のセットが含まれている必要があり、含まれていない場合はSecurityExceptionがスローされます。nameがnullの場合、この判別は実行されません。必ず、定義するクラスのバイナリ名をバイトとともに渡すようにしてください。このようにして渡すと、定義するクラスは実際に考えたとおりのクラスになります。
    「java.*」パッケージのすべてのクラスはブートストラップ・クラス・ローダーでしか定義できないので、「java.」で始まるnameを指定することはできません。nameがnullでない場合、それは、バイト配列「b」で指定されるクラスのバイナリ名に等しくなる必要があります。それ以外の場合は、NoClassDefFoundErrorがスローされます。
    
    パラメータ:
    
    name - クラスの予想されるバイナリ名。不明な場合はnull
    
    b - クラス・データを構成するバイト。offからoff+len-1までの位置にあるbyteは、『Java(tm)仮想マシン仕様』で定義される有効なクラス・ファイルの形式を持つ
    
    off - クラス・データのb内での開始オフセット
    
    len - クラス・データの長さ
    
    protectionDomain - このクラスのProtectionDomain
    
    戻り値:
    
    データから作成されたClassオブジェクトと、オプションのProtectionDomain。
    
    例外:
    
    ClassFormatError - データが有効なクラスを含まなかった場合
    
    NoClassDefFoundError - nameが、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のインスタンスに変換します。ドメインが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); return cl.defineClass(name, temp, 0, temp.length, pd);
    
    パラメータ:
    
    name - クラスの予想されるバイナリ名。不明な場合はnull
    
    b - クラス・データを構成するバイト。b.position()からb.position()+b.limit() -1までの位置にあるbyteは、『Java(tm)仮想マシン仕様』で定義される有効なクラス・ファイルの形式を持つ。
    
    protectionDomain - このクラスのProtectionDomain、またはnull。
    
    戻り値:
    
    データから作成されたClassオブジェクトと、オプションのProtectionDomain。
    
    例外:
    
    ClassFormatError - データが有効なクラスを含まなかった場合。
    
    NoClassDefFoundError - nameが、bで指定されたクラスのバイナリ名に等しくない場合
    
    SecurityException - このクラスとは異なる証明書セットを使って署名されたクラスを含むパッケージに、このクラスを追加しようとする場合、またはnameが「java.」で始まる場合。
    
    導入されたバージョン:
    
    1.5
    
    関連項目:
    
    defineClass(String, byte[], int, int, ProtectionDomain)
  - resolveClass
```
protected final void resolveClass(Class<?> c)
```
    指定されたクラスをリンクします。クラス・ローダーはこのメソッドを使って、クラスをリンクします。cクラスがすでにリンクされている場合、このメソッドは単に復帰します。そうでない場合、『Java(tm)言語仕様』の「Execution」の章で説明しているように、クラスはリンクされます。
    
    パラメータ:
    
    c - リンクするクラス
    
    例外:
    
    NullPointerException - cがnullの場合。
    
    関連項目:
    
    defineClass(String, byte[], int, int)
  - findSystemClass
```
protected final Class<?> findSystemClass(String name)
                                  throws ClassNotFoundException
```
    指定されたバイナリ名を持つクラスを探して、必要に応じてロードします。
    このメソッドはシステム・クラス・ローダー(getSystemClassLoader()を参照)を使ってそのクラスをロードします。返されるClassオブジェクトは、そのオブジェクトに関連付けられたClassLoaderを1つ以上持つ場合があります。ClassLoaderのサブクラスでは通常、このメソッドを呼び出す必要はありません。これは、ほとんどのクラス・ローダーではfindClass(String)だけをオーバーライドすればよいからです。
    
    パラメータ:
    
    name - クラスのバイナリ名
    
    戻り値:
    
    指定されたnameのClassオブジェクト
    
    例外:
    
    ClassNotFoundException - クラスが見つからなかった場合
    
    関連項目:
    
    ClassLoader(ClassLoader), getParent()
  - findLoadedClass
```
protected final Class<?> findLoadedClass(String name)
```
    このローダーがこのバイナリ名を持つクラスの起動ローダーとしてJava仮想マシンにより記録されていた場合は、指定されたバイナリ名を持つクラスを返します。それ以外の場合はnullを返します。
    
    パラメータ:
    
    name - クラスのバイナリ名
    
    戻り値:
    
    Classオブジェクト。クラスがロードされていない場合はnull
    
    導入されたバージョン:
    
    1.1
  - setSigners
```
protected final void setSigners(Class<?> c,
                                Object[] signers)
```
    クラスの署名者を設定します。このメソッドは、クラスの定義後に呼び出す必要があります。
    
    パラメータ:
    
    c - Classオブジェクト
    
    signers - クラスの署名者
    
    導入されたバージョン:
    
    1.1
  - getResource
```
public URL getResource(String name)
```
    指定された名前を持つリソースを検索します。リソースは、クラス・コードからコード位置に依存しない方法でアクセス可能なデータ(イメージ、オーディオ、テキストなど)です。
    リソースの名前は、「/」で区切られたパス名であり、これによってリソースが識別されます。
    このメソッドは、まずリソースの親クラス・ローダーを検索します。親がnullの場合、仮想マシンに組み込まれたクラス・ローダーのパスが検索されます。それに失敗すると、このメソッドはリソースを見つけるためにfindResource(String)を呼び出します。
    
    APIの注:
    
    このメソッドをオーバーライドするときは、実装によっていずれかの委譲がgetResources(String)メソッドと確実に一致するようになることをお薦めします。
    
    パラメータ:
    
    name - リソース名
    
    戻り値:
    
    リソースを読み込むためのURL。ただし、リソースが見つからなかった場合や、呼出し側がリソースを取得する適切な特権を持っていない場合はnull。
    
    導入されたバージョン:
    
    1.1
  - getResources
```
public Enumeration<URL> getResources(String name)
                              throws IOException
```
    指定された名前を持つすべてのリソースを検索します。リソースは、クラス・コードからコード位置に依存しない方法でアクセス可能なデータ(イメージ、オーディオ、テキストなど)です。
    リソースの名前は、/で区切られたパス名であり、これによってリソースが識別されます。
    検索順については、getResource(String)のドキュメントを参照してください。
    
    APIの注:
    
    このメソッドをオーバーライドするときは、実装によっていずれかの委譲がgetResource(String)メソッドと確実に一致するようになることをお薦めします。これにより、列挙のnextElementメソッドから返される最初の要素が必ず、getResource(String)メソッドが返すリソースと同じものになるはずです。
    
    パラメータ:
    
    name - リソース名
    
    戻り値:
    
    リソースのURLオブジェクトの列挙。リソースが見つからなかった場合、列挙は空になる。クラス・ローダーがアクセスできないリソースは列挙に入らない
    
    例外:
    
    IOException - 入出力エラーが発生した場合
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    findResources(String)
  - findResource
```
protected URL findResource(String name)
```
    指定された名前を持つリソースを検索します。クラス・ローダーの実装は、リソースを検索する場所を指定するためにこのメソッドをオーバーライドします。
    
    パラメータ:
    
    name - リソース名
    
    戻り値:
    
    リソースを読み込むためのURLオブジェクト。リソースが見つからなかった場合はnull
    
    導入されたバージョン:
    
    1.2
  - findResources
```
protected Enumeration<URL> findResources(String name)
                                  throws IOException
```
    指定された名前を持つすべてのリソースを表すURLオブジェクトの列挙を返します。クラス・ローダーの実装は、リソースのロード元を特定するためにこのメソッドをオーバーライドします。
    
    パラメータ:
    
    name - リソース名
    
    戻り値:
    
    リソースのURLオブジェクトの列挙
    
    例外:
    
    IOException - 入出力エラーが発生した場合
    
    導入されたバージョン:
    
    1.2
  - registerAsParallelCapable
```
protected static boolean registerAsParallelCapable()
```
    呼出し元を並行可能として登録します。登録が成功するのは、次の条件をすべて満たす場合だけです。
    1. 呼出し元のインスタンスが1つも作成されていない
    2. 呼出し元のすべてのスーパー・クラス(Objectクラスは除く)が並行可能として登録されている
    いったんクラス・ローダーを並行可能として登録すると、それを元に戻す方法はありません。
    戻り値:
    
    呼出し元が並行可能として正常に登録された場合はtrue、それ以外の場合はfalse。
    
    導入されたバージョン:
    
    1.7
  - getSystemResource
```
public static URL getSystemResource(String name)
```
    クラスをロードするために使用される検索パスから、指定された名前のリソースを探します。このメソッドはシステム・クラス・ローダー(getSystemClassLoader()を参照)を使ってリソースを見つけます。
    
    パラメータ:
    
    name - リソース名
    
    戻り値:
    
    リソースを読み込むためのURLオブジェクト。リソースが見つからなかった場合はnull
    
    導入されたバージョン:
    
    1.1
  - getSystemResources
```
public static Enumeration<URL> getSystemResources(String name)
                                           throws IOException
```
    クラスをロードするために使用される検索パスから、指定された名前のすべてのリソースを探します。見つかったリソースは、URLオブジェクトのEnumerationとして返されます。
    検索順については、getSystemResource(String)のドキュメントを参照してください。
    
    パラメータ:
    
    name - リソース名
    
    戻り値:
    
    リソースURLオブジェクトの列挙
    
    例外:
    
    IOException - 入出力エラーが発生した場合
    
    導入されたバージョン:
    
    1.2
  - getResourceAsStream
```
public InputStream getResourceAsStream(String name)
```
    指定されたリソースを読み込む入力ストリームを返します。
    検索順については、getResource(String)のドキュメントを参照してください。
    
    パラメータ:
    
    name - リソース名
    
    戻り値:
    
    リソースを読み込むための入力ストリーム。リソースが見つからなかった場合はnull
    
    導入されたバージョン:
    
    1.1
  - getSystemResourceAsStream
```
public static InputStream getSystemResourceAsStream(String name)
```
    クラスをロードするのに使用される検索パスから、指定された名前のリソースを、読込み用にオープンします。このメソッドはシステム・クラス・ローダー(getSystemClassLoader()を参照)を使ってリソースを見つけます。
    
    パラメータ:
    
    name - リソース名
    
    戻り値:
    
    リソースを読み込むための入力ストリーム。リソースが見つからなかった場合はnull
    
    導入されたバージョン:
    
    1.1
  - getParent
```
public final ClassLoader getParent()
```
    委譲のための親クラス・ローダーを返します。実装によっては、nullを使ってブートストラップ・クラス・ローダーを表すこともできます。このメソッドは、このクラス・ローダーの親がブートストラップ・クラス・ローダーの場合に、そのような実装でnullを返します。
    セキュリティ・マネージャが存在する場合、呼出し側のクラス・ローダーがnullでなく、このクラス・ローダーの祖先でもない場合は、このメソッドはRuntimePermission("getClassLoader")アクセス権を使ってセキュリティ・マネージャのcheckPermissionメソッドを呼び出すことによって、親クラス・ローダーへのアクセスが許可されていることを確認します。そうでない場合は、SecurityExceptionがスローされます。
    
    戻り値:
    
    親のClassLoader
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckPermissionメソッドがこのクラス・ローダーの親クラス・ローダーへのアクセスを許可しない場合。
    
    導入されたバージョン:
    
    1.2
  - getSystemClassLoader
```
public static ClassLoader getSystemClassLoader()
```
    委譲のためのシステム・クラス・ローダーを返します。これは、新しいClassLoaderインスタンスのデフォルトの委譲の親で、通常、アプリケーションを起動するためのクラス・ローダーです。
    このメソッドが最初に呼び出されるのは、実行時の起動シーケンスの初期です。この時点で、メソッドはシステム・クラス・ローダーを作成し、呼び出すThreadのコンテキスト・クラス・ローダーにそれを設定します。
    デフォルトのシステム・クラス・ローダーは、このクラスの実装依存インスタンスです。
    このメソッドの最初の呼出し時に、システム・プロパティ「java.system.class.loader」が定義される場合、このプロパティの値がシステム・クラス・ローダーとして返されるクラスの名前になります。このクラスは、デフォルトのシステム・クラス・ローダーを使用してロードされます。また、このクラスは、委譲の親として使用される、ClassLoader型の単一のパラメータを取るpublicコンストラクタを定義する必要があります。次に、このコンストラクタを使用し、デフォルトのシステム・クラス・ローダーをパラメータに指定して、インスタンスが作成されます。結果として得られるクラス・ローダーは、システム・クラス・ローダーとして定義されます。
    セキュリティ・マネージャが存在し、呼出し元のクラス・ローダーがnullでなく、かつ呼出し元のクラス・ローダーがシステム・クラス・ローダーと同じでもその祖先でもない場合、このメソッドは、セキュリティ・マネージャのcheckPermissionメソッドをRuntimePermission("getClassLoader")アクセス権で呼び出すことで、システム・クラス・ローダーへのアクセスを確認します。そうでない場合は、SecurityExceptionがスローされます。
    
    戻り値:
    
    委譲のためのシステムClassLoader。ない場合はnull
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckPermissionメソッドがこのシステム・クラス・ローダーへのアクセスを許可しない場合。
    
    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)
                         throws IllegalArgumentException
```
    このClassLoaderで名前を使ってパッケージを定義します。これにより、クラス・ローダーはそのクラスのパッケージを定義します。クラスを定義する前に、パッケージを作成する必要があります。パッケージ名については、クラス・ローダー内で一意とし、作成後の再定義や変更はできません。
    
    パラメータ:
    
    name - パッケージ名
    
    specTitle - 仕様のタイトル
    
    specVersion - 仕様のバージョン
    
    specVendor - 仕様のベンダー
    
    implTitle - 実装のタイトル
    
    implVersion - 実装のバージョン
    
    implVendor - 実装のベンダー
    
    sealBase - nullでない場合、このパッケージは指定されたコード・ソースURLオブジェクトに対してシールされる。そうでない場合、パッケージはシールされない
    
    戻り値:
    
    新しく定義されたPackageオブジェクト
    
    例外:
    
    IllegalArgumentException - パッケージ名が、このクラス・ローダーかまたはその祖先の1つに存在するパッケージと重複する場合
    
    導入されたバージョン:
    
    1.2
  - getPackage
```
protected Package getPackage(String name)
```
    このクラス・ローダーかその祖先のどれかによって定義されたPackageを返します。
    
    パラメータ:
    
    name - パッケージ名
    
    戻り値:
    
    指定された名前に対応するPackage。見つからない場合はnull
    
    導入されたバージョン:
    
    1.2
  - getPackages
```
protected Package[] getPackages()
```
    このクラス・ローダーとその祖先によって定義されたすべてのPackageを返します。
    
    戻り値:
    
    このClassLoaderによって定義されたPackageオブジェクトの配列
    
    導入されたバージョン:
    
    1.2
  - findLibrary
```
protected String findLibrary(String libname)
```
    ネイティブ・ライブラリの絶対パス名を返します。VMは、このメソッドを呼び出して、このクラス・ローダーによってロードされたクラスのネイティブ・ライブラリを検索します。このメソッドがnullを返す場合、VMは「java.library.path」プロパティで指定されたパスに従ってライブラリを検索します。
    
    パラメータ:
    
    libname - ライブラリ名
    
    戻り値:
    
    ネイティブ・ライブラリの絶対パス
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    System.loadLibrary(String), System.mapLibraryName(String)
  - 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値は「カレント」である無名パッケージを示す(『Java(tm)言語仕様』のセクション7.4.2を参照。)
    
    enabled - このクラス・ローダーによりロードされ、指定されたパッケージまたはそのサブパッケージのどれかに属するクラスが、デフォルトで有効なアサーションを保持する場合はtrue、デフォルトで無効なアサーションを保持する場合はfalse。
    
    導入されたバージョン:
    
    1.4
  - setClassAssertionStatus
```
public void setClassAssertionStatus(String className,
                                    boolean enabled)
```
    このクラス・ローダーの指定されたトップレベル・クラスおよびそこに含まれるネストされたクラス内に対して、目的のアサーション・ステータスを設定します。この設定は、クラス・ローダーのデフォルトのアサーション・ステータス、およびパッケージ単位で適用可能なデフォルトに優先されます。指定されたクラスが初期化済みの場合、このメソッドは無効になります(クラスの初期化後にアサーション・ステータスを変更することはできないため)。
    指定されたクラスがトップ・レベルのクラスではない場合、この呼出しは、どのクラスのアサーション・ステータスに対しても影響を与えません。
    
    パラメータ:
    
    className - アサーション・ステータスを設定するトップ・レベルのクラスの完全指定クラス名。
    
    enabled - 初期化時に、指定されたクラスでアサーションを有効にする場合はtrue、アサーションを無効にする場合はfalse。
    
    導入されたバージョン:
    
    1.4
  - clearAssertionStatus
```
public void clearAssertionStatus()
```
    このクラス・ローダーのデフォルトのアサーション・ステータスをfalseに設定し、クラス・ローダーに関連付けられたパッケージ・デフォルトまたはクラスのアサーション・ステータス設定をすべて破棄します。このメソッドを利用すると、クラス・ローダーがコマンド行または永続的なアサーション・ステータス設定をすべて無視するため、「クリーンな状態で」起動できます。
    
    導入されたバージョン:
    
    1.4

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

クラスClassLoader

バイナリ名

コンストラクタのサマリー

メソッドのサマリー

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

コンストラクタの詳細

ClassLoader

ClassLoader

メソッドの詳細

loadClass

loadClass

getClassLoadingLock

findClass

defineClass

defineClass

defineClass

defineClass

resolveClass

findSystemClass

findLoadedClass

setSigners

getResource

getResources

findResource

findResources

registerAsParallelCapable

getSystemResource

getSystemResources

getResourceAsStream

getSystemResourceAsStream

getParent

getSystemClassLoader

definePackage

getPackage

getPackages

findLibrary

setDefaultAssertionStatus

setPackageAssertionStatus

setClassAssertionStatus

clearAssertionStatus