java.net
類別 JarURLConnection

java.lang.Object
  java.net.URLConnection
      java.net.JarURLConnection

public abstract class JarURLConnection
extends URLConnection

連接到 Java ARchive (JAR) 檔案或 JAR 檔案中條目的 URL Connection。

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 目錄，並認為 spec 位於 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 檔案條目，則返回其 Attribute 物件；否則返回 null。
Certificate[]	getCertificates() 如果此連接的 URL 指向 JAR 檔案條目，則返回其 Certificate 物件；否則返回 null。
String	getEntryName() 返回此連接的條目名稱。
JarEntry	getJarEntry() 返回此連接的 JAR 條目物件（如果有）。
abstract JarFile	getJarFile() 返回此連接的 JAR 檔案。
URL	getJarFileURL() 返回此連接的 Jar 檔案的 URL。
Attributes	getMainAttributes() 返回此連接的 JAR 檔案的主要 Attribute。
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 的連接，如果已啟動連接。此方法應該由連接設置。

建構子詳細資訊

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 檔案物件相對應的清單物件。

拋出：

IOException - 如果獲取此連接的 JAR 檔案導致拋出 IOException。

另請參見：

getJarFile()

getJarEntry

public JarEntry getJarEntry()
                     throws IOException

返回此連接的 JAR 條目物件（如果有）。如果對應於此連接的 JAR 檔案 URL 指向 JAR 檔案而不是 JAR 檔案條目，則此方法返回 null。

返回：

此連接的 JAR 條目物件；如果此連接的 JAR URL 指向 JAR 檔案，則返回 null。

拋出：

IOException - 如果獲取此連接的 JAR 檔案導致拋出 IOException。

另請參見：

getJarFile(), getJarEntry()

getAttributes

public Attributes getAttributes()
                         throws IOException

如果此連接的 URL 指向 JAR 檔案條目，則返回其 Attribute 物件；否則返回 null。

返回：

如果此連接的 URL 指向 JAR 檔案條目，則返回其 Attribute 物件；否則返回 null。

拋出：

IOException - 如果獲取 JAR 條目導致拋出 IOException。

另請參見：

getJarEntry()

getMainAttributes

public Attributes getMainAttributes()
                             throws IOException

返回此連接的 JAR 檔案的主要 Attribute。

返回：

此連接的 JAR 檔案的主要 Attribute。

拋出：

IOException - 如果獲取清單導致拋出 IOException。

另請參見：

getJarFile(), getManifest()

getCertificates

public Certificate[] getCertificates()
                              throws IOException

如果此連接的 URL 指向 JAR 檔案條目，則返回其 Certificate 物件；否則返回 null。只有通過從條目輸入串流一直讀取到串流末尾的方式完全驗證了連接之後，才能調用此方法。否則，此方法將返回 null。

返回：

如果此連接的 URL 指向 JAR 檔案條目，則返回其 Certificate 物件；否則返回 null。

拋出：

IOException - 如果獲取 JAR 條目導致拋出 IOException。

另請參見：

getJarEntry()