java.net
クラス URLClassLoader

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

public class URLClassLoader

extends SecureClassLoader

このクラスローダは、JAR ファイルおよびディレクトリの両方を参照する URL の検索パスから、クラスおよびリソースをダウンロードするために使います。「/」で終わる URL は、ディレクトリを参照していると見なされます。その他の URL は、必要に応じて開かれる JAR ファイルを参照していると見なされます。

URLClassLoader のインスタンスを生成したスレッドの AccessControlContext は、そのあとにクラスおよびリソースをロードするときに使われます。

ロードされるクラスには、デフォルトでは、URLClassLoader の作成時に指定された URL だけに接続できるアクセス権が与えられます。

導入されたバージョン:

JDK1.2

コンストラクタの概要

URLClassLoader(URL[] urls)
指定された URL の新しい URLClassLoader を、デフォルトの委譲の親である ClassLoader を使って構築します。

URLClassLoader(URL[] urls, ClassLoader parent)
指定された URL の新しい URLClassLoader を構築します。

URLClassLoader(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)
指定された URL、親クラスローダ、および URLStreamHandlerFactory のための、新しい URLClassLoader を構築します。

メソッドの概要

protected void	addURL(URL url) 指定された URL を、クラスおよびリソースを検索するための URL リストに追加します。
protected Package	definePackage(String name, Manifest man, URL url) 新しいパッケージを、この ClassLoader で名前を指定して定義します。
protected Class	findClass(String name) URL 検索パスから、指定された名前を持つクラスを検索してロードします。
URL	findResource(String name) URL 検索パスに指定された名前を使って、リソースを検索します。
Enumeration	findResources(String name) URL 検索パス上の指定された名前を持つリソースを表す、URL の列挙を返します。
protected PermissionCollection	getPermissions(CodeSource codesource) 指定された codesource オブジェクトへのアクセス権を返します。
URL[]	getURLs() クラスおよびリソースをロードするための URL の検索パスを返します。
static URLClassLoader	newInstance(URL[] urls) 指定された URL、およびデフォルトの親クラスローダについて、URLClassLoader の新しいインスタンスを作成します。
static URLClassLoader	newInstance(URL[] urls, ClassLoader parent) 指定された URL、および親クラスローダについて、URLClassLoader の新しいインスタンスを作成します。

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

defineClass

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

defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getPackage, getPackages, getParent, getResource, getResourceAsStream, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, loadClass, resolveClass, 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 ファイルを参照していると見なされます。

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

パラメータ:

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

parent - 委譲に使う親クラスローダ

例外:

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

関連項目:

SecurityManager.checkCreateClassLoader()

URLClassLoader

public URLClassLoader(URL[] urls)

指定された URL の新しい URLClassLoader を、デフォルトの委譲の親である ClassLoader を使って構築します。この URL は、親クラスローダで最初に検索されたあとに、クラスおよびリソースに指定された順序で検索されます。「/」で終わる URL は、ディレクトリを参照していると見なされます。その他の URL は、必要に応じてダウンロードして開かれる、JAR ファイルを参照していると見なされます。

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

パラメータ:

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

例外:

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

関連項目:

SecurityManager.checkCreateClassLoader()

URLClassLoader

public URLClassLoader(URL[] urls,
                      ClassLoader parent,
                      URLStreamHandlerFactory factory)

指定された URL、親クラスローダ、および URLStreamHandlerFactory のための、新しい URLClassLoader を構築します。parent 引数は、委譲のための親クラスローダとして使われます。factory 引数は、新しい URL を作成するときにプロトコルハンドラを取得するためのストリームハンドラファクトリとして使われます。

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

パラメータ:

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

parent - 委譲に使う親クラスローダ

factory - URL の作成時に使う URLStreamHandlerFactory

例外:

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

関連項目:

SecurityManager.checkCreateClassLoader()

メソッドの詳細

addURL

protected void addURL(URL url)

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

パラメータ:

url - URL の検索パスに追加する URL

getURLs

public URL[] getURLs()

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

findClass

protected Class findClass(String name)
                   throws ClassNotFoundException

URL 検索パスから、指定された名前を持つクラスを検索してロードします。クラスが見つかるまでは、JAR ファイルを参照する URL が、必要に応じてロードされて開かれます。

パラメータ:

name - クラス名

戻り値:

結果として得られたクラス

例外:

ClassNotFoundException - クラスが見つからない場合

オーバーライド:

クラス ClassLoader 内の findClass

definePackage

protected Package definePackage(String name,
                                Manifest man,
                                URL url)
                         throws IllegalArgumentException

新しいパッケージを、この ClassLoader で名前を指定して定義します。指定されたマニフェストに含まれる属性は、パッケージのバージョン、およびシーリングの情報を取得するために使います。シールされたパッケージについては、追加の URL が、パッケージのロード元となるコードソース URL を指定します。

パラメータ:

name - パッケージ名

man - パッケージのバージョン、およびシーリング情報を含むマニフェスト

url - パッケージのコードソース URL。ない場合は null

例外:

IllegalArgumentException - パッケージの名前が、クラスローダあるいはその先祖にある既存のパッケージの名前と重複する場合

findResource

public URL findResource(String name)

URL 検索パスに指定された名前を使って、リソースを検索します。リソースを取得するための URL が返されます。リソースが見つからない場合は null が返されます。

パラメータ:

name - リソースの名前

オーバーライド:

クラス ClassLoader 内の findResource

findResources

public Enumeration findResources(String name)
                          throws IOException

URL 検索パス上の指定された名前を持つリソースを表す、URL の列挙を返します。

パラメータ:

name - リソース名

オーバーライド:

クラス ClassLoader 内の findResources

getPermissions

protected PermissionCollection getPermissions(CodeSource codesource)

指定された codesource オブジェクトへのアクセス権を返します。このメソッドの実装は、まず super.getPermissions を呼び出して、ポリシーによって許可されているアクセス権を取得し、次に codesource の URL に基づいて追加のアクセス権を取得します。

プロトコルが「file」であり、パスがファイルを指定している場合は、そのファイルを読み取るアクセス権が与えられます。プロトコルが「file」であり、パス指定がディレクトリである場合、アクセス権は、そのディレクトリに含まれるすべてのファイルの読み取りと、再帰的に、ディレクトリのすべてのファイルおよびサブディレクトリの読み取りについて与えられます。

プロトコルが「file」ではない場合は、URL で指定されたホストについて、ホストへの接続、ホストからの接続受け入れが許可されます。

パラメータ:

codesource - コードソース

戻り値:

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

オーバーライド:

クラス SecureClassLoader 内の getPermissions

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

戻り値:

作成されたクラスローダ