Класс JarURLConnection

public abstract class JarURLConnection
extends URLConnection

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

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

jar:<url>!/{entry}

например:

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

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

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

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/

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

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

• Если нет URL контекста и в спецификации, переданной конструктору URL, нет разделителя, URL считается ссылающимся на JarFile.
• Если есть URL контекста, предполагается, что URL контекста ссылается на файл JAR или директорию JAR.
• Если спецификация начинается с '/', директория JAR игнорируется, а спецификация считается находящейся в корне файла JAR.

  Примеры:

  контекст: jar:http://www.foo.com/bar/jar.jar!/, спецификация: baz/entry.txt

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

  контекст: jar:http://www.foo.com/bar/jar.jar!/baz, спецификация: entry.txt

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

  контекст: jar:http://www.foo.com/bar/jar.jar!/baz, спецификация: /entry.txt

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

Подробное описание полей

jarFileURLConnection

protected URLConnection jarFileURLConnection

Соединение с URL файла JAR, если соединение инициировано. Должно быть установлено методом connect.

Подробное описание конструкторов

JarURLConnection

protected JarURLConnection(URL url)
                    throws MalformedURLException

Создаёт новое JarURLConnection для указанного URL.

Параметры:

url - URL

Исключения:

MalformedURLException - если в строке спецификации не удалось найти допустимый протокол или строку не удалось обработать.

Подробное описание методов

getJarFileURL

public URL getJarFileURL()

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

Возвращает:

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

getEntryName

public String getEntryName()

Возвращает имя записи для этого соединения. Этот метод возвращает null, если URL JAR-соединения ссылается на сам файл JAR, а не на запись в нём.

Возвращает:

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

getJarFile

public abstract JarFile getJarFile()
                            throws IOException

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

Возвращает:

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

Исключения:

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

См. также:

URLConnection.connect()

getManifest

public Manifest getManifest()
                     throws IOException

Возвращает Manifest для этого соединения, или null, если отсутствует.

Возвращает:

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

Исключения:

IOException - если получение файла JAR для этого соединения приводит к исключению IOException.

См. также:

getJarFile()

getJarEntry

public JarEntry getJarEntry()
                     throws IOException

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

Возвращает:

объект записи JAR для этого соединения, или null, если URL JAR для этого соединения ссылается на файл JAR.

Исключения:

IOException - если получение файла JAR для этого соединения приводит к исключению IOException.

См. также:

getJarFile(), getJarEntry()

getAttributes

public Attributes getAttributes()
                         throws IOException

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

Возвращает:

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

Исключения:

IOException - если получение записи JAR приводит к исключению IOException.

См. также:

getJarEntry()

getMainAttributes

public Attributes getMainAttributes()
                             throws IOException

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

Возвращает:

главные атрибуты для файла JAR для этого соединения.

Исключения:

IOException - если получение manifest приводит к исключению IOException.

См. также:

getJarFile(), getManifest()

getCertificates

public Certificate[] getCertificates()
                              throws IOException

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

Возвращает:

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

Исключения:

IOException - если получение записи JAR приводит к исключению IOException.

См. также:

getJarEntry()