機械翻訳について

compact1、compact2、compact3

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

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である場合。