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

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 также использует свойство jdk.security.provider.preferred Security для определения предпочтительного порядка поставщиков для указанного алгоритма. Этот порядок может отличаться от порядка поставщиков, возвращаемых методом Security.getProviders().

Параметры:

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

Возвращает:

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

Выбрасывает:

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

NullPointerException — если algorithm равно null

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

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

См. также:

• Provider

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

Параметры:

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

Параметры:

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

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

Возвращает:

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

Выбрасывает:

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

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

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