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 의 인스턴스를 생성한 thread의 AccessControlContext 는 그 후에 클래스 및 리소스를 로드할 때 사용됩니다.

로드 되는 클래스에는 디폴트에서는 URLClassLoader 의 작성시로 지정된 URL 인 만큼 접속할 수 있는 액세스권이 주어집니다.

도입된 버젼:

1.2

생성자의 개요

URLClassLoader (URL [] urls)
지정된 URL 의 새로운 URLClassLoader 를, 디폴트의 delegate의 부모인 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 에서 상속받은 메소드

clearAssertionStatus , defineClass , defineClass , defineClass , definePackage , findLibrary , findLoadedClass , findSystemClass , getPackage , getPackages , getParent , getResource , getResourceAsStream , getResources , getSystemClassLoader , getSystemResource , getSystemResourceAsStream , getSystemResources , loadClass , loadClass , 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 파일을 참조하고 있다고 보여집니다.

시큐러티 매니저가 존재하는 경우, 이 메소드는 최초로 시큐러티 매니저의 checkCreateClassLoader 메소드를 호출하는 것으로, 이 클래스 로더의 작성이 허가되고 있는 것을 확인합니다.

파라미터:

urls - 클래스 및 리소스의 로드원이 되는 URL

parent - delegate을 위한 친클래스 로더

예외:

SecurityException - 시큐러티 매니저가 존재해, 그 checkCreateClassLoader 메소드가 클래스 로더의 작성을 허가하지 않는 경우

관련 항목:

SecurityManager.checkCreateClassLoader()

URLClassLoader

public URLClassLoader(URL [] urls)

지정된 URL 의 새로운 URLClassLoader 를, 디폴트의 delegate의 부모인 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 인수는 delegate을 위한 친클래스 로더로서 사용됩니다. factory 인수는 새로운 URL 를 작성할 경우에 프로토콜 핸들러를 취득하기 위한 스트림 핸들러 팩토리로서 사용됩니다.

시큐러티 매니저가 존재하는 경우, 이 메소드는 최초로 시큐러티 매니저의 checkCreateClassLoader 메소드를 호출하는 것으로, 이 클래스 로더의 작성이 허가되고 있는 것을 확인합니다.

파라미터:

urls - 클래스 및 리소스의 로드원이 되는 URL

parent - delegate을 위한 친클래스 로더

factory - URL 의 작성시에 사용하는 URLStreamHandlerFactory

예외:

SecurityException - 시큐러티 매니저가 존재해, 그 checkCreateClassLoader 메소드가 클래스 로더의 작성을 허가하지 않는 경우

관련 항목:

SecurityManager.checkCreateClassLoader()

메소드의 상세

addURL

protected void addURL(URL  url)

지정된 URL 를, 클래스 및 리소스를 검색하기 위한 URL 리스트에 추가합니다.

파라미터:

url - URL 의 검색 패스에 추가하는 URL

getURLs

public URL [] getURLs()

클래스 및 리소스를 로드하기 위한 URL 의 검색 패스를 돌려줍니다. 이것에는 constructor 으로 지정된 URL 의 원의 리스트와 나중에 addURL() 메소드에 의해 추가된 URL 도 포함됩니다.

반환값:

클래스 및 리소스를 로드하기 위한 URL 의 검색 패스

findClass

protected Class  findClass(String  name)
                   throws ClassNotFoundException 

URL 검색 패스로부터, 지정된 이름을 가지는 클래스를 검색해 로드합니다. 클래스가 발견될 때까지는 JAR 파일을 참조하는 URL 가, 필요에 따라서 로드 되어 열립니다.

오버라이드(override):

클래스 ClassLoader 내의 findClass

파라미터:

name - 클래스의 이름

반환값:

결과적으로 얻을 수 있던 클래스

예외:

ClassNotFoundException - 클래스가 발견되지 않는 경우

definePackage

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

새로운 패키지를, 이 ClassLoader 로 이름을 지정해 정의합니다. 지정된 마니페스트에 포함되는 속성은 패키지의 버젼, 및 실링의 정보를 취득하기 위해서 사용합니다. 씰 된 패키지에 대해서는 추가의 URL 가, 패키지의 로드원이 되는 코드 소스 URL 를 지정합니다.

파라미터:

name - 패키지명

man - 패키지의 버젼, 및 실링 정보를 포함한 마니페스트

url - 패키지의 코드 소스 URL. 없는 경우는 null

반환값:

새롭게 정의된 Package 오브젝트

예외:

IllegalArgumentException - 패키지명이, 이 클래스 로더인가 또는 게다가 위클래스 로더의 집 1 개에 존재하는 패키지와 중복 하는 경우

findResource

public URL  findResource(String  name)

URL 검색 패스상에서, 지정된 이름을 가지는 리소스를 검색합니다.

오버라이드(override):

클래스 ClassLoader 내의 findResource

파라미터:

name - 리소스의 이름

반환값:

리소스의 URL. 리소스가 발견되지 않았던 경우는 null

findResources

public Enumeration  findResources(String  name)
                          throws IOException 

URL 검색 패스상의 지정된 이름을 가지는 리소스를 나타내는 URL 의 열거를 돌려줍니다.

오버라이드(override):

클래스 ClassLoader 내의 findResources

파라미터:

name - 리소스명

반환값:

URL 의 Enumeration

예외:

IOException - 입출력 예외가 발생했을 경우

getPermissions

protected PermissionCollection  getPermissions(CodeSource  codesource)

지정된 codesource 오브젝트의 액세스권을 돌려줍니다. 이 메소드의 구현은 최초로 super.getPermissions 를 호출해, 다음에 codesource 의 URL 에 근거해 액세스권을 추가합니다.

프로토콜이 「file」이며, 패스가 파일을 지정하고 있는 경우는 그 파일을 읽어내는 액세스권이 주어집니다. 프로토콜이 「file」이며, 패스 지정이 디렉토리인 경우, 액세스권은 그 디렉토리에 포함되는 모든 파일의 독해와 재귀적으로, 디렉토리의 모든 파일 및 서브 디렉토리의 독해에 대해 주어집니다.

프로토콜이 「file」가 아닌 경우는 URL 로 지정된 호스트에 대해, 호스트에의 접속, 호스트로부터의 접속 수락이 허가됩니다.

오버라이드(override):

클래스 SecureClassLoader 내의 getPermissions

파라미터:

codesource - 코드 소스

반환값:

코드 소스에게 줄 수 있었던 액세스권

newInstance

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

지정된 URL, 및 친클래스 로더에 대해, URLClassLoader 의 새로운 인스턴스를 작성합니다. 시큐러티 매니저가 인스톨 되고 있는 경우, 이 메소드가 돌려주는 URLClassLoader 의 loadClass 메소드는 이 클래스를 로드하기 전에 SecurityManager.checkPackageAccess 메소드를 호출합니다.

파라미터:

urls - 클래스 및 리소스의 검색 대상의 URL

parent - delegate을 위한 친클래스 로더

반환값:

결과적으로 얻을 수 있던 클래스 로더

newInstance

public static URLClassLoader  newInstance(URL [] urls)

지정된 URL, 및 디폴트의 친클래스 로더에 대해, URLClassLoader 의 새로운 인스턴스를 작성합니다. 시큐러티 매니저가 인스톨이 끝난 상태인 경우, 이 메소드가 돌려주는 URLClassLoader 의 loadClass 메소드는 이 클래스를 로드하기 전에 SecurityManager.checkPackageAccess 메소드를 호출합니다.

파라미터:

urls - 클래스 및 리소스의 검색 대상의 URL

반환값:

결과적으로 얻을 수 있던 클래스 로더