モジュール java.management
パッケージ javax.management.loading

クラスMLet

java.lang.Object
java.lang.ClassLoader
java.security.SecureClassLoader
java.net.URLClassLoader
javax.management.loading.MLet
すべての実装されたインタフェース:
Closeable, Externalizable, Serializable, AutoCloseable, MLetMBean, MBeanRegistration
直系の既知のサブクラス:
PrivateMLet
@Deprecated(since="20", forRemoval=true) public class MLet extends URLClassLoader implements MLetMBean, MBeanRegistration, Externalizable
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
このAPIは、管理アプレット(m-lets)の一部です。これは、リモートMBeansをロードできるレガシー機能です。 この機能は、非推奨であり、将来のリリースで削除される予定であるSecurity Managerなしでは使用できません。 その結果、このAPIも非推奨となり、削除される可能性があります。 これに替わる機能はありません。
リモートURLから着信したMBeanサーバー内のMBean (複数可)をインスタンス化し、登録することができます。 m-letは管理アプレットのショートカットです。 m-letサービスは、取得するMBeanの情報を指定するm-letテキスト・ファイルをロードすることにより、MBeanの処理を行います。 各MBeanの情報は、単一のタグ・インスタンス(MLETタグ)で指定します。 m-letテキスト・ファイルの位置はURLで指定します。

MLETタグの構文は次のとおりです。

<MLET
CODE = class | OBJECT = serfile
ARCHIVE = "archiveList"
[CODEBASE = codebaseURL]
[NAME = mbeanname]
[VERSION = version]
>
[arglist]
</MLET>

以下にそれぞれの意味を示します。

CODE = クラス
取得するMBeanのパッケージ名を含む完全Javaクラス名を指定する属性です。 ARCHIVE属性で指定された.jarファイルのうちいずれかに、MBeanのコンパイル済み.classファイルが含まれている必要があります。 CODEかOBJECTのいずれかが存在している必要があります。
OBJECT = serfile
取得するMBeanの直列化表現を含む.serファイルを指定する属性です。 このファイルは、ARCHIVE属性で指定された.jarファイルのうちいずれかに含まれている必要があります。 .jarファイルにディレクトリ階層が含まれる場合は、この階層内のファイル・パスを指定します。 そうしないと、一致は見つかりません。 CODEかOBJECTのいずれかが存在している必要があります。
ARCHIVE = "archiveList"
取得するMBeanによって使用されるMBeanまたはその他のリソースを含む1個以上の.jarファイルを指定する必須属性です。 .jarファイルのうちいずれかに、CODEまたはOBJECT属性で指定されたファイルが含まれている必要があります。 アーカイブ・リストに複数のファイルが含まれる場合、次の条件が必要になります。
  • 各ファイルがカンマ(,)で区切られていること。
  • archivelistが二重引用符で囲まれていること。
archivelist内のすべての.jarファイルが、コード・ベースURLで指定されたディレクトリに格納されている必要があります。
CODEBASE = codebaseURL
取得するMBeanのコード・ベースURLを指定するオプション属性です。 ARCHIVE属性で指定された.jarファイルを含むディレクトリを識別します。 この属性を指定するのは、.jarファイルがm-letテキスト・ファイルと同じディレクトリにない場合のみです。 この属性が指定されていない場合、m-letテキスト・ファイルのベースURLが使用されます。
NAME = mbeanname
MBeanインスタンスをm-letサービスに登録するとき、このMBeanインスタンスに割り当てるオブジェクト名を指定するオプション属性です。 mbeanname の先頭がコロン文字(:)である場合、オブジェクト名のドメイン部分はMBeanServer.getDefaultDomain()によって返されるMBeanサーバーのデフォルト・ドメインになります。
VERSION = version
取得するMBeanと関連.jarファイルのバージョン番号を指定するオプション属性です。 バージョン番号を使用すると、m-letテキスト・ファイルの次回ロード時に、サーバーから.jarファイルをロードして、キャッシュ内にローカルに格納されているファイルを更新することができます。versionには、0以上の複数の10進整数をピリオドで区切って指定します。
arglist
インスタンス化するMBeanのパラメータ(複数可)のリストを指定するオプション属性です。 リストに含まれるのは、MBeanのコンストラクタに渡されるパラメータです。 arglist内の各項目は、次の構文を使って指定します。
<ARG TYPE=argumentType VALUE=値>
以下にそれぞれの意味を示します。
  • argumentTypeは、MBeanのコンストラクタにパラメータとして渡される引数の型です。

引数リスト内に指定する引数の型は、Javaプリミティブ型かJava基本型であるべきです(java.lang.Boolean, java.lang.Byte, java.lang.Short, java.lang.Long, java.lang.Integer, java.lang.Float, java.lang.Double, java.lang.String)。

m-letテキスト・ファイルをロードすると、ファイルに指定された各MBeanのインスタンスが作成され、登録されます。

m-letサービスは、java.net.URLClassLoaderを拡張します。このサービスを使って、エージェントのVM内のリモート・クラスおよびjarファイルをロードできます。

ノート - MLetクラス・ローダーは、MBeanServerFactory.getClassLoaderRepository(javax.management.MBeanServer)を使って、ロードされたjarファイル内に見つからないクラスをロードします。

導入されたバージョン:
1.5
関連項目:

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

    コンストラクタ
    コンストラクタ
    説明
    MLet()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    委譲関係の親になっているデフォルトのClassLoaderを使って、新しいMLetを構築します。
    MLet(URL[] urls)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    委譲関係の親になっているデフォルトのClassLoaderを使って、指定されたURLの新しいMLetを構築します。
    MLet(URL[] urls, boolean delegateToCLR)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    委譲関係の親になっているデフォルトのClassLoaderを使って、指定されたURLの新しいMLetを構築します。
    MLet(URL[] urls, ClassLoader parent)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたURLの新しいMLetを構築します。
    MLet(URL[] urls, ClassLoader parent, boolean delegateToCLR)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたURLの新しいMLetを構築します。
    MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたURL、親クラス・ローダー、およびURLStreamHandlerFactoryの新しいMLetを構築します。
    MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory, boolean delegateToCLR)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたURL、親クラス・ローダー、およびURLStreamHandlerFactoryの新しいMLetを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    addURL(String url)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたURLを、クラスおよびリソースを検索するためのURLリストに追加します。
    void
    addURL(URL url)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたURLを、クラスおよびリソースを検索するためのURLリストに追加します。
    protected URL
    check(String version, URL codebase, String jarfile, MLetContent mlet)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このメソッドは、キャッシュ機能とバージョン管理機能をサポートするためにこのサービスを拡張するときオーバーライドされます。
    protected Class<?>
    findClass(String name)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    再定義予定のクラス・ローダーのmainメソッドです。
    protected String
    findLibrary(String libname)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    ネイティブ・ライブラリの絶対パス名を返します。
    String
    getLibraryDirectory()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    ネイティブ・ライブラリをメモリーにロードする前に格納するライブラリ・ローダーによって現在使用されているディレクトリを取得します。
    Set<Object>
    getMBeansFromURL(String url)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    MBeanサーバーに追加されるMBeanを定義するMLETタグを含むテキスト・ファイルをロードします。
    Set<Object>
    getMBeansFromURL(URL url)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    MBeanサーバーに追加されるMBeanを定義するMLETタグを含むテキスト・ファイルをロードします。
    URL[]
    getURLs()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    クラスおよびリソースをロードするためのURLの検索パスを返します。
    Class<?>
    loadClass(String name, ClassLoaderRepository clr)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このMLetのURLでクラスが見つからない場合、指定されたClassLoaderRepositoryを使ってクラスをロードします。
    void
    postDeregister()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    MBeanサーバーから登録解除したあと、m-letが必要なオペレーションを実行できるようにします。
    void
    postRegister(Boolean registrationDone)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    MBeanサーバーへの登録が成功または失敗したあと、m-letが必要なオペレーションを実行できるようにします。
    void
    preDeregister()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    MBeanサーバーから登録解除する前に、m-letが必要なオペレーションを実行できるようにします。
    ObjectName
    preRegister(MBeanServer server, ObjectName name)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    MBeanサーバーに登録される前に必要なオペレーションをm-letが実行することを許可します。
    void
    readExternal(ObjectInput in)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    特定のObjectInputからこのMLetの内容を復元します。
    void
    setLibraryDirectory(String libdir)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    ネイティブ・ライブラリをメモリーにロードする前に格納するライブラリ・ローダーによって使用されるディレクトリを設定します。
    void
    writeExternal(ObjectOutput out)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このMLetの内容を特定のObjectOutputに保存します。

    クラスjava.net.URLClassLoaderで宣言されたメソッド

    close, definePackage, findResource, findResources, getPermissions, getResourceAsStream, newInstance, newInstance

    クラスjava.security.SecureClassLoaderで宣言されたメソッド

    defineClass, defineClass

    クラスjava.lang.ClassLoaderで宣言されたメソッド

    clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLoadedClass, findResource, findSystemClass, getClassLoadingLock, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, loadClass, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

    クラスjava.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    インタフェースjavax.management.loading.MLetMBeanで宣言されたメソッド

    getResource, getResourceAsStream, getResources

  • コンストラクタの詳細

    • MLet

      public MLet()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      委譲関係の親になっているデフォルトのClassLoaderを使って、新しいMLetを構築します。

    • MLet

      public MLet(URL[] urls)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      委譲関係の親になっているデフォルトのClassLoaderを使って、指定されたURLの新しいMLetを構築します。 URLは、親クラス・ローダー内で検索されたあと、クラスおよびリソースに指定された順で検索されます。
      パラメータ:
      urls - クラスおよびリソースのロード元となるURL。

    • MLet

      public MLet(URL[] urls, ClassLoader parent)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定されたURLの新しいMLetを構築します。 URLは、親クラス・ローダー内で検索されたあと、クラスおよびリソースに指定された順で検索されます。 parent引数は、委譲用の親クラス・ローダーとして使用されます。
      パラメータ:
      urls - クラスおよびリソースのロード元となるURL。
      parent - 委譲用の親クラス・ローダー。

    • MLet

      public MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定されたURL、親クラス・ローダー、およびURLStreamHandlerFactoryの新しいMLetを構築します。 parent引数は、委譲用の親クラス・ローダーとして使用されます。 factory引数は、新しいURLを作成するときにプロトコル・ハンドラを取得するためのストリーム・ハンドラ・ファクトリとして使用されます。
      パラメータ:
      urls - クラスおよびリソースのロード元となるURL。
      parent - 委譲用の親クラス・ローダー。
      factory - URLの作成時に使用するURLStreamHandlerFactory。

    • MLet

      public MLet(URL[] urls, boolean delegateToCLR)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      委譲関係の親になっているデフォルトのClassLoaderを使って、指定されたURLの新しいMLetを構築します。 URLは、親クラス・ローダー内で検索されたあと、クラスおよびリソースに指定された順で検索されます。
      パラメータ:
      urls - クラスおよびリソースのロード元となるURL。
      delegateToCLR - 親ClassLoaderでもURLでもクラスが見つからず、MLetがMBeanServerのClassLoaderRepositoryへ処理を委譲する必要がある場合はtrue。

    • MLet

      public MLet(URL[] urls, ClassLoader parent, boolean delegateToCLR)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定されたURLの新しいMLetを構築します。 URLは、親クラス・ローダー内で検索されたあと、クラスおよびリソースに指定された順で検索されます。 parent引数は、委譲用の親クラス・ローダーとして使用されます。
      パラメータ:
      urls - クラスおよびリソースのロード元となるURL。
      parent - 委譲用の親クラス・ローダー。
      delegateToCLR - 親ClassLoaderでもURLでもクラスが見つからず、MLetがMBeanServerのClassLoaderRepositoryへ処理を委譲する必要がある場合はtrue。

    • MLet

      public MLet(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory, boolean delegateToCLR)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定されたURL、親クラス・ローダー、およびURLStreamHandlerFactoryの新しいMLetを構築します。 parent引数は、委譲用の親クラス・ローダーとして使用されます。 factory引数は、新しいURLを作成するときにプロトコル・ハンドラを取得するためのストリーム・ハンドラ・ファクトリとして使用されます。
      パラメータ:
      urls - クラスおよびリソースのロード元となるURL。
      parent - 委譲用の親クラス・ローダー。
      factory - URLの作成時に使用するURLStreamHandlerFactory。
      delegateToCLR - 親ClassLoaderでもURLでもクラスが見つからず、MLetがMBeanServerのClassLoaderRepositoryへ処理を委譲する必要がある場合はtrue。

  • メソッドの詳細

    • addURL

      public void addURL(URL url)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定されたURLを、クラスおよびリソースを検索するためのURLリストに追加します。
      定義:
      addURL、インタフェースMLetMBean
      オーバーライド:
      addURL、クラスURLClassLoader
      パラメータ:
      url - URLの検索パスに追加するURL

    • addURL

      public void addURL(String url) throws ServiceNotFoundException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定されたURLを、クラスおよびリソースを検索するためのURLリストに追加します。
      定義:
      addURL、インタフェースMLetMBean
      パラメータ:
      url - 追加するURL
      スロー:
      ServiceNotFoundException - 異常な形式のURLが指定された場合。

    • getURLs

      public URL[] getURLs()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      クラスおよびリソースをロードするためのURLの検索パスを返します。 これには、コンストラクタに指定されたURLの元のリストと、あとでaddURL()メソッドによって追加されたURLも含まれます。
      定義:
      getURLs、インタフェースMLetMBean
      オーバーライド:
      getURLs、クラスURLClassLoader
      戻り値:
      クラスおよびリソースをロードするためのURLの検索パス。

    • getMBeansFromURL

      public Set<Object> getMBeansFromURL(URL url) throws ServiceNotFoundException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      MBeanサーバーに追加されるMBeanを定義するMLETタグを含むテキスト・ファイルをロードします。 このテキスト・ファイルの場所は、URLで指定されます。 MLETファイルに指定されたMBeanは、MBeanサーバーでインスタンス化され、登録されます。
      定義:
      getMBeansFromURL、インタフェースMLetMBean
      パラメータ:
      url - ロードされるテキスト・ファイルのURLに相当するURLオブジェクト。
      戻り値:
      ロードされたm-letテキスト・ファイル内のMLETタグごとに1つのエントリを含むセット。 各エントリは、作成されたMBeanのObjectInstance指定する。または、MBeanを作成できなかった場合は、スロー可能なオブジェクト(エラーまたは例外)を指定する。
      スロー:
      ServiceNotFoundException - m-letテキスト・ファイルにMLETタグが含まれていない場合、m-letテキスト・ファイルが見つからない場合、MLETタグの必須属性が指定されていない場合、またはurlの値がnullである場合。
      IllegalStateException - MLet MBeanがMBeanServerに登録されていない場合。

    • getMBeansFromURL

      public Set<Object> getMBeansFromURL(String url) throws ServiceNotFoundException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      MBeanサーバーに追加されるMBeanを定義するMLETタグを含むテキスト・ファイルをロードします。 このテキスト・ファイルの場所は、URLで指定されます。 MLETファイルに指定されたMBeanは、MBeanサーバーでインスタンス化され、登録されます。
      定義:
      getMBeansFromURL、インタフェースMLetMBean
      パラメータ:
      url - ロードされるテキスト・ファイルのURLに相当するStringオブジェクト。
      戻り値:
      ロードされたm-letテキスト・ファイル内のMLETタグごとに1つのエントリを含むセット。 各エントリは、作成されたMBeanのObjectInstance指定する。または、MBeanを作成できなかった場合は、スロー可能なオブジェクト(エラーまたは例外)を指定する。
      スロー:
      ServiceNotFoundException - 次のエラーのいずれかが発生しました。m-letテキスト・ファイルにMLETタグが含まれていない場合、m-letテキスト・ファイルが見つからない場合、MLETタグの必須属性が指定されていない場合、またはurlの形式が異常である場合。
      IllegalStateException - MLet MBeanがMBeanServerに登録されていない場合。

    • getLibraryDirectory

      public String getLibraryDirectory()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      ネイティブ・ライブラリをメモリーにロードする前に格納するライブラリ・ローダーによって現在使用されているディレクトリを取得します。
      定義:
      getLibraryDirectory、インタフェースMLetMBean
      戻り値:
      ライブラリ・ローダーによって現在使用されているディレクトリ。
      スロー:
      UnsupportedOperationException - この実装がネイティブ・ライブラリのこの格納方法をサポートしない場合。
      関連項目:

    • setLibraryDirectory

      public void setLibraryDirectory(String libdir)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      ネイティブ・ライブラリをメモリーにロードする前に格納するライブラリ・ローダーによって使用されるディレクトリを設定します。
      定義:
      setLibraryDirectory、インタフェースMLetMBean
      パラメータ:
      libdir - ライブラリ・ローダーによって使用されるディレクトリ。
      スロー:
      UnsupportedOperationException - この実装がネイティブ・ライブラリのこの格納方法をサポートしない場合。
      関連項目:

    • preRegister

      public ObjectName preRegister(MBeanServer server, ObjectName name) throws Exception
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      MBeanサーバーに登録される前に必要なオペレーションをm-letが実行することを許可します。 ObjectNameがnullの場合、m-letはデフォルトの名前<defaultDomain:type=MLet>を使って登録されます。
      定義:
      preRegister、インタフェースMBeanRegistration
      パラメータ:
      server - MBeanサーバー。m-letはここに登録される。
      name - m-letのオブジェクト名。
      戻り値:
      登録されたm-letの名前。
      スロー:
      Exception - この例外は、MBeanサーバーにキャッチされ、MBeanRegistrationExceptionとして再スローされる。

    • postRegister

      public void postRegister(Boolean registrationDone)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      MBeanサーバーへの登録が成功または失敗したあと、m-letが必要なオペレーションを実行できるようにします。
      定義:
      postRegister、インタフェースMBeanRegistration
      パラメータ:
      registrationDone - m-letがMBeanサーバーに正常に登録されたかどうかを示す。 登録に失敗した場合の値はfalse。

    • preDeregister

      public void preDeregister() throws Exception
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      MBeanサーバーから登録解除する前に、m-letが必要なオペレーションを実行できるようにします。
      定義:
      preDeregister、インタフェースMBeanRegistration
      スロー:
      Exception - この例外は、MBeanサーバーにキャッチされ、MBeanRegistrationExceptionとして再スローされる。

    • postDeregister

      public void postDeregister()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      MBeanサーバーから登録解除したあと、m-letが必要なオペレーションを実行できるようにします。
      定義:
      postDeregister、インタフェースMBeanRegistration

    • writeExternal

      public void writeExternal(ObjectOutput out) throws IOException, UnsupportedOperationException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

      このMLetの内容を特定のObjectOutputに保存します。 このメソッドは、すべての実装でサポートされるわけではありません。 そうでないものはUnsupportedOperationExceptionをスローします。 このメソッドをサポートする場合、またはデータの書込み形式を変更する場合は、サブクラスでこのメソッドをオーバーライドします。

      書き込まれるデータの形式は指定されていませんが、実装がwriteExternal(java.io.ObjectOutput)をサポートする場合、それはreadExternal(java.io.ObjectInput)も、前者によって書き込まれた内容を後者が読み取れるような方法でサポートする必要があります。

      定義:
      writeExternal、インタフェースExternalizable
      パラメータ:
      out - 書込み先のオブジェクト出力ストリーム。
      スロー:
      IOException - 書込み中に問題が発生した場合。
      UnsupportedOperationException - この実装がこの操作をサポートしていない場合。

    • readExternal

      public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException, UnsupportedOperationException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

      特定のObjectInputからこのMLetの内容を復元します。 このメソッドは、すべての実装でサポートされるわけではありません。 そうでないものはUnsupportedOperationExceptionをスローします。 このメソッドをサポートする場合、またはデータの読取り形式を変更する場合は、サブクラスでこのメソッドをオーバーライドします。

      読み取られるデータの形式は指定されていませんが、実装がreadExternal(java.io.ObjectInput)をサポートする場合、それはwriteExternal(java.io.ObjectOutput)も、後者によって書き込まれた内容を前者が読み取れる方法でサポートする必要があります。

      定義:
      readExternal、インタフェースExternalizable
      パラメータ:
      in - 読込み元のオブジェクト入力ストリーム。
      スロー:
      IOException - 読取り中に問題が発生した場合。
      ClassNotFoundException - 復元されているオブジェクトのクラスが見つからない場合。
      UnsupportedOperationException - この実装がこの操作をサポートしていない場合。

    • loadClass

      public Class<?> loadClass(String name, ClassLoaderRepository clr) throws ClassNotFoundException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

      このMLetのURLでクラスが見つからない場合、指定されたClassLoaderRepositoryを使ってクラスをロードします。 ClassLoaderRepositoryがnullの場合、このMLetのURL内にクラスが見つからないと、ただちにClassNotFoundExceptionがスローされます。

      パラメータ:
      name - ロード対象クラスの名前。
      clr - このClassLoader内に指定のクラスが見つからない場合に使用されるClassLoaderRepository。 nullも可。
      戻り値:
      結果として得られるClassオブジェクト。
      スロー:
      ClassNotFoundException - このClassLoader内にも指定のClassLoaderRepository内にも指定のクラスが見つからない場合。

    • findClass

      protected Class<?> findClass(String name) throws ClassNotFoundException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      再定義予定のクラス・ローダーのmainメソッドです。
      オーバーライド:
      findClass、クラスURLClassLoader
      パラメータ:
      name - クラスの名前。
      戻り値:
      結果として得られるClassオブジェクト。
      スロー:
      ClassNotFoundException - 指定されたクラスが見つからない場合。

    • findLibrary

      protected String findLibrary(String libname)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      ネイティブ・ライブラリの絶対パス名を返します。 VMは、このメソッドを呼び出して、このクラス・ローダーによってロードされたクラスのネイティブ・ライブラリを検索します。 最初は、ネイティブ・ライブラリ名のみを使って、JARファイル内が検索されます。ネイティブ・ライブラリ名が見つからない場合は、ネイティブ・ライブラリ名とアーキテクチャ固有のパス名(OSName/OSArch/OSVersion/lib/nativelibname)で検索が行われます。

      JARファイル内でSolaris SPARC 5.7のライブラリのステータスを検索するとき:

      1. libstat.so
      2. SunOS/sparc/5.7/lib/libstat.so
      JARファイル内でWindows NT 4.0のライブラリのステータスを検索するとき:
      1. stat.dll
      2. WindowsNT/x86/4.0/lib/stat.dll

      具体的には、nativelibnameをSystem.mapLibraryName(libname)の結果にします。 その後、JARファイル内で次の名前が次の順番で検索されます。
      nativelibname
      <os.name>/<os.arch>/<os.version>/lib/nativelibname
      ここで、<X>は、System.getProperty(X)から含まれる空白を削除したもので、/はファイル区切り文字(File.separator)を表します。

      このメソッドの戻り値がnull (このクラス・ローダーでロードされたJARファイル内にライブラリが見つからない)の場合、VMは、java.library.pathプロパティとして指定されたパスを付加してライブラリを検索します。

      オーバーライド:
      findLibrary、クラスClassLoader
      パラメータ:
      libname - ライブラリ名。
      戻り値:
      ネイティブ・ライブラリの絶対パス。
      関連項目:

    • check

      protected URL check(String version, URL codebase, String jarfile, MLetContent mlet) throws Exception
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

      このメソッドは、キャッシュ機能とバージョン管理機能をサポートするためにこのサービスを拡張するときオーバーライドされます。 MLetファイルからバージョン、コード・ベース、およびjarファイルが抽出されるとgetMBeansFromURLから呼び出され、指定のMBeanをロードしても問題がないかを確認したり、指定のURLを別のURLで置き換えるために使用されます。

      このメソッドのデフォルト実装は、未変更のcodebaseを返します。

      パラメータ:
      version - ローカルに格納された.jarファイルのバージョン番号。
      codebase - リモート.jarファイルのベースURL。
      jarfile - ロードされる.jarファイルの名前。
      mlet - MLETタグを示すMLetContentインスタンス。
      戻り値:
      ロードされたMBeanによって使用されるコード・ベース。 戻り値はnull以外。
      スロー:
      Exception - 何らかの原因でMBeanがロードされなかった場合。 この例外は、getMBeansFromURLによって返されたセットに追加される。