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();
 

JarURLConnection 인스턴스는 JAR 파일로부터의 읽기 전용 입니다. OutputStream를 취득해, 이 클래스를 사용해, 기본이 되는 JAR 파일로 변경을 더하는 (출력한다) (일)것은 할 수 없습니다.

례:

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 객체를 리턴합니다.
String	getEntryName () 이 접속으로 사용하는 엔트리명을 리턴합니다.
JarEntry	getJarEntry () 이 접속으로 사용하는 JAR 엔트리 객체를 리턴합니다 (존재하는 경우).
abstract JarFile	getJarFile () 이 접속으로 사용하는 JAR 파일을 리턴합니다.
URL	getJarFileURL () 이 접속으로 사용하는 JAR 파일의 URL를 리턴합니다.
Attributes	getMainAttributes () 이 접속으로 사용하는 JAR 파일의 주요한 Attributes를 리턴합니다.
Manifest	getManifest () 이 접속으로 사용하는 Manifest를 리턴합니다.

클래스 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 file 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 file 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()