javax.crypto
クラス ExemptionMechanismSpi

java.lang.Object
  |
  +--javax.crypto.ExemptionMechanismSpi

public abstract class ExemptionMechanismSpi

extends Object

このクラスは、ExemptionMechanism クラスの Service Provider Interface (SPI) を定義します。特定の除外機構の実装を提供する各暗号化サービスプロバイダは、このクラスのすべての抽象メソッドを実装する必要があります。

導入されたバージョン:

1.4

コンストラクタの概要

ExemptionMechanismSpi()

メソッドの概要

protected abstract byte[]	engineGenExemptionBlob() 除外機構の鍵 Blob を生成します。
protected abstract int	engineGenExemptionBlob(byte[] output, int outputOffset) 除外機構の鍵 Blob を生成して、結果を outputOffset から始まる output バッファに格納します。
protected abstract int	engineGetOutputSize(int inputLen) 入力の長さ inputLen (バイト単位) を指定して、次の engineGenExemptionBlob 操作の結果を保持するために必要な出力バッファの長さをバイト数で返します。
protected abstract void	engineInit(Key key) 鍵を使用してこの除外機構を初期化します。
protected abstract void	engineInit(Key key, AlgorithmParameters params) 鍵とアルゴリズムパラメータのセットを使用してこの除外機構を初期化します。
protected abstract void	engineInit(Key key, AlgorithmParameterSpec params) 鍵とアルゴリズムパラメータのセットを使用してこの除外機構を初期化します。

クラス java.lang.Object から継承したメソッド

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

コンストラクタの詳細

ExemptionMechanismSpi

public ExemptionMechanismSpi()

メソッドの詳細

engineGetOutputSize

protected abstract int engineGetOutputSize(int inputLen)

入力の長さ inputLen (バイト単位) を指定して、次の engineGenExemptionBlob 操作の結果を保持するために必要な出力バッファの長さをバイト数で返します。

次の engineGenExemptionBlob 呼び出しの実際の出力長は、このメソッドが返す長さより小さいことがあります。

パラメータ:

inputLen - 入力長 (バイト単位)

戻り値:

必要な出力バッファサイズ (バイト単位)

engineInit

protected abstract void engineInit(Key key)
                            throws InvalidKeyException,
                                   ExemptionMechanismException

鍵を使用してこの除外機構を初期化します。

この除外機構が、指定された key から派生できないアルゴリズムパラメータを必要とする場合、基本となる除外機構の実装は、プロバイダ固有のデフォルト値を使用して必要なパラメータ自体を生成します。アルゴリズムパラメータを呼び出し側で指定する必要がある場合は、InvalidKeyException が発生します。

パラメータ:

key - この除外機構の鍵

例外:

InvalidKeyException - 指定された鍵がこの除外機構に不適切な場合

ExemptionMechanismException - 初期化の処理で問題が見つかった場合

engineInit

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

鍵とアルゴリズムパラメータのセットを使用してこの除外機構を初期化します。

この除外機構がアルゴリズムパラメータを必要とし、params が null である場合、基本となる除外機構の実装は、プロバイダ固有のデフォルト値を使用して必要なパラメータ自体を生成します。アルゴリズムパラメータを呼び出し側で指定する必要がある場合は、InvalidAlgorithmParameterException が発生します。

パラメータ:

key - この除外機構の鍵

params - アルゴリズムパラメータ

例外:

InvalidKeyException - 指定された鍵がこの除外機構に不適切な場合

InvalidAlgorithmParameterException - 指定されたアルゴリズムパラメータがこの除外機構に不適切な場合

ExemptionMechanismException - 初期化の処理で問題が見つかった場合

engineInit

protected abstract void engineInit(Key key,
                                   AlgorithmParameters params)
                            throws InvalidKeyException,
                                   InvalidAlgorithmParameterException,
                                   ExemptionMechanismException

鍵とアルゴリズムパラメータのセットを使用してこの除外機構を初期化します。

この除外機構がアルゴリズムパラメータを必要とし、params が null である場合、基本となる除外機構の実装は、プロバイダ固有のデフォルト値を使用して必要なパラメータ自体を生成します。アルゴリズムパラメータを呼び出し側で指定する必要がある場合は、InvalidAlgorithmParameterException が発生します。

パラメータ:

key - この除外機構の鍵

params - アルゴリズムパラメータ

例外:

InvalidKeyException - 指定された鍵がこの除外機構に不適切な場合

InvalidAlgorithmParameterException - 指定されたアルゴリズムパラメータがこの除外機構に不適切な場合

ExemptionMechanismException - 初期化の処理で問題が見つかった場合

engineGenExemptionBlob

protected abstract byte[] engineGenExemptionBlob()
                                          throws ExemptionMechanismException

除外機構の鍵 Blob を生成します。

戻り値:

結果の鍵 Blob の入った新しいバッファ

例外:

ExemptionMechanismException - 生成の処理で問題が見つかった場合

engineGenExemptionBlob

protected abstract int engineGenExemptionBlob(byte[] output,
                                              int outputOffset)
                                       throws ShortBufferException,
                                              ExemptionMechanismException

除外機構の鍵 Blob を生成して、結果を outputOffset から始まる output バッファに格納します。

output バッファが小さすぎて結果を保持できない場合は、ShortBufferException がスローされます。この場合、より大きな出力バッファを使用してこの呼び出しを繰り返します。engineGetOutputSize を使用して、必要な出力バッファのサイズを判定します。

パラメータ:

output - 結果を格納するバッファ

outputOffset - 結果が格納される output 内のオフセット

戻り値:

output に格納されたバイト数

例外:

ShortBufferException - 指定された出力バッファが小さすぎて結果を保持できない場合

ExemptionMechanismException - 生成の処理で問題が見つかった場合