java.net
클래스 JarURLConnection

java.lang.Object 
  |
  +--java.net.URLConnection 
        |
        +--java.net.JarURLConnection

public abstract class JarURLConnection

extends URLConnection

JAR (Java ARchive) 파일, 또는 JAR 파일내에 있는 엔트리에의 URL 접속입니다.

JAR URL 의 구문은 다음과 같습니다.

 jar:<url>! /{entry}
 

례:

jar:http://www.foo.com/bar/baz.jar! /COM/foo/Quux.class


Jar URL 는 JAR 파일에의 참조, 혹은 JAR 파일의 엔트리에의 참조의 어느 쪽에도 사용할 수 있습니다. 상기에 나타낸 예는 JAR 엔트리를 참조하고 있습니다. 엔트리명이 생략 되었을 경우, URL 는 JAR 파일의 전체를 참조합니다. jar:http://www.foo.com/bar/baz.jar! /

JAR URL 를 작성하는 것이 명백한 경우, JAR 특유의 기능이 필요한 때는 범용 URLConnection 를 JarURLConnection 에 캐스트 해 주세요. 다음에 예를 나타냅니다.

 URL url = new URL("jar:file:/home/duke/duke.jar! /");
 JarURLConnection jarConnection = (JarURLConnection) url.openConnection();
 Manifest manifest = jarConnection.getManifest();
 

례:

Jar 엔트리

jar:http://www.foo.com/bar/baz.jar! /COM/foo/Quux.class

Jar 파일

jar:http://www.foo.com/bar/baz.jar! /

Jar 디렉토리

jar:http://www.foo.com/bar/baz.jar! /COM/foo/

! / (은)는 단락 캐릭터입니다.

new URL(context, spec) 를 사용한 JAR url 의 작성에서는 이하의 규칙이 적용됩니다.

• 문맥 URL 가 없고, URL constructor로 건네진 지정이 단락지어 캐릭터를 포함하지 않는 경우는 그 URL 는 JarFile 를 참조하고 있다고 보여진다
• 문맥 URL 가 있는 경우는 그 문맥 URL 가 JAR 파일 또는 Jar 디렉토리를 참조하고 있다고 보여진다
• 지정이 「/」으로 시작되어 있는 경우는 그 Jar 디렉토리를 무시해, Jar 파일의 루트를 지정하고 있다고 보여진다

  예:

  문맥: jar:http://www.foo.com/bar/jar.jar! /, spec:baz/entry.txt

  url:jar:http://www.foo.com/bar/jar.jar! /baz/entry.txt

  문맥: jar:http://www.foo.com/bar/jar.jar! /baz, spec:entry.txt

  url:jar:http://www.foo.com/bar/jar.jar! /baz/entry.txt

  문맥: jar:http://www.foo.com/bar/jar.jar! /baz, spec:/entry.txt

  url:jar:http://www.foo.com/bar/jar.jar! /entry.txt

도입된 버젼:

1.2

관련 항목:

URL , URLConnection , JarFile , JarInputStream , Manifest , ZipEntry

필드의 개요

protected URLConnection

jarFileURLConnection 접속이 개시되었을 경우의, JAR 파일 URL 에의 접속입니다.

클래스 java.net. URLConnection 에서 상속받은 필드

allowUserInteraction , connected , doInput , doOutput , ifModifiedSince , url , useCaches

생성자의 개요

protected

JarURLConnection (URL url) 지정한 URL 에 새로운 JarURLConnection 를 작성합니다.

메소드의 개요

Attributes	getAttributes () 접속으로 사용하는 URL 가 JAR 파일 엔트리를 가리키는 경우, 이 접속용의 Attributes 오브젝트를 돌려줍니다.
Certificate []	getCertificates () 접속으로 사용하는 URL 가 JAR 파일 엔트리를 가리키는 경우에, 이 접속용의 Certificate 오브젝트를 돌려줍니다.
String	getEntryName () 이 접속으로 사용하는 엔트리명을 돌려줍니다.
JarEntry	getJarEntry () 이 접속으로 사용하는 JAR 엔트리 오브젝트가 있으면, 그것을 돌려줍니다.
abstract JarFile	getJarFile () 이 접속으로 사용하는 JAR 파일을 돌려줍니다.
URL	getJarFileURL () 이 접속으로 사용하는 JAR 파일의 URL 를 돌려줍니다.
Attributes	getMainAttributes () 이 접속으로 사용하는 JAR 파일의 주요한 Attributes 를 돌려줍니다.
Manifest	getManifest () 이 접속으로 사용하는 마니페스트가 있으면 그것을 돌려주어, 없으면 null 를 돌려줍니다.

클래스 java.net. URLConnection 에서 상속받은 메소드

addRequestProperty , connect , getAllowUserInteraction , getContent , getContent , getContentEncoding , getContentLength , getContentType , getDate , getDefaultAllowUserInteraction , getDefaultRequestProperty , getDefaultUseCaches , getDoInput , getDoOutput , getExpiration , getFileNameMap , getHeaderField , getHeaderField , getHeaderFieldDate , getHeaderFieldInt , getHeaderFieldKey , getHeaderFields , getIfModifiedSince , getInputStream , getLastModified , getOutputStream , getPermission , getRequestProperties , getRequestProperty , getURL , getUseCaches , guessContentTypeFromName , guessContentTypeFromStream , setAllowUserInteraction , setContentHandlerFactory , setDefaultAllowUserInteraction , setDefaultRequestProperty , setDefaultUseCaches , setDoInput , setDoOutput , setFileNameMap , setIfModifiedSince , setRequestProperty , setUseCaches , toString

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

필드의 상세

jarFileURLConnection

protected URLConnection  jarFileURLConnection

접속이 개시되었을 경우의, JAR 파일 URL 에의 접속입니다. 이것은 connect 로 설정해 주세요.

생성자의 상세

JarURLConnection

protected JarURLConnection(URL  url)
                    throws MalformedURLException 

지정한 URL 에 새로운 JarURLConnection 를 작성합니다.

파라미터:

url - URL

예외:

MalformedURLException - 지정 캐릭터 라인에 유효한 프로토콜이 발견되지 않는 경우, 또는 캐릭터 라인을 해석할 수 없는 경우

메소드의 상세

getJarFileURL

public URL  getJarFileURL()

이 접속으로 사용하는 JAR 파일의 URL 를 돌려줍니다.

반환값:

이 접속으로 사용하는 JAR 파일의 URL

getEntryName

public String  getEntryName()

이 접속으로 사용하는 엔트리명을 돌려줍니다. 이 접속과 대응하는 JAR file URL 가 JAR 파일의 엔트리는 아니고 JAR 파일을 가리키고 있는 경우, 이 메소드는 null 를 돌려줍니다.

반환값:

이 접속으로 사용하는 엔트리명 (엔트리가 있는 경우)

getJarFile

public abstract JarFile  getJarFile()
                            throws IOException 

이 접속으로 사용하는 JAR 파일을 돌려줍니다. 돌려주어진 오브젝트는 변경 불가능하고, 호출측이 변경을 시도했을 경우는 UnsupportedOperationException 가 슬로우 됩니다.

반환값:

이 접속으로 사용하는 JAR 파일. JAR 파일의 엔트리에의 접속인 경우는 JAR 파일 오브젝트가 돌려주어진다

예외:

IOException - 이 접속으로 사용하는 JAR 파일에의 접속을 시도하고 있을 때 IOException 가 발생했을 경우

관련 항목:

URLConnection.connect()

getManifest

public Manifest  getManifest()
                     throws IOException 

이 접속으로 사용하는 마니페스트가 있으면 그것을 돌려주어, 없으면 null 를 돌려줍니다. 돌려주어진 오브젝트는 변경 불가능하고, 호출측이 변경을 시도했을 경우는 UnsupportedOperationException 가 슬로우 됩니다.

반환값:

이 접속으로 사용하는 JAR 파일 오브젝트와 대응하는 마니페스트 오브젝트

예외:

IOException - 이 접속으로 사용하는 JAR 파일의 취득이 원인으로 IOException 가 슬로우 되었을 경우

관련 항목:

getJarFile()

getJarEntry

public JarEntry  getJarEntry()
                     throws IOException 

이 접속으로 사용하는 JAR 엔트리 오브젝트가 있으면, 그것을 돌려줍니다. 이 접속과 대응하는 JAR 파일의 URL 가 JAR 파일의 엔트리는 아니고 JAR 파일을 가리키고 있는 경우, 이 메소드는 null 를 돌려줍니다. 돌려주어진 오브젝트는 변경 불가능하고, 호출측이 변경을 시도했을 경우는 UnsupportedOperationException 가 슬로우 됩니다.

반환값:

이 접속으로 사용하는 JAR 엔트리 오브젝트. 이 접속의 JAR URL 가 JAR 파일을 가리키고 있는 경우는 null

예외:

IOException - 이 접속으로 사용하는 JAR 파일의 취득이 원인으로 IOException 가 슬로우 되었을 경우

관련 항목:

getJarFile() , getJarEntry()

getAttributes

public Attributes  getAttributes()
                         throws IOException 

접속으로 사용하는 URL 가 JAR 파일 엔트리를 가리키는 경우, 이 접속용의 Attributes 오브젝트를 돌려줍니다. 그렇지 않은 경우는 null 를 돌려줍니다.

반환값:

접속으로 사용하는 URL 가 JAR 파일 엔트리를 가리키는 경우, 이 접속용의 Attributes 오브젝트, 그렇지 않은 경우는 null

예외:

IOException - JAR 엔트리의 취득이 원인으로 IOException 가 슬로우 되었을 경우

관련 항목:

getJarEntry()

getMainAttributes

public Attributes  getMainAttributes()
                             throws IOException 

이 접속으로 사용하는 JAR 파일의 주요한 Attributes 를 돌려줍니다.

반환값:

이 접속으로 사용하는 JAR 파일의 주요한 Attributes

예외:

IOException - 마니페스트의 취득이 원인으로 IOException 가 슬로우 되었을 경우

관련 항목:

getJarFile() , getManifest()

getCertificates

public Certificate [] getCertificates()
                              throws IOException 

접속으로 사용하는 URL 가 JAR 파일 엔트리를 가리키는 경우에, 이 접속용의 Certificate 오브젝트를 돌려줍니다. 그렇지 않은 경우는 null 를 돌려줍니다. 이 메소드는 입력 스트림을 그 끝까지 읽어들이는 것으로, 접속이 완전하게 검증되었을 경우에만 호출할 수가 있습니다. 그렇지 않은 경우, 이 메소드는 null 를 돌려줍니다.

반환값:

접속으로 사용하는 URL 가 JAR 파일 엔트리를 가리키는 경우, 이 접속용의 Certificate 오브젝트, 그렇지 않은 경우는 null

예외:

IOException - JAR 엔트리의 취득이 원인으로 IOException 가 슬로우 되었을 경우

관련 항목:

getJarEntry()