java.security

Класс SignatureSpi

java.lang. Объект

java.security. SignatureSpi

Прямые Известные Подклассы:

Подпись

public abstract class SignatureSpi
extends Object

Этот класс определяет Интерфейс Поставщика услуг (SPI) для Signature класс, который используется, чтобы обеспечить функциональность алгоритма цифровой подписи. Цифровые подписи используются для аутентификации и обеспечения целостности цифровых данных..

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

См. Также:

Signature

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected SecureRandom	appRandom Определенный приложением источник случайности.

Сводка конструктора

Конструкторы

Конструктор и Описание
SignatureSpi()

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Объект	clone() Возвращает клона, если реализация является cloneable.
protected abstract Object	engineGetParameter(String param) Осуждаемый.
protected AlgorithmParameters	engineGetParameters() Этот метод переопределяется провайдерами, чтобы возвратить параметры, используемые с этим механизмом подписи, или нулем, если этот механизм подписи не использует параметров.
protected abstract void	engineInitSign(PrivateKey privateKey) Инициализирует этот объект подписи с указанным закрытым ключом для того, чтобы подписать операции.
protected void	engineInitSign(PrivateKey privateKey, SecureRandom random) Инициализирует этот объект подписи с указанным закрытым ключом и источником случайности для того, чтобы подписать операции.
protected abstract void	engineInitVerify(PublicKey publicKey) Инициализирует этот объект подписи с указанным открытым ключом для операций проверки.
protected void	engineSetParameter(AlgorithmParameterSpec params) Этот метод переопределяется провайдерами, чтобы инициализировать этот механизм подписи с указанным набором параметра.
protected abstract void	engineSetParameter(String param, Object value) Осуждаемый. Замененный engineSetParameter.
protected abstract byte[]	engineSign() Возвращает байты подписи всех данных, обновляемых до сих пор.
protected int	engineSign(byte[] outbuf, int offset, int len) Концы эта работа подписи и хранилища получающиеся байты подписи в обеспеченном буфере outbuf, запуск в offset.
protected abstract void	engineUpdate(byte b) Обновляет данные, которые будут подписаны, или проверял использование указанного байта.
protected abstract void	engineUpdate(byte[] b, int off, int len) Обновляет данные, которые будут подписаны или проверены, используя указанный массив байтов, запускаясь при указанном смещении.
protected void	engineUpdate(ByteBuffer input) Обновляет данные, которые будут подписаны, или проверял использование указанного ByteBuffer.
protected abstract boolean	engineVerify(byte[] sigBytes) Проверяет переданный - в подписи.
protected boolean	engineVerify(byte[] sigBytes, int offset, int length) Проверяет переданный - в подписи в указанном массиве байтов, запускающихся при указанном смещении.

Методы java.lang унаследованный от класса. Объект

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

Полевая Деталь

appRandom

protected SecureRandom appRandom

Определенный приложением источник случайности.

Деталь конструктора

SignatureSpi

public SignatureSpi()

Деталь метода

engineInitVerify

protected abstract void engineInitVerify(PublicKey publicKey)
                                  throws InvalidKeyException

Инициализирует этот объект подписи с указанным открытым ключом для операций проверки.

Параметры:

publicKey - открытый ключ идентификационных данных, подпись которых собирается быть проверенной.

Броски:

InvalidKeyException - если ключ ненадлежащим образом кодируется, параметры отсутствуют и так далее.

engineInitSign

protected abstract void engineInitSign(PrivateKey privateKey)
                                throws InvalidKeyException

Инициализирует этот объект подписи с указанным закрытым ключом для того, чтобы подписать операции.

Параметры:

privateKey - закрытый ключ идентификационных данных, подпись которых будет сгенерирована.

Броски:

InvalidKeyException - если ключ ненадлежащим образом кодируется, параметры отсутствуют и так далее.

engineInitSign

protected void engineInitSign(PrivateKey privateKey,
                  SecureRandom random)
                       throws InvalidKeyException

Инициализирует этот объект подписи с указанным закрытым ключом и источником случайности для того, чтобы подписать операции.

Этот конкретный метод был добавлен к этому ранее определенному абстрактному классу. (Для назад совместимости это не может быть абстрактно.)

Параметры:

privateKey - закрытый ключ идентификационных данных, подпись которых будет сгенерирована.

random - источник случайности

Броски:

InvalidKeyException - если ключ ненадлежащим образом кодируется, параметры отсутствуют и так далее.

engineUpdate

protected abstract void engineUpdate(byte b)
                              throws SignatureException

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

Параметры:

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

Броски:

SignatureException - если механизм не инициализируется должным образом.

engineUpdate

protected abstract void engineUpdate(byte[] b,
                int off,
                int len)
                              throws SignatureException

Обновляет данные, которые будут подписаны или проверены, используя указанный массив байтов, запускаясь при указанном смещении.

Параметры:

b - массив байтов

off - смещение, чтобы запуститься с в массиве байтов

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

Броски:

SignatureException - если механизм не инициализируется должным образом

engineUpdate

protected void engineUpdate(ByteBuffer input)

Обновляет данные, которые будут подписаны, или проверял использование указанного ByteBuffer. Процессы data.remaining() байты, запускающиеся в в data.position(). По возврату позиция буфера будет равна своему пределу; его предел не будет изменяться.

Параметры:

input - ByteBuffer

С тех пор:

1.5

engineSign

protected abstract byte[] engineSign()
                              throws SignatureException

Возвращает байты подписи всех данных, обновляемых до сих пор. Формат подписи зависит от базовой схемы подписи.

Возвраты:

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

Броски:

SignatureException - если механизм не инициализируется должным образом или если этот алгоритм подписи неспособен обработать входные обеспеченные данные.

engineSign

protected int engineSign(byte[] outbuf,
             int offset,
             int len)
                  throws SignatureException

Концы эта работа подписи и хранилища получающиеся байты подписи в обеспеченном буфере outbuf, запуск в offset. Формат подписи зависит от базовой схемы подписи.

Реализация подписи сбрасывается к ее начальному состоянию (состояние, в котором это было после звонка в один из engineInitSign методы), и может быть снова использован, чтобы генерировать дальнейшие подписи с тем же самым закрытым ключом. Этот метод должен быть абстрактным, но мы оставляем его бетоном для совместимости на уровне двоичных кодов. Хорошо осведомленные провайдеры должны переопределить этот метод.

Параметры:

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

offset - смещение в outbuf где подпись сохранена.

len - число байтов в пределах outbuf выделенный для подписи. И эта реализация по умолчанию и провайдер SUN не возвращают частичные обзоры. Если значение этого параметра будет меньше чем фактическая длина подписи, то этот метод бросит SignatureException. Этот параметр игнорируется, если его значение больше чем или равно фактической длине подписи.

Возвраты:

число байтов, помещенных в outbuf

Броски:

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

С тех пор:

1.2

engineVerify

protected abstract boolean engineVerify(byte[] sigBytes)
                                 throws SignatureException

Проверяет переданный - в подписи.

Параметры:

sigBytes - байты подписи, которые будут проверены.

Возвраты:

истина, если подпись была проверена, ложь если нет.

Броски:

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

engineVerify

protected boolean engineVerify(byte[] sigBytes,
                   int offset,
                   int length)
                        throws SignatureException

Проверяет переданный - в подписи в указанном массиве байтов, запускающихся при указанном смещении.

Отметьте: Подклассы должны перезаписать реализацию по умолчанию.

Параметры:

sigBytes - байты подписи, которые будут проверены.

offset - смещение, чтобы запуститься с в массиве байтов.

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

Возвраты:

истина, если подпись была проверена, ложь если нет.

Броски:

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

С тех пор:

1.4

engineSetParameter

@Deprecated
protected abstract void engineSetParameter(String param,
                                 Object value)
                                    throws InvalidParameterException

Осуждаемый. Замененный engineSetParameter.

Устанавливает указанные параметры алгоритма к указанному значению. Этот метод предоставляет механизм общего назначения, через который возможно установить различные параметры этого объекта. Параметр может быть любым устанавливаемым параметром для алгоритма, такого как размер параметра, или источник случайных битов для генерации подписи (если соответствующий), или индикация относительно того, выполнить ли определенное, но дополнительное вычисление. Универсальная специфичная для алгоритма схема именования для каждого параметра является требуемой, но левая неуказанный в это время.

Параметры:

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

value - значение параметра.

Броски:

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

engineSetParameter

protected void engineSetParameter(AlgorithmParameterSpec params)
                           throws InvalidAlgorithmParameterException

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

Параметры:

params - параметры

Броски:

UnsupportedOperationException - если этот метод не переопределяется провайдером

InvalidAlgorithmParameterException - если этот метод переопределяется провайдером, и данные параметры являются несоответствующими для этого механизма подписи

engineGetParameters

protected AlgorithmParameters engineGetParameters()

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

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

Возвраты:

параметры, используемые с этим механизмом подписи, или нулем, если этот механизм подписи не использует параметров

Броски:

UnsupportedOperationException - если этот метод не переопределяется провайдером

С тех пор:

1.4

engineGetParameter

@Deprecated
protected abstract Object engineGetParameter(String param)
                                      throws InvalidParameterException

Осуждаемый.

Получает значение указанного параметра алгоритма. Этот метод предоставляет механизм общего назначения, через который возможно получить различные параметры этого объекта. Параметр может быть любым устанавливаемым параметром для алгоритма, такого как размер параметра, или источник случайных битов для генерации подписи (если соответствующий), или индикация относительно того, выполнить ли определенное, но дополнительное вычисление. Универсальная специфичная для алгоритма схема именования для каждого параметра является требуемой, но левая неуказанный в это время.

Параметры:

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

Возвраты:

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

Броски:

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

клон

public Object clone()
             throws CloneNotSupportedException

Возвращает клона, если реализация является cloneable.

Переопределения:

clone в классе Object

Возвраты:

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

Броски:

CloneNotSupportedException - если это вызывают на реализации, которая не поддерживает Cloneable.

См. Также:

Cloneable