java.net

クラス URLClassLoader

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 を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
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 メソッドがクラスローダーの作成を許可しない場合。

関連項目:

SecurityManager.checkCreateClassLoader()

URLClassLoader

public URLClassLoader(URL[] urls)

委譲関係の親になっているデフォルトの ClassLoader を使って、指定された URL の新しい URLClassLoader を構築します。URL は、親クラスローダー内で検索されたあと、クラスおよびリソースに指定された順で検索されます。「/」で終わる URL はすべて、ディレクトリを参照しているとみなされます。それ以外の場合、URL は JAR ファイルを参照しているとみなされます。JAR ファイルは必要に応じてダウンロードおよびオープンされます。

セキュリティーマネージャーが存在する場合、このクラスローダーの作成が許可されるように、このメソッドは最初にセキュリティーマネージャーの checkCreateClassLoader メソッドを呼び出します。

パラメータ:

urls - クラスおよびリソースのロード元となる URL

例外:

SecurityException - セキュリティーマネージャーが存在し、その checkCreateClassLoader メソッドがクラスローダーの作成を許可しない場合。

関連項目:

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 メソッドがクラスローダーの作成を許可しない場合。

関連項目:

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 - クラスが見つからなかった場合。またはローダーが閉じられている場合。

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 - コードソース

戻り値:

コードソースに与えられたアクセス権

newInstance

public static URLClassLoader newInstance(URL[] urls,
                         ClassLoader parent)

指定された URL と親クラスローダーに対する、URLClassLoader の新しいインスタンスを作成します。セキュリティーマネージャーがインストールされている場合、このメソッドから返された URLClassLoader の loadClass メソッドは、クラスをロードする前に SecurityManager.checkPackageAccess メソッドを呼び出します。

パラメータ:

urls - クラスおよびリソースの検索対象の URL

parent - 委譲のための親クラスローダー

戻り値:

結果として得られるクラスローダー

newInstance

public static URLClassLoader newInstance(URL[] urls)

指定された URL とデフォルトの親クラスローダーに対する、URLClassLoader の新しいインスタンスを作成します。セキュリティーマネージャーがインストールされている場合、このメソッドから返された URLClassLoader の loadClass メソッドは、クラスをロードする前に SecurityManager.checkPackageAccess を呼び出します。

パラメータ:

urls - クラスおよびリソースの検索対象の URL

戻り値:

結果として得られるクラスローダー