javax.crypto

Class KeyAgreementSpi

java.lang.Object

javax.crypto.KeyAgreementSpi

public abstract class KeyAgreementSpi
extends Object

这个类定义了服务提供者接口（ SPI）为 KeyAgreement类。在这个类中的所有的抽象方法必须实现由每个密码服务提供商，谁希望提供一个特定的密钥协商算法的实现。

参与建立一个共享的秘密密钥的密钥生成器创建（KeyPairGenerator或KeyGenerator），一个KeyFactory，或由于密钥协商协议的一个中间阶段（engineDoPhase）。

每个记者在密钥交换，engineDoPhase需要叫。例如，如果密钥交换与另一方，engineDoPhase需要调用一次，将true的lastPhase旗。如果密钥交换与其他两方，engineDoPhase需要调用两次，第一次设置lastPhase旗false，第二时间设置为true。有可能有任何数量的参与密钥交换的缔约方。

从以下版本开始：

一点四

另请参见：

KeyGenerator， SecretKey

构造方法摘要

构造方法

Constructor and Description
KeyAgreementSpi()

方法摘要

Modifier and Type	Method and Description
protected abstract Key	engineDoPhase(Key key, boolean lastPhase) 执行本密钥协议的下一阶段，该密钥协议的下一阶段是从该密钥协议中的另一方接收的给定密钥中执行的。
protected abstract byte[]	engineGenerateSecret() 生成共享密钥，并将其返回到一个新的缓冲区中。
protected abstract int	engineGenerateSecret(byte[] sharedSecret, int offset) 生成共享密钥，并将其写入缓冲区， sharedSecret，在 offset包容开始。
protected abstract SecretKey	engineGenerateSecret(String algorithm) 创建共享密钥，并将其作为所请求的算法类型的密钥对象返回。
protected abstract void	engineInit(Key key, AlgorithmParameterSpec params, SecureRandom random) 初始化密钥协商与给定的键，设置算法参数，并随机源。
protected abstract void	engineInit(Key key, SecureRandom random) 初始化密钥协商的密钥和随机源。

Methods inherited from class java.lang.Object

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

Constructor Detail

KeyAgreementSpi

public KeyAgreementSpi()

方法详细信息

engineInit

protected abstract void engineInit(Key key,
                                   SecureRandom random)
                            throws InvalidKeyException

初始化密钥协商的密钥和随机源。给定的密钥是必需的包含此密钥协议所需的所有的算法参数。

如果密钥协议算法需要随机字节，它会从随机给定的源，random。然而，如果底层算法的实现不需要任何随机字节，random被忽略。

参数

key -党的私人信息。例如，在Diffie-Hellman密钥交换协议的情况下，这将是党自身的Diffie-Hellman密钥。

random -随机源

异常

InvalidKeyException -如果它的键是不适合这个关键协议，例如，是错误的类型或具有不兼容的算法类型。

engineInit

protected abstract void engineInit(Key key,
                                   AlgorithmParameterSpec params,
                                   SecureRandom random)
                            throws InvalidKeyException,
                                   InvalidAlgorithmParameterException

初始化密钥协商与给定的键，设置算法参数，并随机源。

参数

key -党的私人信息。例如，在Diffie-Hellman密钥交换协议的情况下，这将是党自身的Diffie-Hellman密钥。

params的关键协议参数

random -随机源

异常

InvalidKeyException -如果它的键是不适合这个关键协议，例如，是错误的类型或具有不兼容的算法类型。

InvalidAlgorithmParameterException如果给定参数的密钥协商是不合适的。

engineDoPhase

protected abstract Key engineDoPhase(Key key,
                                     boolean lastPhase)
                              throws InvalidKeyException,
                                     IllegalStateException

执行本密钥协议的下一阶段，该密钥协议的下一阶段是从该密钥协议中的另一方接收的给定密钥中执行的。

参数

key -这一阶段的关键。例如，在Diffie-Hellman之间2方的情况下，这将是另一方的Diffie-Hellman公钥。

lastPhase国旗说明这是否是这个关键协议的最后阶段。

结果

由这个阶段产生的（中间）键，或为空，如果这个阶段不产生一个键

异常

InvalidKeyException -如果给定的关键是不适合这个阶段。

IllegalStateException -如果这关键协议尚未初始化。

engineGenerateSecret

protected abstract byte[] engineGenerateSecret()
                                        throws IllegalStateException

生成共享密钥，并将其返回到一个新的缓冲区中。

这个方式将这KeyAgreementSpi对象，这样可以进一步关键协议。除非这个关键协议初始化的一个engineInit方法相同的私人信息和算法参数将用于后续的关键协议。

结果

共享密钥的新缓冲区

异常

IllegalStateException -如果这关键协议尚未完成

engineGenerateSecret

protected abstract int engineGenerateSecret(byte[] sharedSecret,
                                            int offset)
                                     throws IllegalStateException,
                                            ShortBufferException

生成共享密钥，并将其写入缓冲区， sharedSecret，在 offset包容开始。

如果sharedSecret缓冲太小装不下的结果，一个ShortBufferException抛出。在这种情况下，这个调用应该重复一个较大的输出缓冲区。

这个方式将这KeyAgreementSpi对象，这样可以进一步关键协议。除非这个关键协议初始化的一个engineInit方法相同的私人信息和算法参数将用于后续的关键协议。

参数

sharedSecret -共享秘密的缓冲

offset -抵消 sharedSecret在共享的秘密将被存储

结果

放入 sharedSecret字节数

异常

IllegalStateException -如果这关键协议尚未完成

ShortBufferException如果给定的输出缓冲区太小，容纳的秘密

engineGenerateSecret

protected abstract SecretKey engineGenerateSecret(String algorithm)
                                           throws IllegalStateException,
                                                  NoSuchAlgorithmException,
                                                  InvalidKeyException

创建共享密钥，并将其作为所请求的算法类型的密钥对象返回。

这个方式将这KeyAgreementSpi对象，这样可以进一步关键协议。除非这个关键协议初始化的一个engineInit方法相同的私人信息和算法参数将用于后续的关键协议。

参数

algorithm -请求的密钥算法

结果

共享密钥

异常

IllegalStateException -如果这关键协议尚未完成

NoSuchAlgorithmException如果请求的密钥算法是不可

InvalidKeyException如果共享密钥材料不能用于生成一个密钥请求算法的类型（例如，关键材料太短）