java.net

Класс JarURLConnection

java.lang. Объект

java.net. URLConnection

java.net. JarURLConnection

public abstract class JarURLConnection
extends URLConnection

Соединение URL с Архивом Java (JAR) файл или запись в файле JAR.

Синтаксис JAR URL:

 jar:<url>!/{entry}
 

например:

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


Фляга URL должна использоваться, чтобы обратиться к файлу JAR или записям в файле JAR. Примером выше является JAR URL, который обращается к записи JAR. Если имя записи опускается, URL обращается к целому файлу JAR: jar:http://www.foo.com/bar/baz.jar!/

Пользователи должны бросить универсальный URLConnection к JarURLConnection, когда они знают, что URL, который они создали, является JAR URL, и они нуждаются в специфичной для JAR функциональности. Например:

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

Экземпляры JarURLConnection могут только использоваться, чтобы читать из файлов JAR. Не возможно получить a OutputStream изменить или записать в базовый файл JAR, используя этот класс.

Примеры:

Запись Фляги

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

Файл Фляги

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

Каталог Jar

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

!/ называется как разделитель.

Создавая url JAR через new URL(context, spec), следующие правила применяются:

• если нет никакого контекста, URL и спецификация, которую передают конструктору URL, не содержат разделитель, URL, как полагают, обращается к JarFile.
• если есть контекст URL, контекст, URL, как предполагается, обращается к файлу 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

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected URLConnection	jarFileURLConnection Соединение с файлом JAR URL, если соединение инициировалось.

Поля java.net унаследованный от класса. URLConnection

allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	JarURLConnection(URL url) Создает новый JarURLConnection к указанному URL.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Атрибуты	getAttributes() Возвратите объект Атрибутов для этого соединения, если URL для этого указывает на запись файла JAR, нуль иначе.
Сертификат[]	getCertificates() Возвратите объект Сертификата для этого соединения, если URL для этого указывает на запись файла JAR, нуль иначе.
Строка	getEntryName() Возвратите имя записи для этого соединения.
JarEntry	getJarEntry() Возвратите объект записи JAR для этого соединения, если любой.
abstract JarFile	getJarFile() Возвратите файл JAR для этого соединения.
URL	getJarFileURL() Возвращает URL для файла Фляги для этого соединения.
Атрибуты	getMainAttributes() Возвращает основные Атрибуты для файла JAR для этого соединения.
Декларация	getManifest() Возвращает Декларацию для этого соединения, или нуль если ни один.

Методы 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

Методы java.lang унаследованный от класса. Объект

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 - URL

Броски:

MalformedURLException - если никакой юридический протокол не мог бы быть найден в строке спецификации, или строка не могла бы быть проанализирована.

Деталь метода

getJarFileURL

public URL getJarFileURL()

Возвращает URL для файла Фляги для этого соединения.

Возвраты:

URL для файла Фляги для этого соединения.

getEntryName

public String getEntryName()

Возвратите имя записи для этого соединения. Этот метод возвращает нуль если файл JAR URL, соответствующий этому точки контакта к файлу JAR и не записи файла JAR.

Возвраты:

имя записи для этого соединения, если любой.

getJarFile

public abstract JarFile getJarFile()
                            throws IOException

Возвратите файл JAR для этого соединения.

Возвраты:

файл JAR для этого соединения. Если соединение является соединением с записью файла JAR, объект файла JAR возвращается

Броски:

IOException - если IOException происходит, пытаясь соединиться с файлом JAR для этого соединения.

См. Также:

URLConnection.connect()

getManifest

public Manifest getManifest()
                     throws IOException

Возвращает Декларацию для этого соединения, или нуль если ни один.

Возвраты:

явный объект, соответствующий файлу JAR, возражает для этого соединения.

Броски:

IOException - если получение файла JAR для этого соединения заставляет IOException быть trown.

См. Также:

getJarFile()

getJarEntry

public JarEntry getJarEntry()
                     throws IOException

Возвратите объект записи JAR для этого соединения, если любой. Этот метод возвращает нуль если файл JAR URL, соответствующий этому точки контакта к файлу JAR и не записи файла JAR.

Возвраты:

запись JAR возражает для этого соединения, или нуля если JAR URL для этого точки контакта к файлу JAR.

Броски:

IOException - если получение файла JAR для этого соединения заставляет IOException быть trown.

См. Также:

getJarFile(), getJarEntry()

getAttributes

public Attributes getAttributes()
                         throws IOException

Возвратите объект Атрибутов для этого соединения, если URL для этого указывает на запись файла JAR, нуль иначе.

Возвраты:

Атрибуты возражают для этого соединения, если 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

Возвраты:

объект Сертификата для этого соединения, если URL для этого указывает на запись файла JAR, нуль иначе.

Броски:

IOException - если получение записи JAR заставляет IOException быть брошенным.

См. Также:

getJarEntry()