CipherSpi

CipherSpi

CipherSpi ()

engineDoFinal

int engineDoFinal (byte[] input, 
                int inputOffset, 
                int inputLen, 
                byte[] output, 
                int outputOffset)

在单部分操作中加密或解密数据，或完成多部分操作。 数据被加密或解密，取决于这个密码是如何初始化的。

第一inputLen字节在input缓冲区中，从inputOffset以下，并且可能在上一次期间已缓存的任何输入字节update操作，进行处理，填充（如果要求）被施加。 如果使用诸如GCM / CCM的AEAD模式，则在加密的情况下附加认证标签，或者在解密的情况下验证。 结果存储在output缓冲区中，从outputOffset开始（包括outputOffset 。

如果 output缓冲区太小而无法保存结果， ShortBufferException抛出 ShortBufferException 。

完成后，此方法会将此密码对象重置为之前通过调用engineInit初始化时的状态。 也就是说，该对象被重置并可用于加密或解密（取决于调用engineInit时指定的操作模式）更多数据。

注意：如果抛出任何异常，则可能需要重置此密码对象才能再次使用它。

engineDoFinal

int engineDoFinal (ByteBuffer input, 
                ByteBuffer output)

在单部分操作中加密或解密数据，或完成多部分操作。 数据被加密或解密，取决于这个密码是如何初始化的。

所有input.remaining()起始字节input.position()被处理。 如果使用诸如GCM / CCM的AEAD模式，则在加密的情况下附加认证标签，或者在解密的情况下验证。 结果存储在输出缓冲区中。 返回时，输入缓冲区的位置将等于它的限制; 其限制不会改变。 输出缓冲区的位置将前进n，其中n是此方法返回的值; 输出缓冲区的限制不会改变。

如果 output.remaining()字节不足以保存结果，则引发 ShortBufferException 。

完成后，此方法会将此密码对象重置为之前通过调用engineInit初始化时的状态。 也就是说，该对象被重置并可用于加密或解密（取决于调用engineInit时指定的操作模式）更多数据。

注意：如果抛出任何异常，则可能需要重置此密码对象才能再次使用它。

如果子类可以比字节数组更有效地处理ByteBuffers，则子类应考虑覆盖此方法。

engineDoFinal

byte[] engineDoFinal (byte[] input, 
                int inputOffset, 
                int inputLen)

在单部分操作中加密或解密数据，或完成多部分操作。 数据被加密或解密，取决于这个密码是如何初始化的。

第一inputLen字节在input缓冲区中，从inputOffset以下，并且可能在上一次期间已缓存的任何输入字节update操作，进行处理，填充（如果要求）被施加。 如果使用诸如GCM / CCM的AEAD模式，则在加密的情况下附加认证标签，或者在解密的情况下验证。 结果存储在新的缓冲区中。

完成后，此方法将此密码对象重置为之前通过调用engineInit初始化时的状态。 也就是说，该对象被重置并可用于加密或解密更多数据（取决于调用engineInit时指定的操作模式）。

注意：如果抛出任何异常，则可能需要重置此密码对象才能再次使用它。

engineGetBlockSize

int engineGetBlockSize ()

返回块大小（以字节为单位）。

engineGetIV

byte[] engineGetIV ()

返回新缓冲区中的初始化向量（IV）。

这在基于密码的加密或解密方面非常有用，其中IV源自用户提供的密码。

engineGetKeySize

int engineGetKeySize (Key key)

以位为单位返回给定键对象的键大小。

这个具体的方法已被添加到这个以前定义的抽象类。 如果提供程序不覆盖它，则会抛出UnsupportedOperationException 。

engineGetOutputSize

int engineGetOutputSize (int inputLen)

给定输入长度 inputLen （以字节为单位），返回输出缓冲区需要保留下一个 update或 doFinal操作结果 inputLen的字节长度。

此调用考虑到来自先前的 update调用，填充和AEAD标记的任何未处理（缓冲）的数据。

下一个 update或 doFinal调用的实际输出长度可能小于此方法返回的长度。

engineGetParameters

AlgorithmParameters engineGetParameters ()

返回此密码使用的参数。

返回的参数可能与用于初始化此密码的参数相同，或者如果此密码需要算法参数但未用任何初始值进行初始化，则可能包含底层密码实现使用的默认参数值和随机参数值的组合。

engineInit

void engineInit (int opmode, 
                Key key, 
                SecureRandom random)

用密钥和随机源初始化此密码。

密码初始化为以下四种操作之一：加密，解密，密钥打包或密钥解包，具体取决于 opmode的值。

如果此密码要求任何算法参数不能从给定的key ，则底层密码实现应该自己生成所需的参数（使用特定于提供者的默认值或随机值），如果它正在初始化用于加密或密钥包装，以及如果它正在初始化用于解密或密钥解InvalidKeyException则提出InvalidKeyException 。 生成的参数可以使用engineGetParameters或engineGetIV （如果参数是IV）来检索。

如果此密码需要不能从输入参数派生的算法参数，并且没有合理的特定于提供者的默认值，则初始化必然会失败。

如果此密码（包括其基础反馈或填充方案）需要任何随机字节（例如，用于参数生成），则它将从 random获得它们。

请注意，当Cipher对象初始化时，它会丢失所有先前获取的状态。 换句话说，初始化密码就相当于创建该密码的一个新实例并对其进行初始化。

engineInit

void engineInit (int opmode, 
                Key key, 
                AlgorithmParameterSpec params, 
                SecureRandom random)

使用密钥，一组算法参数和一个随机源初始化此密码。

密码初始化为以下四种操作之一：加密，解密，密钥打包或密钥解包，具体取决于 opmode的值。

如果此密码需要任何算法参数，并且params为空，则假定基础密码实现本身（使用特定于提供者的默认值或随机值）自动生成所需参数（如果正在初始化其加密或密钥包装），并且引发InvalidAlgorithmParameterException if它正在被初始化用于解密或密钥解包。 生成的参数可以使用engineGetParameters或engineGetIV （如果参数是IV）来检索。

如果此密码需要不能从输入参数派生的算法参数，并且没有合理的特定于提供者的默认值，则初始化必然会失败。

如果此密码（包括其基础反馈或填充方案）需要任何随机字节（例如，用于参数生成），它将从 random获得它们。

请注意，当Cipher对象初始化时，它会丢失所有先前获取的状态。 换句话说，初始化密码就相当于创建该密码的一个新实例并对其进行初始化。

engineInit

void engineInit (int opmode, 
                Key key, 
                AlgorithmParameters params, 
                SecureRandom random)

使用密钥，一组算法参数和一个随机源初始化此密码。

密码初始化为以下四种操作之一：加密，解密，密钥打包或密钥解包，具体取决于 opmode的值。

如果此密码需要任何算法参数且params为空，则基础密码实现本身应该生成所需的参数（使用提供程序特定的默认值或随机值）（如果它正在初始化用于加密或密钥包装），并引发InvalidAlgorithmParameterException if它正在被初始化用于解密或密钥解包。 生成的参数可以使用engineGetParameters或engineGetIV （如果参数是IV）来检索。

如果此密码需要不能从输入参数派生的算法参数，并且没有合理的特定于提供者的默认值，则初始化必然会失败。

如果该密码（包括其基础反馈或填充方案）需要任何随机字节（例如，用于参数生成），则它将从 random获得它们。

请注意，当Cipher对象初始化时，它会丢失所有先前获取的状态。 换句话说，初始化密码就相当于创建该密码的一个新实例并对其进行初始化。

engineSetMode

void engineSetMode (String mode)

设置此密码的模式。

engineSetPadding

void engineSetPadding (String padding)

设置此密码的填充机制。

engineUnwrap

Key engineUnwrap (byte[] wrappedKey, 
                String wrappedKeyAlgorithm, 
                int wrappedKeyType)

打开以前包装的密钥。

这个具体的方法已被添加到这个以前定义的抽象类。 （为了向后兼容，它不能是抽象的。）提供者可能会重写它，以便打开先前包装的密钥。 如果给定的包装密钥不能被解包，那么这样的覆盖预计会引发InvalidKeyException。 如果这个方法没有被覆盖，它总是抛出一个UnsupportedOperationException异常。

engineUpdate

byte[] engineUpdate (byte[] input, 
                int inputOffset, 
                int inputLen)

继续进行多部分加密或解密操作（取决于此密码的初始化方式），处理另一个数据部分。

第一 inputLen字节在 input缓冲区中，从 inputOffset以下，被处理，并且结果被存储在新的缓冲器。

engineUpdate

int engineUpdate (byte[] input, 
                int inputOffset, 
                int inputLen, 
                byte[] output, 
                int outputOffset)

继续进行多部分加密或解密操作（取决于此密码的初始化方式），处理另一个数据部分。

第一 inputLen字节在 input缓冲区中，从 inputOffset以下，被处理，并且结果被存储在 output缓冲区中，从 outputOffset以下。

如果 output缓冲区太小而无法保留结果， ShortBufferException抛出 ShortBufferException 。

engineUpdate

int engineUpdate (ByteBuffer input, 
                ByteBuffer output)

继续进行多部分加密或解密操作（取决于此密码的初始化方式），处理另一个数据部分。

所有input.remaining()起始字节input.position()被处理。 结果存储在输出缓冲区中。 返回时，输入缓冲区的位置将等于它的限制; 其限制不会改变。 输出缓冲区的位置将前进n，其中n是此方法返回的值; 输出缓冲区的限制不会改变。

如果 output.remaining()字节不足以保存结果， ShortBufferException抛出 ShortBufferException 。

如果子类可以比字节数组更有效地处理ByteBuffers，则子类应考虑覆盖此方法。

engineUpdateAAD

void engineUpdateAAD (byte[] src, 
                int offset, 
                int len)

使用提供的缓冲区的子集继续多部分更新附加验证数据（AAD）。

在AEAD（GCM / CCM）等模式下操作时，调用此方法可为AAD提供密码。 如果此密码以GCM或CCM模式运行，则必须在开始对密文进行操作之前提供所有AAD（通过update和doFinal方法）。

engineUpdateAAD

void engineUpdateAAD (ByteBuffer src)

继续更新附加验证数据（AAD）。

在AEAD（GCM / CCM）等模式下操作时，调用此方法可为AAD提供密码。 如果此密码以GCM或CCM模式运行，则必须在开始对密文进行操作之前提供所有AAD（通过update和doFinal方法）。

所有src.remaining()起始字节src.position()被处理。 返回时，输入缓冲区的位置将等于它的限制; 其限制不会改变。

engineWrap

byte[] engineWrap (Key key)

包裹一把钥匙。

这个具体的方法已被添加到这个以前定义的抽象类。 （为了向后兼容，它不能是抽象的。）提供者可能会覆盖它以包装一个密钥。 如果给定的密钥不能被包装，这样的覆盖预计会引发IllegalBlockSizeException或InvalidKeyException（在指定的情况下）。 如果这个方法没有被覆盖，它总是抛出一个UnsupportedOperationException异常。