Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class SignatureSpi extends Object
Signature
class, который используется, чтобы обеспечить функциональность алгоритма цифровой подписи. Цифровые подписи используются для аутентификации и обеспечения целостности цифровых данных.. Все абстрактные методы в этом class должны быть реализованы каждым провайдером криптографических служб, который хочет предоставить реализацию определенного алгоритма подписи.
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)
Проверяет переданный - в подписи в указанном массиве байтов, запускающихся при указанном смещении.
|
protected SecureRandom appRandom
protected abstract void engineInitVerify(PublicKey publicKey) throws InvalidKeyException
publicKey
- открытый ключ идентификационных данных, подпись которых собирается быть проверенной.InvalidKeyException
- если ключ ненадлежащим образом кодируется, параметры отсутствуют и так далее.protected abstract void engineInitSign(PrivateKey privateKey) throws InvalidKeyException
privateKey
- закрытый ключ идентификационных данных, подпись которых будет сгенерирована.InvalidKeyException
- если ключ ненадлежащим образом кодируется, параметры отсутствуют и так далее.protected void engineInitSign(PrivateKey privateKey, SecureRandom random) throws InvalidKeyException
Этот конкретный метод был добавлен к этому ранее определенному абстрактному class. (Для назад совместимости это не может быть абстрактно.)
privateKey
- закрытый ключ идентификационных данных, подпись которых будет сгенерирована.random
- источник случайностиInvalidKeyException
- если ключ ненадлежащим образом кодируется, параметры отсутствуют и так далее.protected abstract void engineUpdate(byte b) throws SignatureException
b
- байт, чтобы использовать для обновления.SignatureException
- если механизм не инициализируется должным образом.protected abstract void engineUpdate(byte[] b, int off, int len) throws SignatureException
b
- массив байтовoff
- смещение, чтобы запуститься с в массиве байтовlen
- число байтов, чтобы использовать, запускаясь при смещенииSignatureException
- если механизм не инициализируется должным образомprotected void engineUpdate(ByteBuffer input)
data.remaining()
байты, запускающиеся в в data.position()
. По возврату позиция буфера будет равна своему пределу; его предел не будет изменяться.input
- ByteBufferprotected abstract byte[] engineSign() throws SignatureException
SignatureException
- если механизм не инициализируется должным образом или если этот алгоритм подписи неспособен обработать входные обеспеченные данные.protected int engineSign(byte[] outbuf, int offset, int len) throws SignatureException
outbuf
, запуск в offset
. Формат подписи зависит от базовой схемы подписи. Реализация подписи сбрасывается к ее начальному состоянию (состояние, в котором это было после звонка в один из engineInitSign
методы), и может быть снова использован, чтобы генерировать дальнейшие подписи с тем же самым закрытым ключом. Этот метод должен быть абстрактным, но мы оставляем его бетоном для совместимости на уровне двоичных кодов. Хорошо осведомленные провайдеры должны переопределить этот метод.
outbuf
- буфер для результата подписи.offset
- смещение в outbuf
где подпись сохранена.len
- число байтов в пределах outbuf
выделенный для подписи. И эта реализация по умолчанию и провайдер SUN не возвращают частичные обзоры. Если значение этого параметра будет меньше чем фактическая длина подписи, то этот метод бросит SignatureException. Этот параметр игнорируется, если его значение больше чем или равно фактической длине подписи.outbuf
SignatureException
- если механизм не инициализируется должным образом, если этот алгоритм подписи неспособен обработать входные данные если, или если len
меньше чем фактическая длина подписи.protected abstract boolean engineVerify(byte[] sigBytes) throws SignatureException
sigBytes
- байты подписи, которые будут проверены.SignatureException
- если механизм не инициализируется должным образом, переданный - в подписи ненадлежащим образом кодируется или неправильного типа, если этот алгоритм подписи неспособен обработать входные данные если и т.д.protected boolean engineVerify(byte[] sigBytes, int offset, int length) throws SignatureException
Отметьте: Подклассы должны перезаписать реализацию по умолчанию.
sigBytes
- байты подписи, которые будут проверены.offset
- смещение, чтобы запуститься с в массиве байтов.length
- число байтов, чтобы использовать, запускаясь при смещении.SignatureException
- если механизм не инициализируется должным образом, переданный - в подписи ненадлежащим образом кодируется или неправильного типа, если этот алгоритм подписи неспособен обработать входные данные если и т.д.@Deprecated protected abstract void engineSetParameter(String param, Object value) throws InvalidParameterException
engineSetParameter
.param
- строковый идентификатор параметра.value
- значение параметра.InvalidParameterException
- если param
недопустимый параметр для этого механизма алгоритма подписи, параметры уже устанавливаются и не могут быть установлены снова, исключение безопасности происходит и так далее.protected void engineSetParameter(AlgorithmParameterSpec params) throws InvalidAlgorithmParameterException
Этот метод переопределяется провайдерами, чтобы инициализировать этот механизм подписи с указанным набором параметра.
params
- параметрыUnsupportedOperationException
- если этот метод не переопределяется провайдеромInvalidAlgorithmParameterException
- если этот метод переопределяется провайдером, и данные параметры являются несоответствующими для этого механизма подписиprotected AlgorithmParameters engineGetParameters()
Этот метод переопределяется провайдерами, чтобы возвратить параметры, используемые с этим механизмом подписи, или нулем, если этот механизм подписи не использует параметров.
Возвращенные параметры могут быть тем же самым, которые использовались, чтобы инициализировать этот механизм подписи, или могут содержать комбинацию значения по умолчанию и в произвольном порядке сгенерированных значений параметра, используемых базовой реализацией подписи, если этот механизм подписи требует параметров алгоритма, но не был инициализирован ни с кем.
UnsupportedOperationException
- если этот метод не переопределяется провайдером@Deprecated protected abstract Object engineGetParameter(String param) throws InvalidParameterException
param
- имя строки параметра.InvalidParameterException
- если param
недопустимый параметр для этого механизма, или другое исключение происходит, пытаясь получить этот параметр.public Object clone() throws CloneNotSupportedException
clone
в class Object
CloneNotSupportedException
- если это вызывают на реализации, которая не поддерживает Cloneable
.Cloneable
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92