javax.management.loading
インタフェース ClassLoaderRepository

public interface ClassLoaderRepository

このインタフェースのインスタンスは、MBean サーバに登録された ClassLoader のリストを保持するために使用されます。これらのインスタンスは、登録済み ClassLoader を使ってクラスをロードするために必要なメソッドを提供します。

ClassLoaderRepository 内の最初の ClassLoader は、常に MBean サーバ固有の ClassLoader です。

ClassLoader のサブクラスになっておらず、PrivateClassLoader インタフェースを実装していない MBean を MBean サーバに登録すると、この MBean は、MBean サーバの ClassLoaderRepository の末尾に追加されます。この MBean の登録を解除すると、ClassLoaderRepository からこの MBean が削除されます。

ClassLoaderRepository 内の MBean の並び順には意味があります。ClassLoaderRepository 内の任意の 2 つの MBean、X と Y について考えてみましょう。Y の登録を開始する前に X の登録が完了していた場合、X は Y の前に並べられます。X と Y が同時に登録された場合、これらの並び順は不確定になります。MBean の登録処理は、MBeanServer.registerMBean(java.lang.Object, javax.management.ObjectName) メソッドの呼び出し、またはいずれかの MBeanServer.createMBean メソッドの呼び出しに相当します。

導入されたバージョン:

1.5

関連項目:

MBeanServerFactory

メソッドの概要

Class	loadClass(String className) クラスローダのリストから、指定された名前のクラスをロードします。
Class	loadClassBefore(ClassLoader stop, String className) クラスローダのリストからクラスをロードし、指定されたクラス名の位置で処理を停止します。
Class	loadClassWithout(ClassLoader exclude, String className) クラスローダのリストから、前回指定された名前のクラス以外のクラスをロードします。

メソッドの詳細

loadClass

Class loadClass(String className)
                throws ClassNotFoundException

クラスローダのリストから、指定された名前のクラスをロードします。ClassLoaderRepository 内の ClassLoader に、ClassLoader.loadClass(String) メソッドを使ってクラスをロードせよという命令が送られます。その結果、正常に Class オブジェクトが返された場合、これがこのメソッドの戻り値になります。ClassNotFoundException がスローされた場合、次の ClassLoader で引き続き検索が行われます。この ClassLoader も例外をスローした場合、このメソッドは例外をスローします。リストの末尾に達した場合、ClassNotFoundException がスローされます。

パラメータ:

className - ロードされるクラスの名前

戻り値:

ロードされたクラス

例外:

ClassNotFoundException - 指定されたクラスが見つからない場合

loadClassWithout

Class loadClassWithout(ClassLoader exclude,
                       String className)
                       throws ClassNotFoundException

クラスローダのリストから、前回指定された名前のクラス以外のクラスをロードします。exclude を除く ClassLoaderRepository 内の ClassLoader に、ClassLoader.loadClass(String) メソッドを使ってクラスをロードせよという命令が送られます。その結果、正常に Class オブジェクトが返された場合、これがこのメソッドの戻り値になります。ClassNotFoundException がスローされた場合、次の ClassLoader で引き続き検索が行われます。この ClassLoader も例外をスローした場合、このメソッドは例外をスローします。リストの末尾に達した場合、ClassNotFoundException がスローされます。

ClassLoaderRepository 内に、このメソッドを loadClass メソッドから呼び出す ClassLoader があるとします。同じ ClassLoaderRepository 内に、この ClassLoader と同時に同じ処理を行う ClassLoader がもう 1 つ存在する場合、どちらかがデッドロックになります。デッドロックを回避するためには、loadClassBefore(java.lang.ClassLoader, java.lang.String) メソッドを使用することをお勧めします。

パラメータ:

className - ロードされるクラスの名前

exclude - 除外されるクラスローダ。null の場合、このメソッドは loadClass(className) と同等

戻り値:

ロードされたクラス

例外:

ClassNotFoundException - 指定されたクラスが見つからない場合

loadClassBefore

Class loadClassBefore(ClassLoader stop,
                      String className)
                      throws ClassNotFoundException

クラスローダのリストからクラスをロードし、指定されたクラス名の位置で処理を停止します。ClassLoaderRepository 内の ClassLoader に、ClassLoader.loadClass(String) メソッドを使ってクラスをロードせよという命令が送られます。その結果、正常に Class オブジェクトが返された場合、これがこのメソッドの戻り値になります。ClassNotFoundException がスローされた場合、次の ClassLoader で引き続き検索が行われます。この ClassLoader も例外をスローした場合、このメソッドは例外をスローします。検索が stop またはリストの末尾に達した場合、ClassNotFoundException がスローされます。

通常、このメソッドは、stop の loadClass メソッドから呼び出されます。これにより、ClassLoaderRepository 内の指定のローダより前のローダを照会することができます。stop に達した時点で検索が終了するので、同時クラスロードによるデッドロックを回避することができます。

パラメータ:

className - ロードされるクラスの名前

stop - クラスローダ。この位置で処理が停止される。null の場合、このメソッドは loadClass(className) と同等

戻り値:

ロードされたクラス

例外:

ClassNotFoundException - 指定されたクラスが見つからない場合