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 의 엔트리를 참조하는 JAR URL 입니다. 다음과 같이 엔트리명이 생략 되었을 경우, 그 URL 는 JAR 파일의 전체를 참조합니다. jar:http://www.foo.com/bar/baz.jar! /

작성한 URL 가 JAR URL 인 것을 알 수 있고 있어, JAR 에 고유의 기능이 필요한 경우에는, 총칭 URLConnection 를 JarURLConnection 에 캐스트 하도록 해 주세요. 다음에 예를 나타냅니다.

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

JarURLConnection 인스턴스는, JAR 파일로부터의 읽기시 밖에 사용할 수 없습니다. 이 클래스에서 OutputStream 를 취득해 대상의 JAR 파일을 변경하거나 데이터를 기입하거나 할 수 없습니다.

예:

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 생성자 에게 건네진 지정이 단락지어 문자를 포함하지 않는 경우는, 그 URL 는 JarFile 를 참조하고 있다고 보여진다
• 문맥 URL 가 있는 경우는, 그 문맥 URL 가 JAR 파일 또는 Jar 디렉토리를 참조하고 있다고 보여진다
• 지정이 「/」으로 시작되어 있는 경우는, 그 Jar 디렉토리를 무시해, Jar 파일의 루트를 지정하고 있다고 보여진다

  례:

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

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

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

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

  문맥:jar:http://www.foo.com/bar/jar.jar! /baz, 지정: /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 객체, 그렇지 않은 경우는 null 를 돌려줍니다.
String	getEntryName () 이 접속의 엔트리명을 돌려줍니다.
JarEntry	getJarEntry () 이 접속의 JAR 엔트리 객체가 존재하는 경우에 그것을 돌려줍니다.
abstract JarFile	getJarFile () 이 접속의 JAR 파일을 돌려줍니다.
URL	getJarFileURL () 이 접속으로 사용하는 JAR 파일의 URL 를 돌려줍니다.
Attributes	getMainAttributes () 이 접속으로 사용하는 JAR 파일의 주요한 Attributes 를 돌려줍니다.
Manifest	getManifest () 이 접속의 Manifest 가 존재하는 경우는 그것을, 존재하지 않는 경우는 null 를, 각각 돌려줍니다.

클래스 java.net. URLConnection 로부터 상속된 메소드

addRequestProperty , connect , getAllowUserInteraction , getConnectTimeout , getContent , getContent , getContentEncoding , getContentLength , getContentType , getDate , getDefaultAllowUserInteraction , getDefaultRequestProperty , getDefaultUseCaches , getDoInput , getDoOutput , getExpiration , getFileNameMap , getHeaderField , getHeaderField , getHeaderFieldDate , getHeaderFieldInt , getHeaderFieldKey , getHeaderFields , getIfModifiedSince , getInputStream , getLastModified , getOutputStream , getPermission , getReadTimeout , getRequestProperties , getRequestProperty , getURL , getUseCaches , guessContentTypeFromName , guessContentTypeFromStream , setAllowUserInteraction , setConnectTimeout , setContentHandlerFactory , setDefaultAllowUserInteraction , setDefaultRequestProperty , setDefaultUseCaches , setDoInput , setDoOutput , setFileNameMap , setIfModifiedSince , setReadTimeout , 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 파일 URL 가, JAR 파일 엔트리는 아니고 JAR 파일을 가리키고 있는 경우, 이 메소드는 null 를 돌려줍니다.

반환값:

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

getJarFile

public abstract JarFile  getJarFile()
                            throws IOException 

이 접속의 JAR 파일을 돌려줍니다.

반환값:

이 접속의 JAR 파일. 이 접속이 JAR 파일의 엔트리에의 접속인 경우에는, JAR 파일 객체가 반환된다

예외:

IOException - 이 접속의 JAR 파일에의 접속 시행중에 IOException 가 발생했을 경우

관련 항목:

URLConnection.connect()

getManifest

public Manifest  getManifest()
                     throws IOException 

이 접속의 Manifest 가 존재하는 경우는 그것을, 존재하지 않는 경우는 null 를, 각각 돌려줍니다.

반환값:

이 접속의 JAR 파일 객체에 대응하는 Manifest 객체

예외:

IOException - 이 접속의 JAR 파일의 취득시에 IOException 가 throw 되었을 경우

관련 항목:

getJarFile()

getJarEntry

public JarEntry  getJarEntry()
                     throws IOException 

이 접속의 JAR 엔트리 객체가 존재하는 경우에 그것을 돌려줍니다. 이 접속에 대응하는 JAR 파일 URL 가, JAR 파일 엔트리는 아니고 JAR 파일을 가리키고 있는 경우, 이 메소드는 null 를 돌려줍니다.

반환값:

이 접속의 JAR 엔트리 객체. 이 접속의 JAR URL 가 JAR 파일을 가리키고 있는 경우는 null

예외:

IOException - 이 접속의 JAR 파일의 취득시에 IOException 가 throw 되었을 경우

관련 항목:

getJarFile() , getJarEntry()

getAttributes

public Attributes  getAttributes()
                         throws IOException 

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

반환값:

이 접속의 URL 가 JAR 파일 엔트리를 가리키고 있는 경우는 이 접속의 Attributes 객체, 그렇지 않은 경우는 null

예외:

IOException - JAR 엔트리의 취득시에 IOException 가 throw 되었을 경우

관련 항목:

getJarEntry()

getMainAttributes

public Attributes  getMainAttributes()
                             throws IOException 

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

반환값:

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

예외:

IOException - Manifest의 취득시에 IOException 가 throw 되었을 경우

관련 항목:

getJarFile() , getManifest()

getCertificates

public Certificate [] getCertificates()
                              throws IOException 

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

반환값:

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

예외:

IOException - JAR 엔트리의 취득시에 IOException 가 throw 되었을 경우

관련 항목:

getJarEntry()