JavaTM 2 Platform
Standard Ed. 5.0

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 - 生成の処理で問題が見つかった場合

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。