モジュール java.management
パッケージ 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で引き続き検索が行われます。 それがさらに別の例外をスローした場合、このメソッドは例外をスローします。 リストの末尾に達した場合、ClassNotFoundExceptionがスローされます。

      パラメータ:
      className - ロードされるクラスの名前。
      戻り値:
      ロードされたクラス。
      例外:
      ClassNotFoundException - 指定されたクラスが見つからない場合。

    • loadClassWithout

      Class<?> loadClassWithout​(ClassLoader exclude, String className) throws ClassNotFoundException

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

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

      パラメータ:
      className - ロードされるクラスの名前。
      stop - クラス・ローダー。この位置で処理が停止される。 nullの場合、このメソッドはloadClass(className)と等価になる。
      戻り値:
      ロードされたクラス。
      例外:
      ClassNotFoundException - 指定されたクラスが見つからない場合。