java.net
클래스 URLClassLoader

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

알려진 직계 서브 클래스:

MLet

public class URLClassLoader
extends SecureClassLoader 

이 클래스 로더는 JAR 파일 및 디렉토리의 양쪽 모두를 참조하는 URL 검색 패스로부터, 클래스 및 자원을 다운로드하기 위해서 사용합니다. 「/」으로 끝나는 URL는 디렉토리를 참조하고 있다고 보여집니다. 그 외의 URL는 필요에 따라서 열리는 JAR 파일을 참조하고 있다고 보여집니다.

URLClassLoader 인스턴스를 작성한 thread의 AccessControlContext는 그 후에 클래스 및 자원을 로드할 때 사용됩니다.

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

도입된 버전 :

1.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 <URL >	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, defineClass

클래스 java.lang. ClassLoader 로부터 상속된 메서드

clearAssertionStatus, defineClass, 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 - 위양을 위한 친클래스 로더

예외:

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도 포함됩니다.

반환값:

클래스 및 자원을 로드하기 위한 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 로 이름을 지정해 정의합니다. 지정된 MANIFEST에 포함되는 속성은 패키지의 버전 및 실링의 정보를 취득하기 위해서 사용합니다. 씰 된 패키지에 대해서는 추가의 URL 가 패키지의 로드원이 되는 코드 소스 URL를 지정합니다.

파라미터:

name - 패키지명

man - 패키지의 버전 및 실링 정보를 포함한 MANIFEST

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

반환값:

새롭게 정의된 Package 객체

예외:

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

findResource

public URL  findResource(String  name)

URL 검색 패스상에서 지정된 이름을 가지는 자원을 검색합니다.

오버라이드(override):

클래스 ClassLoader 내의 findResource

파라미터:

name - 자원의 이름

반환값:

자원의 URL. 자원이 발견되지 않았던 경우는 null

findResources

public Enumeration <URL > 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 - 위양을 위한 친클래스 로더

반환값:

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

newInstance

public static URLClassLoader  newInstance(URL [] urls)

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

파라미터:

urls - 클래스 및 자원의 검색 대상의 URL

반환값:

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