Сигнатура класса

protected static final int UNINITIALIZED

См. также:

• Значения констант полей

protected static final int SIGN

См. также:

• Значения констант полей

protected static final int VERIFY

См. также:

• Значения констант полей

protected int state

protected Signature(String algorithm)

Параметры:

algorithm — стандартное строковое имя алгоритма. Сведения о стандартных именах алгоритмов см. в разделе Signature документа «Спецификация стандартных имён алгоритмов безопасности Java».

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

public static Signature getInstance(String algorithm) throws NoSuchAlgorithmException

Примечание по реализации:

Реализация JDK Reference Implementation дополнительно использует следующие свойства безопасности:

• свойство jdk.security.provider.preferred Security для определения предпочтительного порядка поставщиков для указанного алгоритма. Этот порядок может отличаться от порядка поставщиков, возвращаемых методом Security.getProviders().
• свойство jdk.crypto.disabledAlgorithms Security для определения того, разрешён ли указанный алгоритм. Если задано значение jdk.crypto.disabledAlgorithms, оно имеет приоритет над значением свойства безопасности.

Параметры:

algorithm — стандартное имя запрошенного алгоритма. Сведения о стандартных именах алгоритмов см. в разделе Signature документа «Спецификация стандартных имён алгоритмов безопасности Java».

Возвращает:

новый объект Signature

Исключения:

NoSuchAlgorithmException — если ни один Provider не поддерживает реализацию Signature для указанного алгоритма

NullPointerException — если algorithm имеет значение null

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

См. также:

• Provider

public static Signature getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException

Примечание по реализации:

Реализация JDK Reference Implementation дополнительно использует свойство jdk.crypto.disabledAlgorithms Security для определения того, разрешён ли указанный алгоритм. Если задано значение jdk.crypto.disabledAlgorithms, оно имеет приоритет над значением свойства безопасности.

Параметры:

algorithm — имя запрошенного алгоритма. Сведения о стандартных именах алгоритмов см. в разделе Signature документа «Спецификация стандартных имён алгоритмов безопасности Java».

provider — имя поставщика.

Возвращает:

новый объект Signature

Исключения:

IllegalArgumentException — если имя поставщика равно null или является пустым

NoSuchAlgorithmException — если указанный поставщик не предоставляет реализацию SignatureSpi для указанного алгоритма

NoSuchProviderException — если указанный поставщик не зарегистрирован в списке поставщиков служб безопасности

NullPointerException — если algorithm имеет значение null

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

См. также:

• Provider

public static Signature getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException

Примечание по реализации:

Реализация JDK Reference Implementation дополнительно использует свойство jdk.crypto.disabledAlgorithms Security для определения того, разрешён ли указанный алгоритм. Если задано значение jdk.crypto.disabledAlgorithms, оно имеет приоритет над значением свойства безопасности.

Параметры:

algorithm — имя запрошенного алгоритма. Сведения о стандартных именах алгоритмов см. в разделе Signature документа «Спецификация стандартных имён алгоритмов безопасности Java».

provider — поставщик.

Возвращает:

новый объект Signature

Исключения:

IllegalArgumentException — если поставщик равен null

NoSuchAlgorithmException — если указанный объект Provider не предоставляет реализацию SignatureSpi для указанного алгоритма

NullPointerException — если algorithm имеет значение null

Начиная с:

1.4

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

См. также:

• Provider

public final Provider getProvider()

Возвращает:

поставщика этого объекта Signature

public final void initVerify(PublicKey publicKey) throws InvalidKeyException

Параметры:

publicKey — открытый ключ субъекта, чья подпись будет проверяться.

Исключения:

InvalidKeyException — если ключ недействителен.

public final void initVerify(Certificate certificate) throws InvalidKeyException

Параметры:

certificate — сертификат субъекта, чья подпись будет проверяться.

Исключения:

InvalidKeyException — если открытый ключ в сертификате имеет неправильное кодирование, не содержит необходимой информации о параметрах или не может использоваться для создания цифровой подписи.

Начиная с:

1.3

public final void initSign(PrivateKey privateKey) throws InvalidKeyException

Параметры:

privateKey — закрытый ключ субъекта, подпись которого будет создана.

Исключения:

InvalidKeyException — если ключ недействителен.

public final void initSign(PrivateKey privateKey, SecureRandom random) throws InvalidKeyException

Параметры:

privateKey — закрытый ключ субъекта, подпись которого будет создана

random — источник случайных данных для этого объекта Signature

Исключения:

InvalidKeyException — если ключ недействителен.

public final byte[] sign() throws SignatureException

Возвращает:

байты подписи, полученные в результате операции подписания.

Исключения:

SignatureException — если объект Signature не инициализирован должным образом или если этот алгоритм подписи не может обработать предоставленные входные данные.

public final int sign(byte[] outbuf, int offset, int len) throws SignatureException

Параметры:

outbuf — буфер для результата подписания.

offset — смещение в outbuf, по которому сохраняется подпись.

len — количество байтов в outbuf, выделенных для подписи.

Возвращает:

количество байтов, записанных в outbuf.

Исключения:

SignatureException — если объект Signature не инициализирован должным образом, если этот алгоритм подписи не может обработать предоставленные входные данные или если значение len меньше фактической длины подписи.

IllegalArgumentException — если outbuf равно null, offset или len меньше 0 либо сумма offset и len больше длины outbuf.

Начиная с:

1.2

public final boolean verify(byte[] signature) throws SignatureException

Параметры:

signature — байты подписи для проверки.

Возвращает:

true, если подпись прошла проверку, и false в противном случае.

Исключения:

SignatureException — если объект Signature не инициализирован должным образом, переданная подпись имеет неправильное кодирование или тип, этот алгоритм подписи не может обработать предоставленные входные данные и т. п.

public final boolean verify(byte[] signature, int offset, int length) throws SignatureException

Параметры:

signature — байты подписи для проверки.

offset — начальное смещение в массиве байтов.

length — количество используемых байтов, начиная со смещения.

Возвращает:

true, если подпись прошла проверку, и false в противном случае.

Исключения:

SignatureException — если объект Signature не инициализирован должным образом, переданная подпись имеет неправильное кодирование или тип, этот алгоритм подписи не может обработать предоставленные входные данные и т. п.

IllegalArgumentException — если массив байтов signature равен null, offset или length меньше 0 либо сумма offset и length больше длины массива байтов signature.

Начиная с:

1.4

public final void update(byte b) throws SignatureException

Параметры:

b — байт, используемый для обновления.

Исключения:

SignatureException — если объект Signature не инициализирован должным образом.

public final void update(byte[] data) throws SignatureException

Параметры:

data — массив байтов, используемый для обновления.

Исключения:

SignatureException — если объект Signature не инициализирован должным образом.

public final void update(byte[] data, int off, int len) throws SignatureException

Параметры:

data — массив байтов.

off — начальное смещение в массиве байтов.

len — количество используемых байтов, начиная со смещения.

Исключения:

SignatureException — если объект Signature не инициализирован должным образом.

IllegalArgumentException — если data равно null, off или len меньше 0 либо сумма off и len больше длины data.

public final void update(ByteBuffer data) throws SignatureException

Параметры:

data — ByteBuffer

Исключения:

SignatureException — если объект Signature не инициализирован должным образом.

Начиная с:

1.5

public final String getAlgorithm()

Возвращает:

имя алгоритма для этого объекта Signature.

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

строковое представление этого объекта Signature.

@Deprecated public final void setParameter(String param, Object value) throws InvalidParameterException

Параметры:

param — строковый идентификатор параметра

value — значение параметра

Исключения:

InvalidParameterException — если param является недопустимым параметром для этого объекта Signature, параметр уже задан и не может быть задан повторно, возникает исключение безопасности и т. п.

См. также:

• getParameter(String)

public final void setParameter(AlgorithmParameterSpec params) throws InvalidAlgorithmParameterException

Параметры:

params — значения параметров

Исключения:

InvalidAlgorithmParameterException — если указанные значения параметров не подходят для этого объекта Signature

См. также:

• getParameters()

public final AlgorithmParameters getParameters()

Возвращает:

параметры, используемые этим объектом Signature, или null

Исключения:

UnsupportedOperationException — если поставщик не поддерживает этот метод

Начиная с:

1.4

См. также:

• setParameter(AlgorithmParameterSpec)

@Deprecated public final Object getParameter(String param) throws InvalidParameterException

Параметры:

param — строковое имя параметра.

Возвращает:

объект, представляющий значение параметра, или null, если такого значения нет.

Исключения:

InvalidParameterException — если param является недопустимым параметром для этого механизма или при попытке получить этот параметр возникает другое исключение.

См. также:

• setParameter(String, Object)

public Object clone() throws CloneNotSupportedException

Переопределяет:

clone в классе SignatureSpi

Возвращает:

клон, если реализация поддерживает клонирование.

Исключения:

CloneNotSupportedException — если этот метод вызван для реализации, не поддерживающей Cloneable.

См. также:

• Cloneable