javax.crypto

クラス ExemptionMechanismSpi

java.lang.Object

javax.crypto.ExemptionMechanismSpi

public abstract class ExemptionMechanismSpi
extends Object

このクラスは、ExemptionMechanism クラスのサービスプロバイダインタフェース (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 - 生成の処理で問題が見つかった場合。