クラスExemptionMechanismSpi

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
    キーを使用してこの除外メカニズムを初期化します。
    protected abstract void
    キーとアルゴリズム・パラメータのセットを使用してこの除外メカニズムを初期化します。
    protected abstract void
    キーとアルゴリズム・パラメータのセットを使用してこの除外メカニズムを初期化します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    このオブジェクトのコピーを作成して、返します。
    boolean
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    このObjectの実行時クラスを返します。
    int
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    オブジェクトの文字列表現を返します。
    final void
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
  • コンストラクタの詳細

    • 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

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

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

      パラメータ:
      key - この除外メカニズムのキー
      params - アルゴリズム・パラメータ
      スロー:
      InvalidKeyException - 指定されたキーがこの除外メカニズムに不適切な場合。
      InvalidAlgorithmParameterException - 指定されたアルゴリズム・パラメータがこの除外メカニズムに不適切な場合。
      ExemptionMechanismException - 初期化の処理で問題が見つかった場合。
    • engineInit

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

      この除外メカニズムがアルゴリズム・パラメータを必要とし、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 - 生成の処理で問題が見つかった場合。