JarURLConnection

public abstract class JarURLConnection
extends URLConnection

到Java归档（JAR）文件的URL连接或JAR文件中的条目。

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时，他们应该将通用URLConnection转换为JarURLConnection，并且他们需要特定于JAR的功能。 例如：

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

JarURLConnection实例只能用于从JAR文件读取。 使用此类无法获取OutputStream修改或写入底层JAR文件。

例子：

A Jar entry

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

A Jar file

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

A Jar directory

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

!/被称为 分隔符 。

通过 new URL(context, spec)构建JAR url时，适用以下规则：

• if there is no context URL and the specification passed to the URL constructor doesn't contain a separator, the URL is considered to refer to a JarFile.
• if there is a context URL, the context URL is assumed to refer to a JAR file or a Jar directory.
• if the specification begins with a '/', the Jar directory is ignored, and the spec is considered to be at the root of the Jar file.

  例子：

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

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

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

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

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

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

Summary

Inherited fields

From class java.net.URLConnection protected boolean allowUserInteraction 如果 true ，这个 URL正在一个允许用户交互的情况下进行检查，例如弹出一个验证对话框。 protected boolean connected 如果 false ，则此连接对象尚未创建指向指定URL的通信链接。 protected boolean doInput 该变量由 setDoInput方法设置。 protected boolean doOutput 该变量由 setDoOutput方法设置。 protected long ifModifiedSince 某些协议支持跳过对象的提取，除非该对象比某个时间更近被修改。 protected URL url URL表示打开此连接的万维网上的远程对象。 protected boolean useCaches 如果是 true ，则只要协议可以，就允许协议使用缓存。

Inherited methods
From class java.net.URLConnection void addRequestProperty(String key, String value) 添加由键值对指定的常规请求属性。 abstract void connect() 如果此连接尚未建立，则打开通向该URL所引用资源的通信链接。 boolean getAllowUserInteraction() 返回此对象的 allowUserInteraction字段的值。 int getConnectTimeout() 返回连接超时的设置。 Object getContent() 检索此URL连接的内容。 Object getContent(Class[] classes) 检索此URL连接的内容。 String getContentEncoding() 返回 content-encoding标题字段的值。 int getContentLength() 返回 content-length标题字段的值。 long getContentLengthLong() 以 content-length返回 content-length标题字段的值。 String getContentType() 返回 content-type标题字段的值。 long getDate() 返回 date标题字段的值。 static boolean getDefaultAllowUserInteraction() 返回 allowUserInteraction字段的默认值。 static String getDefaultRequestProperty(String key) 此方法在API级别1中已弃用。应在获得URLConnection的相应实例后使用特定于实例的getRequestProperty方法。 boolean getDefaultUseCaches() 返回 URLConnection的 useCaches标志的默认值。 boolean getDoInput() 返回此 URLConnection的 doInput标志的值。 boolean getDoOutput() 返回这个 URLConnection的 doOutput标志的值。 long getExpiration() 返回 expires标题字段的值。 static FileNameMap getFileNameMap() 从数据文件加载文件名映射（一个mimetable）。 String getHeaderField(String name) 返回指定标题字段的值。 String getHeaderField(int n) 返回第 n 个标题字段的值。 long getHeaderFieldDate(String name, long Default) 返回解析为日期的命名字段的值。 int getHeaderFieldInt(String name, int Default) 返回解析为数字的命名字段的值。 String getHeaderFieldKey(int n) 返回第 n 个标题字段的密钥。 long getHeaderFieldLong(String name, long Default) 返回解析为数字的命名字段的值。 Map<String, List<String>> getHeaderFields() 返回标题字段的不可修改的映射。 long getIfModifiedSince() 返回此对象的 ifModifiedSince字段的值。 InputStream getInputStream() 返回从此打开的连接读取的输入流。 long getLastModified() 返回 last-modified标题字段的值。 OutputStream getOutputStream() 返回写入此连接的输出流。 Permission getPermission() 返回一个权限对象，表示建立由此对象表示的连接所需的权限。 int getReadTimeout() 返回读取超时的设置。 Map<String, List<String>> getRequestProperties() 返回此连接的一般请求属性的不可修改的映射。 String getRequestProperty(String key) 返回此连接的指定常规请求属性的值。 URL getURL() 返回此 URLConnection的 URL字段的值。 boolean getUseCaches() 返回此 URLConnection的 useCaches字段的值。 static String guessContentTypeFromName(String fname) 尝试根据URL的指定“文件”组件确定对象的内容类型。 static String guessContentTypeFromStream(InputStream is) 尝试根据输入流开始处的字符确定输入流的类型。 void setAllowUserInteraction(boolean allowuserinteraction) 设置此 URLConnection的 allowUserInteraction字段的 URLConnection 。 void setConnectTimeout(int timeout) 设置打开到此URLConnection引用的资源的通信链接时要使用的指定超时值（以毫秒为单位）。 static void setContentHandlerFactory(ContentHandlerFactory fac) 设置应用程序的 ContentHandlerFactory 。 static void setDefaultAllowUserInteraction(boolean defaultallowuserinteraction) 将所有未来 URLConnection对象的 allowUserInteraction字段的默认值设置为指定值。 static void setDefaultRequestProperty(String key, String value) 此方法在API级别1中已弃用。在获得URLConnection的相应实例后应使用特定于实例的setRequestProperty方法。 调用此方法将不起作用。 void setDefaultUseCaches(boolean defaultusecaches) 将 useCaches字段的默认值设置为指定的值。 void setDoInput(boolean doinput) 将此 URLConnection的 doInput字段的值设置为指定的值。 void setDoOutput(boolean dooutput) 将此 URLConnection的 doOutput字段的值设置为指定的值。 static void setFileNameMap(FileNameMap map) 设置FileNameMap。 void setIfModifiedSince(long ifmodifiedsince) 将此 URLConnection的 ifModifiedSince字段的值设置为指定的值。 void setReadTimeout(int timeout) 将读取超时设置为指定的超时，以毫秒为单位。 void setRequestProperty(String key, String value) 设置一般请求属性。 void setUseCaches(boolean usecaches) 将此 URLConnection的 useCaches字段的值设置为指定值。 String toString() 返回此URL连接的 String表示形式。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过了一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() ，或者经过指定的时间量。 final void wait() 使当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。

Fields

URLConnection jarFileURLConnection

Protected constructors

JarURLConnection (URL url)

Public methods

Attributes getAttributes ()

Certificate[] getCertificates ()

String getEntryName ()

JarEntry getJarEntry ()

JarFile getJarFile ()

URL getJarFileURL ()

Attributes getMainAttributes ()

Manifest getManifest ()