クラスURLClassLoader

java.lang.Object
java.lang.ClassLoader
java.security.SecureClassLoader
java.net.URLClassLoader
すべての実装されたインタフェース:
Closeable, AutoCloseable
public class URLClassLoader extends SecureClassLoader implements Closeable
このクラス・ローダーは、JARファイルとディレクトリの両方を参照するURLの検索パスから、クラスとリソースをロードするために使用されます。 jar:スキームURL (JarURLConnectionを参照してください)は、JARファイルを参照するものとみなされます。 '/''で終わるfile:スキームURLは、ディレクトリを参照するものとみなされます。 それ以外の場合、URLはJARファイルを参照しているとみなされます。JARファイルは必要に応じてオープンされます。

このクラス・ローダーは、指定されたURLによって参照されるmulti-release JARファイルの内容からのクラスおよびリソースのロードをサポートします。

導入されたバージョン:
1.2

  • コンストラクタの詳細

    • URLClassLoader

      public URLClassLoader(URL[] urls, ClassLoader parent)
      指定されたURLの新しいURLClassLoaderを構築します。 URLは、親クラス・ローダー内で検索されたあと、クラスおよびリソースに指定された順で検索されます。 jar:スキームURLは、JARファイルを参照するものとみなされます。 '/''で終わるfile:スキームURLは、ディレクトリを参照するものとみなされます。 それ以外の場合、URLはJARファイルを参照しているとみなされます。JARファイルは必要に応じてダウンロードおよびオープンされます。
      APIのノート:
      parentがnull (ブートストラップ・クラス・ローダー用)として指定されている場合、すべてのプラットフォーム・クラスが表示される保証はありません。 ブートストラップ・クラス・ローダーおよびその他の組込みクラス・ローダーの詳細は、「ランタイム組込みクラス・ローダー」を参照してください。
      パラメータ:
      urls - クラスおよびリソースのロード元となるURL
      parent - 委任の親クラス・ローダー。ブートストラップ・クラス・ローダーのnullにできます
      スロー:
      NullPointerException - urlsまたはその要素のいずれかがnullであるかどうか。

    • URLClassLoader

      public URLClassLoader(URL[] urls)
      親としてのシステム・クラス・ローダーを使用して、指定されたURLの新しいURLClassLoaderを構築します。 URLは、親クラス・ローダー内で検索されたあと、クラスおよびリソースに指定された順で検索されます。 「/」で終わるURLはすべて、ディレクトリを参照しているとみなされます。 それ以外の場合、URLはJARファイルを参照しているとみなされます。JARファイルは必要に応じてダウンロードおよびオープンされます。
      パラメータ:
      urls - クラスおよびリソースのロード元となるURL
      スロー:
      NullPointerException - urlsまたはその要素のいずれかがnullであるかどうか。

    • URLClassLoader

      public URLClassLoader(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)
      指定されたURL、親クラス・ローダー、およびURLStreamHandlerFactoryのための新しいURLClassLoaderを構築します。 parent引数は、委譲用の親クラス・ローダーとして使用されます。 factory引数は、新しいJAR URLを作成するときにプロトコル・ハンドラを取得するためのストリーム・ハンドラ・ファクトリとして使用されます。
      APIのノート:
      parentがnull (ブートストラップ・クラス・ローダー用)として指定されている場合、すべてのプラットフォーム・クラスが表示される保証はありません。 ブートストラップ・クラス・ローダーおよびその他の組込みクラス・ローダーの詳細は、「ランタイム組込みクラス・ローダー」を参照してください。
      パラメータ:
      urls - クラスおよびリソースのロード元となるURL
      parent - 委任の親クラス・ローダー。ブートストラップ・クラス・ローダーのnullにできます
      factory−URLの作成時に使うURLStreamHandlerFactory
      スロー:
      NullPointerException - urlsまたはその要素のいずれかがnullであるかどうか。

    • URLClassLoader

      public URLClassLoader(String name, URL[] urls, ClassLoader parent)
      指定されたURLの新しい名前URLClassLoaderを構築します。 URLは、親クラス・ローダー内で検索されたあと、クラスおよびリソースに指定された順で検索されます。 「/」で終わるURLはすべて、ディレクトリを参照しているとみなされます。 それ以外の場合、URLはJARファイルを参照しているとみなされます。JARファイルは必要に応じてダウンロードおよびオープンされます。
      APIのノート:
      parentがnull (ブートストラップ・クラス・ローダー用)として指定されている場合、すべてのプラットフォーム・クラスが表示される保証はありません。 ブートストラップ・クラス・ローダーおよびその他の組込みクラス・ローダーの詳細は、「ランタイム組込みクラス・ローダー」を参照してください。
      パラメータ:
      name - クラス・ローダー名; 名前が付けられていない場合はnull
      urls - クラスおよびリソースのロード元となるURL
      parent - 委任の親クラス・ローダー。ブートストラップ・クラス・ローダーのnullにできます
      スロー:
      IllegalArgumentException - 指定された名前が空の場合。
      NullPointerException - urlsまたはその要素のいずれかがnullであるかどうか。
      導入されたバージョン:
      9

    • URLClassLoader

      public URLClassLoader(String name, URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)
      指定されたURL、親クラス・ローダーおよびURLStreamHandlerFactoryの新しい名前付きURLClassLoaderを構築します。 parent引数は、委譲用の親クラス・ローダーとして使用されます。 factory引数は、新しいJAR URLを作成するときにプロトコル・ハンドラを取得するためのストリーム・ハンドラ・ファクトリとして使用されます。
      APIのノート:
      parentがnull (ブートストラップ・クラス・ローダー用)として指定されている場合、すべてのプラットフォーム・クラスが表示される保証はありません。 ブートストラップ・クラス・ローダーおよびその他の組込みクラス・ローダーの詳細は、「ランタイム組込みクラス・ローダー」を参照してください。
      パラメータ:
      name - クラス・ローダー名; 名前が付けられていない場合はnull
      urls - クラスおよびリソースのロード元となるURL
      parent - 委任の親クラス・ローダー。ブートストラップ・クラス・ローダーのnullにできます
      factory−URLの作成時に使うURLStreamHandlerFactory
      スロー:
      IllegalArgumentException - 指定された名前が空の場合。
      NullPointerException - urlsまたはその要素のいずれかがnullであるかどうか。
      導入されたバージョン:
      9

  • メソッドの詳細

    • getResourceAsStream

      public InputStream getResourceAsStream(String name)
      指定されたリソースを読み込む入力ストリームを返します。 このローダーが閉じられた場合、このメソッドによって開かれたリソースはすべて閉じられます。

      検索順については、ClassLoader.getResource(String)のドキュメントを参照してください。

      オーバーライド:
      getResourceAsStream、クラスClassLoader
      パラメータ:
      name - リソース名
      戻り値:
      リソースを読み込むための入力ストリーム。リソースが見つからなかった場合はnull
      スロー:
      NullPointerException - nameがnullである場合
      導入されたバージョン:
      1.7

    • close

      public void close() throws IOException
      このURLClassLoaderを閉じて、このローダーによって定義された新しいクラスやリソースをロードするために使用できなくします。 委譲階層におけるこのローダーの親が定義しているクラスとリソースには、引き続きアクセス可能です。 すでにロード済みのクラスやリソースにも、引き続きアクセス可能です。

      jar: URLおよびfile: URLの場合は、それによって開かれたファイルもすべて閉じられます。 closeメソッドが呼び出されたときに別のスレッドがクラスをロード中である場合、そのロードの結果は未定義となります。

      このメソッドは、IOExceptionを内部的にキャッチすることで、開いているすべてのファイルをベスト・エフォートで閉じようとします。 非チェック例外とエラーはキャッチされません。 すでに閉じられたローダーに対してcloseを呼び出しても何の効果もありません。

      定義:
      close、インタフェースAutoCloseable
      定義:
      close、インタフェースCloseable
      スロー:
      IOException - 結果がIOExceptionになったこのクラス・ローダーによって開かれたファイルを閉じる場合。 こうした例外は内部的にキャッチされます。 1つだけがキャッチされた場合、再スローされます。 複数の例外がキャッチされた場合、2つ目以降の例外は、キャッチされた最初の例外の抑制された例外として追加され、それが再スローされます。
      導入されたバージョン:
      1.7

    • addURL

      protected void addURL(URL url)
      指定されたURLを、クラスおよびリソースを検索するためのURLリストに追加します。

      指定されたURLが、nullであるか、URLのリストにすでに含まれている場合、または、このローダーが閉じられている場合、このメソッドを呼び出しても何の効果もありません。

      パラメータ:
      url - URLの検索パスに追加するURL

    • getURLs

      public URL[] getURLs()
      クラスおよびリソースをロードするためのURLの検索パスを返します。 これには、コンストラクタに指定されたURLの元のリストと、あとでaddURL()メソッドによって追加されたURLも含まれます。
      戻り値:
      クラスおよびリソースをロードするためのURLの検索パス。

    • findClass

      protected Class<?> findClass(String name) throws ClassNotFoundException
      URL検索パスから、指定された名前を持つクラスを検索してロードします。 JARファイルを参照しているURLはすべて、クラスが見つかるまで必要に応じてロードおよびオープンされます。
      オーバーライド:
      findClass、クラスClassLoader
      パラメータ:
      name−クラスの名前
      戻り値:
      結果として得られるクラス
      スロー:
      ClassNotFoundException - クラスが見つからなかった場合。またはローダーが閉じられている場合。
      NullPointerException - nameがnullの場合。

    • definePackage

      protected Package definePackage(String name, Manifest man, URL url)
      このURLClassLoaderに新しいパッケージを名前で定義します。 指定されたManifestに含まれる属性は、パッケージ・バージョンおよびシール情報の取得に使用されます。 シールされたパッケージの場合、そのパッケージのロード元となったコード・ソースURLを、追加のURLに指定します。
      パラメータ:
      name - パッケージ名
      man - Manifestパッケージのバージョンと封印情報を含む
      url−パッケージのコード・ソースURL。ない場合はnull
      戻り値:
      新しく定義されたPackageオブジェクト
      スロー:
      IllegalArgumentException - パッケージ名がこのクラス・ローダーによってすでに定義されている場合

    • findResource

      public URL findResource(String name)
      URL検索パス上で、指定された名前を持つリソースを検索します。
      オーバーライド:
      findResource、クラスClassLoader
      パラメータ:
      name−リソースの名前
      戻り値:
      リソースのURL。リソースが見つからなかった場合、またはローダーが閉じられている場合はnull。

    • findResources

      public Enumeration<URL> findResources(String name) throws IOException
      URL検索パス上の指定された名前を持つリソースを表す、URLの列挙を返します。
      オーバーライド:
      findResources、クラスClassLoader
      パラメータ:
      name - リソース名
      戻り値:
      URLのEnumeration。 ローダーが閉じている場合、Enumerationには要素は含まれません。
      スロー:
      IOException - 入出力例外が発生した場合

    • getPermissions

      protected PermissionCollection getPermissions(CodeSource codesource)
      「権限コレクションが空です」を返します。
      オーバーライド:
      getPermissions、クラスSecureClassLoader
      パラメータ:
      codesource - the CodeSource
      戻り値:
      an 「権限コレクションが空です」
      スロー:
      NullPointerException - codesourceがnullである場合。

    • newInstance

      public static URLClassLoader newInstance(URL[] urls, ClassLoader parent)
      指定されたURLと親クラス・ローダーに対する、URLClassLoaderの新しいインスタンスを作成します。
      パラメータ:
      urls - クラスおよびリソースの検索対象のURL
      parent - 委譲のための親クラス・ローダー
      戻り値:
      結果として得られるクラス・ローダー
      スロー:
      NullPointerException - urlsまたはその要素のいずれかがnullであるかどうか。

    • newInstance

      public static URLClassLoader newInstance(URL[] urls)
      指定されたURLとデフォルトの親クラス・ローダーに対する、URLClassLoaderの新しいインスタンスを作成します。
      パラメータ:
      urls - クラスおよびリソースの検索対象のURL
      戻り値:
      結果として得られるクラス・ローダー
      スロー:
      NullPointerException - urlsまたはその要素のいずれかがnullであるかどうか。