java.lang.Object
javax.crypto.ExemptionMechanismSpi
public abstract class ExemptionMechanismSpi extends Object
このクラスは、
ExemptionMechanism
クラスのサービス・プロバイダ・インタフェース (SPI)を定義します。 特定の除外メカニズムの実装を提供する各暗号化サービス・プロバイダは、このクラスのすべての抽象メソッドを実装する必要があります。 - 導入されたバージョン:
- 1.4
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明protected abstract byte[]
除外メカニズムのキー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) キーとアルゴリズム・パラメータのセットを使用してこの除外メカニズムを初期化します。
-
コンストラクタの詳細
-
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
- 生成の処理で問題が見つかった場合。
-