JarURLConnection (Java Platform SE 8 )

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

```
public abstract class JarURLConnection
extends URLConnection
```
与Java ARchive（JAR）文件或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:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class

一个jar文件

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

一个罐子目录

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

!/被称为分离器 。

当通过构建一个JAR URL new URL(context, spec) ，适用下列规则：
- 如果没有上下文URL，并且传递给URL构造函数的规范不包含分隔符，则该URL被认为是引用JarFile。
- 如果存在上下文URL，则假定上下文URL是指JAR文件或Jar目录。
- 如果规范以'/'开始，Jar目录将被忽略，并且该规范被认为是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

Field Summary

Fields
Modifier and Type	Field and Description
`protected URLConnection`	`jarFileURLConnection` 与JAR文件URL的连接，如果连接已启动。

Fields inherited from class java.net.URLConnection
allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`JarURLConnection(URL url)` 创建新的JarURLConnection到指定的URL。

方法摘要

所有方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`Attributes`	`getAttributes()` 如果该连接的URL指向JAR文件条目，则返回此连接的Attributes对象，否则返回null。
`Certificate[]`	`getCertificates()` 如果它的URL指向JAR文件条目，则返回此连接的证书对象，否则返回null。
`String`	`getEntryName()` 返回此连接的条目名称。
`JarEntry`	`getJarEntry()` 返回此连接的JAR条目对象（如果有）。
`abstract JarFile`	`getJarFile()` 返回此连接的JAR文件。
`URL`	`getJarFileURL()` 返回此连接的Jar文件的URL。
`Attributes`	`getMainAttributes()` 返回此连接的JAR文件的主要属性。
`Manifest`	`getManifest()` 返回此连接的清单，否则返回null。

Methods inherited from class java.net.URLConnection
addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentLengthLong, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderField, getHeaderFieldDate, getHeaderFieldInt, getHeaderFieldKey, getHeaderFieldLong, 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

Methods inherited from class 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
```
    创建新的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
```
    返回此连接的清单，否则返回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文件条目，则返回此连接的Attributes对象，否则返回null。
    
    结果
    
    这个连接的Attributes对象，如果它的URL指向一个JAR文件条目，否则为空。
    
    异常
    
    IOException - 如果获取JAR条目导致抛出IOException。
    
    另请参见：
    
    getJarEntry()
  - getMainAttributes
```
public Attributes getMainAttributes()
                             throws IOException
```
    返回此连接的JAR文件的主要属性。
    
    结果
    
    此连接的JAR文件的主要属性。
    
    异常
    
    IOException - 如果获取清单导致抛出IOException。
    
    另请参见：
    
    getJarFile() ， getManifest()
  - getCertificates
```
public Certificate[] getCertificates()
                              throws IOException
```
    如果它的URL指向JAR文件条目，则返回此连接的证书对象，否则返回null。一旦通过从输入流读取直到流已经到达结束，连接已被完全验证，才能调用此方法。否则，此方法将返回null
    
    结果
    
    此连接的证书对象，如果其URL指向JAR文件条目，否则为空。
    
    异常
    
    IOException - 如果获取JAR条目导致抛出IOException。
    
    另请参见：
    
    getJarEntry()

Class JarURLConnection

Field Summary

Fields inherited from class java.net.URLConnection

构造方法摘要

方法摘要

Methods inherited from class java.net.URLConnection

Methods inherited from class java.lang.Object

字段详细信息

jarFileURLConnection

构造方法详细信息

JarURLConnection

方法详细信息

getJarFileURL

getEntryName

getJarFile

getManifest

getJarEntry

getAttributes

getMainAttributes

getCertificates