Класс JarSigner

java.lang.Object

jdk.security.jarsigner.JarSigner

public final class JarSigner extends Object

Неизменяемый вспомогательный класс для подписания JAR-файла.

Вызывающий код создает объект JarSigner.Builder, (необязательно) задает некоторые параметры и вызывает build, чтобы создать объект JarSigner. Затем этот объект JarSigner можно использовать для подписания JAR-файла.

Если не указано иное, вызов метода JarSigner или JarSigner.Builder с аргументом null приведет к выбрасыванию исключения NullPointerException.

Пример:

    JarSigner signer = new JarSigner.Builder(key, certPath)
            .digestAlgorithm("SHA-256")
            .signatureAlgorithm("SHA256withRSA")
            .build();
    try (ZipFile  in = new ZipFile(inputFile);
            FileOutputStream out = new FileOutputStream(outputFile)) {
        signer.sign(in, out);
    }

Начиная с:: 9

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`JarSigner.Builder`	Изменяемый класс для создания неизменяемого объекта `JarSigner` на основе различных параметров, связанных с подписанием.

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`getDigestAlgorithm()`	Возвращает алгоритм дайджеста для этого объекта `JarSigner`.
`String`	`getProperty(String key)`	Возвращает значение дополнительного свойства, зависящего от реализации и указанного заданным ключом.
`String`	`getSignatureAlgorithm()`	Возвращает алгоритм подписи для этого объекта `JarSigner`.
`String`	`getSignerName()`	Возвращает имя подписывающего лица для этого объекта `JarSigner`.
`URI`	`getTsa()`	Возвращает URI службы штампов времени (TSA).
`void`	`sign(ZipFile file, OutputStream os)`	Подписывает файл и записывает его в `OutputStream`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

sign

public void sign(ZipFile file, OutputStream os)

Подписывает файл и записывает его в OutputStream. Этот метод не закрывает file или os.

Если во время подписания возникает ошибка ввода-вывода или ошибка подписания, это может произойти после записи некоторых байтов. В результате поток вывода может оказаться в несогласованном состоянии. В этом случае настоятельно рекомендуется незамедлительно закрыть его.

Параметры:: file — файл для подписания.; os — поток вывода.
Исключения:: JarSignerException — если подписание завершилось неудачно.

getDigestAlgorithm

public String getDigestAlgorithm()

Возвращает алгоритм дайджеста для этого объекта JarSigner.

Возвращаемое значение никогда не равно null.

Возвращает:: алгоритм дайджеста.

getSignatureAlgorithm

public String getSignatureAlgorithm()

Возвращает алгоритм подписи для этого объекта JarSigner.

Возвращаемое значение никогда не равно null.

Возвращает:: алгоритм подписи.

getTsa

public URI getTsa()

Возвращает URI службы штампов времени (TSA).

Возвращает:: URI службы TSA.

getSignerName

public String getSignerName()

Возвращает имя подписывающего лица для этого объекта JarSigner.

Возвращаемое значение никогда не равно null.

Возвращает:: имя подписывающего лица.

getProperty

public String getProperty(String key)

Возвращает значение дополнительного свойства, зависящего от реализации и указанного заданным ключом. Если свойство не задано, но имеет значение по умолчанию, будет возвращено значение по умолчанию.

Примечание по реализации:: Список свойств, поддерживаемых этой реализацией, см. в разделе JarSigner.Builder.setProperty(String, String). Имена всех свойств не чувствительны к регистру.
Параметры:: key — имя свойства.
Возвращает:: значение свойства.
Исключения:: UnsupportedOperationException — если этот ключ не поддерживается данной реализацией.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/jdk.jartool/jdk/security/jarsigner/JarSigner.html