ClassLoader (Java Platform SE 7)

java.lang.Object
- java.lang.ClassLoader

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

SecureClassLoader
```
public abstract class ClassLoader
extends Object
```
クラスローダーは、クラスのロードを担当するオブジェクトです。ClassLoader クラスは abstract クラスです。クラスのバイナリ名を指定すると、クラスローダーはクラスの定義を構成するデータを見つけるか生成します。一般的な方法としては、名前をファイル名に変換して、ファイルシステムからその名前の「クラスファイル」を読み込みます。
すべての 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™ 言語仕様』で規定されたバイナリ名である必要があります。
次に、有効なクラス名の例を示します。
```
   "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)` 指定された親クラスローダーを使って、委譲のために新しいクラスローダーを作成します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`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™ 仮想マシン仕様』で定義される有効なクラスファイルの形式を持つ
    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™ 仮想マシン仕様』で定義される有効なクラスファイルの形式を持つ
    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™ 仮想マシン仕様』で定義される有効なクラスファイルの形式を持つ
    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); returncl.defineClass(name, temp, 0, temp.length, pd);
    
    パラメータ:
    name - クラスの予想されるバイナリ名。不明な場合は null
    b - クラスデータを構成するバイト。b.position() から b.position() + b.limit() -1 までの位置にある byte は、『Java™ 仮想マシン仕様』で定義される有効なクラスファイルの形式を持つ。
    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™ 言語仕様』の「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) を呼び出します。
    
    パラメータ:
    name - リソース名
    
    戻り値:
    リソースを読み込むための URL。ただし、リソースが見つからなかった場合や、呼び出し側がリソースを取得する適切な特権を持っていない場合は null。
    導入されたバージョン:
    
    1.1
  - getResources
```
public Enumeration<URL> getResources(String name)
                              throws IOException
```
    指定された名前を持つすべてのリソースを検索します。リソースは、クラスコードからコード位置に依存しない方法でアクセス可能なデータ (イメージ、オーディオ、テキストなど) です。
    リソースの名前は、/ で区切られたパス名であり、これによってリソースが識別されます。
    検索順については、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™ 言語仕様』のセクション 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, 2013, 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