JarURLConnection

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.net
类 JarURLConnection

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

public abstract class JarURLConnection
extends URLConnection
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.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 的连接，如果已启动连接。此方法应该由连接设置。

构造方法详细信息