URLClassLoader (Java Platform SE 8)

java.lang.Object
- java.lang.ClassLoader
- - java.security.SecureClassLoader
  - - java.net.URLClassLoader

すべての実装されたインタフェース:

Closeable, AutoCloseable

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

MLet
```
public class URLClassLoader
extends SecureClassLoader
implements Closeable
```
このクラス・ローダーは、JARファイルとディレクトリの両方を参照するURLの検索パスから、クラスとリソースをロードするために使用されます。「/」で終わるURLはすべて、ディレクトリを参照しているとみなされます。それ以外の場合、URLはJARファイルを参照しているとみなされます。JARファイルは必要に応じてオープンされます。
URLClassLoaderのインスタンスを生成したスレッドのAccessControlContextは、そのあとにクラスおよびリソースをロードするときに使われます。
ロードされるクラスには、デフォルトでは、URLClassLoaderの作成時に指定されたURLだけに接続できるアクセス権が与えられます。

導入されたバージョン:

1.2

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

コンストラクタ
コンストラクタと説明
`URLClassLoader(URL[] urls)` 委譲関係の親になっているデフォルトの`ClassLoader`を使って、指定されたURLの新しいURLClassLoaderを構築します。
`URLClassLoader(URL[] urls, ClassLoader parent)` 指定されたURLの新しいURLClassLoaderを構築します。
`URLClassLoader(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)` 指定されたURL、親クラス・ローダー、およびURLStreamHandlerFactoryのための新しいURLClassLoaderを構築します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`protected void`	`addURL(URL url)` 指定されたURLを、クラスおよびリソースを検索するためのURLリストに追加します。
`void`	`close()` このURLClassLoaderを閉じて、このローダーによって定義された新しいクラスやリソースをロードするために使用できなくします。
`protected Package`	`definePackage(String name, Manifest man, URL url)` このClassLoaderで名前を使って新しいパッケージを定義します。
`protected Class<?>`	`findClass(String name)` URL検索パスから、指定された名前を持つクラスを検索してロードします。
`URL`	`findResource(String name)` URL検索パス上で、指定された名前を持つリソースを検索します。
`Enumeration<URL>`	`findResources(String name)` URL検索パス上の指定された名前を持つリソースを表す、URLの列挙を返します。
`protected PermissionCollection`	`getPermissions(CodeSource codesource)` 指定されたcodesourceオブジェクトのアクセス権を返します。
`InputStream`	`getResourceAsStream(String name)` 指定されたリソースを読み込む入力ストリームを返します。
`URL[]`	`getURLs()` クラスおよびリソースをロードするためのURLの検索パスを返します。
`static URLClassLoader`	`newInstance(URL[] urls)` 指定されたURLとデフォルトの親クラス・ローダーに対する、URLClassLoaderの新しいインスタンスを作成します。
`static URLClassLoader`	`newInstance(URL[] urls, ClassLoader parent)` 指定されたURLと親クラス・ローダーに対する、URLClassLoaderの新しいインスタンスを作成します。

クラス java.security.SecureClassLoaderから継承されたメソッド
defineClass, defineClass

クラス java.lang.ClassLoaderから継承されたメソッド
clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - URLClassLoader
```
public URLClassLoader(URL[] urls,
                      ClassLoader parent)
```
    指定されたURLの新しいURLClassLoaderを構築します。URLは、親クラス・ローダー内で検索されたあと、クラスおよびリソースに指定された順で検索されます。「/」で終わるURLはすべて、ディレクトリを参照しているとみなされます。それ以外の場合、URLはJARファイルを参照しているとみなされます。JARファイルは必要に応じてダウンロードおよびオープンされます。
    セキュリティ・マネージャが存在する場合、このクラス・ローダーの作成が許可されるように、このメソッドは最初にセキュリティ・マネージャのcheckCreateClassLoaderメソッドを呼び出します。
    
    パラメータ:
    
    urls - クラスおよびリソースのロード元となるURL
    
    parent - 委譲のための親クラス・ローダー
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckCreateClassLoaderメソッドがクラス・ローダーの作成を許可しない場合。
    
    NullPointerException - urlsがnullである場合。
    
    関連項目:
    
    SecurityManager.checkCreateClassLoader()
  - URLClassLoader
```
public URLClassLoader(URL[] urls)
```
    委譲関係の親になっているデフォルトのClassLoaderを使って、指定されたURLの新しいURLClassLoaderを構築します。URLは、親クラス・ローダー内で検索されたあと、クラスおよびリソースに指定された順で検索されます。「/」で終わるURLはすべて、ディレクトリを参照しているとみなされます。それ以外の場合、URLはJARファイルを参照しているとみなされます。JARファイルは必要に応じてダウンロードおよびオープンされます。
    セキュリティ・マネージャが存在する場合、このクラス・ローダーの作成が許可されるように、このメソッドは最初にセキュリティ・マネージャのcheckCreateClassLoaderメソッドを呼び出します。
    
    パラメータ:
    
    urls - クラスおよびリソースのロード元となるURL
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckCreateClassLoaderメソッドがクラス・ローダーの作成を許可しない場合。
    
    NullPointerException - urlsがnullである場合。
    
    関連項目:
    
    SecurityManager.checkCreateClassLoader()
  - URLClassLoader
```
public URLClassLoader(URL[] urls,
                      ClassLoader parent,
                      URLStreamHandlerFactory factory)
```
    指定されたURL、親クラス・ローダー、およびURLStreamHandlerFactoryのための新しいURLClassLoaderを構築します。parent引数は、委譲用の親クラス・ローダーとして使用されます。factory引数は、新しいJAR URLを作成するときにプロトコル・ハンドラを取得するためのストリーム・ハンドラ・ファクトリとして使用されます。
    セキュリティ・マネージャが存在する場合、このクラス・ローダーの作成が許可されるように、このメソッドは最初にセキュリティ・マネージャのcheckCreateClassLoaderメソッドを呼び出します。
    
    パラメータ:
    
    urls - クラスおよびリソースのロード元となるURL
    
    parent - 委譲のための親クラス・ローダー
    
    factory−URLの作成時に使うURLStreamHandlerFactory
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckCreateClassLoaderメソッドがクラス・ローダーの作成を許可しない場合。
    
    NullPointerException - urlsがnullである場合。
    
    関連項目:
    
    SecurityManager.checkCreateClassLoader()
- メソッドの詳細
  - getResourceAsStream
```
public InputStream getResourceAsStream(String name)
```
    指定されたリソースを読み込む入力ストリームを返します。このローダーが閉じられた場合、このメソッドによって開かれたリソースはすべて閉じられます。
    検索順については、ClassLoader.getResource(String)のドキュメントを参照してください。
    
    オーバーライド:
    
    getResourceAsStream、クラス: ClassLoader
    
    パラメータ:
    
    name - リソース名
    
    戻り値:
    
    リソースを読み込むための入力ストリーム。リソースが見つからなかった場合はnull
    
    導入されたバージョン:
    
    1.7
  - close
```
public void close()
           throws IOException
```
    このURLClassLoaderを閉じて、このローダーによって定義された新しいクラスやリソースをロードするために使用できなくします。委譲階層におけるこのローダーの親が定義しているクラスとリソースには、引き続きアクセス可能です。すでにロード済みのクラスやリソースにも、引き続きアクセス可能です。
    jar: URLおよびfile: URLの場合は、それによって開かれたファイルもすべて閉じられます。closeメソッドが呼び出されたときに別のスレッドがクラスをロード中である場合、そのロードの結果は未定義となります。
    このメソッドは、IOExceptionを内部的にキャッチすることで、開いているすべてのファイルをベスト・エフォートで閉じようとします。非チェック例外とエラーはキャッチされません。すでに閉じられたローダーに対してcloseを呼び出しても何の効果もありません。
    
    定義:
    
    close、インタフェース: Closeable
    
    定義:
    
    close、インタフェース: AutoCloseable
    
    例外:
    
    IOException - 結果がIOExceptionになったこのクラス・ローダーによって開かれたファイルを閉じる場合。こうした例外は内部的にキャッチされます。1つだけがキャッチされた場合、再スローされます。複数の例外がキャッチされた場合、2つ目以降の例外は、キャッチされた最初の例外の抑制された例外として追加され、それが再スローされます。
    
    SecurityException - セキュリティ・マネージャが設定され、それがRuntimePermission(「closeClassLoader」)を拒否した場合
    
    導入されたバージョン:
    
    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)
                         throws IllegalArgumentException
```
    このClassLoaderで名前を使って新しいパッケージを定義します。指定されたマニフェストに含まれる属性は、パッケージのバージョンやシーリング情報を取得するために使用されます。シールされたパッケージの場合、そのパッケージのロード元となったコード・ソースURLを、追加のURLに指定します。
    
    パラメータ:
    
    name - パッケージ名
    
    man−パッケージのバージョン、およびシーリング情報を含むマニフェスト
    
    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の列挙。ローダーが閉じられている場合、列挙は空になります。
    
    例外:
    
    IOException - 入出力例外が発生した場合
  - getPermissions
```
protected PermissionCollection getPermissions(CodeSource codesource)
```
    指定されたcodesourceオブジェクトのアクセス権を返します。このメソッドの実装はまず、super.getPermissionsを呼び出し、次に、codesourceのURLに基づいてアクセス権を追加します。
    このURLのプロトコルが「jar」の場合、許可されるアクセス権は、JARファイルのURLが必要とするアクセス権に基づいたものとなります。
    プロトコルが「file」で、機関コンポーネントが存在する場合、その機関に接続し、機関からの接続を受け入れるアクセス権が付与される場合があります。プロトコルが「file」で、パスとしてファイルが指定されている場合には、そのファイルの読取り権が許可されます。プロトコルが「file」で、パスがディレクトリである場合には、そのディレクトリ内に含まれるすべてのファイルの読取り権と、(再帰的に)すべてのファイルとサブディレクトリの読取り権が、許可されます。
    プロトコルが「file」ではない場合は、URLで指定されたホストに接続し、そのホストからの接続を受け入れるアクセス権が付与されます。
    
    オーバーライド:
    
    getPermissions、クラス: SecureClassLoader
    
    パラメータ:
    
    codesource - コード・ソース
    
    戻り値:
    
    コード・ソースに与えられたアクセス権
    
    例外:
    
    NullPointerException - codesourceがnullである場合。
  - newInstance
```
public static URLClassLoader newInstance(URL[] urls,
                                         ClassLoader parent)
```
    指定されたURLと親クラス・ローダーに対する、URLClassLoaderの新しいインスタンスを作成します。セキュリティ・マネージャがインストールされている場合、このメソッドから返されたURLClassLoaderのloadClassメソッドは、クラスをロードする前にSecurityManager.checkPackageAccessメソッドを呼び出します。
    
    パラメータ:
    
    urls - クラスおよびリソースの検索対象のURL
    
    parent - 委譲のための親クラス・ローダー
    
    戻り値:
    
    結果として得られるクラス・ローダー
    
    例外:
    
    NullPointerException - urlsがnullである場合。
  - newInstance
```
public static URLClassLoader newInstance(URL[] urls)
```
    指定されたURLとデフォルトの親クラス・ローダーに対する、URLClassLoaderの新しいインスタンスを作成します。セキュリティ・マネージャがインストールされている場合、このメソッドから返されたURLClassLoaderのloadClassメソッドは、クラスをロードする前にSecurityManager.checkPackageAccessを呼び出します。
    
    パラメータ:
    
    urls - クラスおよびリソースの検索対象のURL
    
    戻り値:
    
    結果として得られるクラス・ローダー
    
    例外:
    
    NullPointerException - urlsがnullである場合。

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスURLClassLoader

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

メソッドのサマリー

クラス java.security.SecureClassLoaderから継承されたメソッド

クラス java.lang.ClassLoaderから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

URLClassLoader

URLClassLoader

URLClassLoader

メソッドの詳細

getResourceAsStream

close

addURL

getURLs

findClass

definePackage

findResource

findResources

getPermissions

newInstance

newInstance