JarURLConnection
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 条目
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 目录，并认为规范位于 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
字段摘要
| 修饰符和类型 | 字段 | 描述 |
|---|---|---|
| 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 对象，否则返回 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。 |
| 从类 java.lang.Object 继承的方法 |
|---|
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| 从类 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 |
字段详细信息
jarFileURLConnection
protected URLConnection jarFileURLConnection
与 JAR 文件 URL 的连接（如果已启动连接）。 这应该由连接设置。
构造函数详细信息
JarURLConnection
protected JarURLConnection(URL url) throws MalformedURLException
为指定的 URL 创建新的 JarURLConnection。
参数：
| 参数名称 | 参数描述 |
|---|---|
| url | 网址 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| 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 文件对象
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果在尝试连接到此连接的 JAR 文件时发生 IOException。 |
getManifest
public Manifest getManifest() throws IOException
返回此连接的清单，如果没有则返回 null。
返回:
与此连接的 JAR 文件对象对应的清单对象。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果获取此连接的 JAR 文件会导致抛出 IOException。 |
getJarEntry
public JarEntry getJarEntry() throws IOException
返回此连接的 JAR 条目对象（如果有）。 如果与此连接对应的 JAR 文件 URL 指向 JAR 文件而不是 JAR 文件条目，则此方法返回 null。
返回:
此连接的 JAR 条目对象，如果此连接的 JAR URL 指向 JAR 文件，则返回 null。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果获取此连接的 JAR 文件会导致抛出 IOException。 |
getAttributes
public Attributes getAttributes() throws IOException
如果该连接的 URL 指向 JAR 文件条目，则返回该连接的 Attributes 对象，否则返回 null。
返回:
如果此连接的 URL 指向 JAR 文件条目，则为该连接的 Attributes 对象，否则为 null。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果获取 JAR 条目导致抛出 IOException。 |
getMainAttributes
public Attributes getMainAttributes() throws IOException
返回此连接的 JAR 文件的主要属性。
返回:
此连接的 JAR 文件的主要属性。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果获取清单导致抛出 IOException。 |
getCertificates
public Certificate[] getCertificates() throws IOException
如果此连接的 URL 指向 JAR 文件条目，则返回此连接的证书对象，否则返回 null。 只有在通过从输入流中读取直到到达流的末尾来完全验证连接后，才能调用此方法。 否则，此方法将返回 null
返回:
如果此连接的 URL 指向 JAR 文件条目，则为该连接的 Certificate 对象，否则为 null。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果获取 JAR 条目导致抛出 IOException。 |
文章来源网络，作者：管理，如若转载，请注明出处：https://shuyeidc.com/wp/162407.html<
