SignatureSpi (Java Platform SE 8 )

java.lang.Object
- java.security.SignatureSpi

已知直接子类：

Signature
```
public abstract class SignatureSpi
extends Object
```
这个类定义的（SPI） Signature类，它用于提供一个数字签名算法的功能。数字签名用于数字数据的认证和完整性保证。。
该类中的所有抽象方法必须由希望提供特定签名算法的实现的每个加密服务提供商来实现。

另请参见：

Signature

Field Summary

Fields
Modifier and Type	Field and Description
`protected SecureRandom`	`appRandom` 应用指定的随机源。

构造方法摘要

构造方法
Constructor and Description
`SignatureSpi()`

方法摘要

所有方法接口方法抽象方法具体的方法弃用的方法
Modifier and Type	Method and Description
`Object`	`clone()` 如果实现是可克隆的，则返回克隆。
`protected abstract Object`	`engineGetParameter(String param)` 已弃用
`protected AlgorithmParameters`	`engineGetParameters()` 提供者覆盖此方法以返回与此签名引擎一起使用的参数，如果此签名引擎不使用任何参数，则返回null。
`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)` 以指定的偏移量开始，以指定的字节数组验证传入签名。

Methods inherited from class java.lang.Object
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 - 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 - 要验证的签名字节。
    
    结果
    
    如果签名被验证，则为真，否则为false。
    
    异常
    
    SignatureException - 如果引擎未正确初始化，则传入的签名被错误地编码或错误的类型，如果该签名算法不能处理提供的输入数据等。
  - engineVerify
```
protected boolean engineVerify(byte[] sigBytes,
                               int offset,
                               int length)
                        throws SignatureException
```
    以指定的偏移量开始，以指定的字节数组验证传入签名。
    注意：子类应该覆盖默认实现。
    
    参数
    
    sigBytes - 要验证的签名字节。
    
    offset - 从字节数组开始的偏移量。
    
    length - 从偏移开始使用的字节数。
    
    结果
    
    如果签名被验证，则为真，否则为false。
    
    异常
    
    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()
```
    提供者覆盖此方法以返回与此签名引擎一起使用的参数，如果此签名引擎不使用任何参数，则返回null。
    
    返回的参数可能与用于初始化此签名引擎的参数相同，或者如果该签名引擎需要算法参数但未被任何初始化，则可能包含由底层签名实现使用的默认和随机生成的参数值的组合。
    
    结果
    
    与此签名引擎一起使用的参数，如果此签名引擎不使用任何参数，则为null
    
    异常
    
    UnsupportedOperationException - 如果此方法不被提供程序覆盖
    
    从以下版本开始：
    
    1.4
  - engineGetParameter
```
@Deprecated
protected abstract Object engineGetParameter(String param)
                                                  throws InvalidParameterException
```
    已弃用
    
    获取指定算法参数的值。该方法提供通用机制，通过该机制可以获得该对象的各种参数。参数可以是算法的任何可设置参数，诸如参数大小，或用于签名生成的随机比特来源（如果适用）），或者是否执行特定但可选择的计算的指示。每个参数的统一的算法特定命名方案是可取的，但在此时未指定。
    
    参数
    
    param - 参数的字符串名称。
    
    结果
    
    表示参数值的对象，如果没有，则为null。
    
    异常
    
    InvalidParameterException - 如果 param是此引擎的无效参数，或尝试获取此参数时发生另一个异常。
  - clone
```
public Object clone()
             throws CloneNotSupportedException
```
    如果实现是可克隆的，则返回克隆。
    
    重写：
    
    clone在 Object
    
    结果
    
    一个克隆，如果实现是可克隆的。
    
    异常
    
    CloneNotSupportedException - 如果这是在不支持 Cloneable 。
    
    另请参见：
    
    Cloneable

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class SignatureSpi

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

appRandom

构造方法详细信息

SignatureSpi

方法详细信息

engineInitVerify

engineInitSign

engineInitSign

engineUpdate

engineUpdate

engineUpdate

engineSign

engineSign

engineVerify

engineVerify

engineSetParameter

engineSetParameter

engineGetParameters

engineGetParameter

clone