Класс JarSigner

java.lang.Object

jdk.security.jarsigner.JarSigner

public final class JarSigner extends Object

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

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

Если не указано иное, вызов метода JarSigner или JarSigner.Builder с нулевым аргументом вызовет 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);
    }

Since:: 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`.

Методы, унаследованные от класса java.lang.Object

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

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

sign

public void sign(ZipFile file, OutputStream os)

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

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

Parameters:: file - подписываемый файл.; os - выходной поток.
Throws:: JarSignerException - если подпись не удалась.

getDigestAlgorithm

public String getDigestAlgorithm()

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

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

Returns:: алгоритм дайджеста.

getSignatureAlgorithm

public String getSignatureAlgorithm()

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

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

Returns:: алгоритм подписи.

getTsa

public URI getTsa()

Возвращает URI центра временной маркировки (TSA).

Returns:: URI TSA.

getSignerName

public String getSignerName()

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

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

Returns:: имя подписывающего агента.

getProperty

public String getProperty(String key)

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

Implementation Note:: См. JarSigner.Builder.setProperty(java.lang.String, java.lang.String) для списка свойств, поддерживаемых этой реализацией. Все имена свойств регистронезависимы.
Parameters:: key - имя свойства.
Returns:: значение свойства.
Throws:: UnsupportedOperationException - если ключ не поддерживается этой реализацией.

© 1993, 2023, 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/21/docs/api/jdk.jartool/jdk/security/jarsigner/JarSigner.html