CipherSpi クラス

定義

[Android.Runtime.Register("javax/crypto/CipherSpi", DoNotGenerateAcw=true)]
public abstract class CipherSpi : Java.Lang.Object

[<Android.Runtime.Register("javax/crypto/CipherSpi", DoNotGenerateAcw=true)>]
type CipherSpi = class
    inherit Object

継承

Object

JavaObject

Object

CipherSpi

属性

RegisterAttribute

注釈

このクラスは、 クラスの< (>b<SPI>/bCipher) を定義します。 このクラスのすべての抽象メソッドは、特定の暗号アルゴリズムの実装を提供する各暗号サービス プロバイダーによって実装される必要があります。

このCipher クラスのインスタンスをカプセル化する CipherSpi のインスタンスを作成するために、アプリケーションは、Cipher#getInstance(java.lang.String) getInstance エンジン クラスの Cipher Cipher ファクトリ メソッドのいずれかを呼び出し、要求された変換を指定します。 必要に応じて、アプリケーションでプロバイダーの名前を指定することもできます。

変換とは、特定の入力に対して実行される操作 (または一連の操作) を記述し、出力を生成する文字列です。 変換には常に暗号化アルゴリズムの名前 ( DES など) が含まれており、その後にフィードバック モードと埋め込みスキームが続く場合があります。

変換の形式は次のとおりです。

<ul><li>"algorithm/mode/padding" または

<li>"algorithm" </ul>

(後者の場合、モードとパディング スキームのプロバイダー固有の既定値が使用されます)。 たとえば、有効な変換を次に示します。

{@code
                Cipher c = Cipher.getInstance("DES/CBC/PKCS5Padding");
            }

プロバイダーは、アルゴリズム/モード/パディングの組み合わせごとに個別のクラスを提供することも、アルゴリズムまたはアルゴリズム/モードまたはアルゴリズム/パディング (二重スラッシュに注意) に対応するサブ変換を表すジェネリック クラスを提供することもできます。この場合、要求されたモードやパディングは、getInstanceのCipherメソッドによって自動的に設定され、プロバイダーのサブクラスの#engineSetMode(java.lang.String) engineSetModeメソッドと#engineSetPadding(java.lang.String) engineSetPaddingメソッドがCipherSpi。

プロバイダー マスター クラスの Cipher プロパティには、次のいずれかの形式を使用できます。

<ul>

<li>

// provider's subclass of "CipherSpi" implements "algName" with
                // pluggable mode and padding
<code>Cipher.</code><i>algName</i>

<li>

// provider's subclass of "CipherSpi" implements "algName" in the
                // specified "mode", with pluggable padding
<code>Cipher.</code><i>algName/mode</i>

<li>

// provider's subclass of "CipherSpi" implements "algName" with the
                // specified "padding", with pluggable mode
<code>Cipher.</code><i>algName//padding</i>

<li>

// provider's subclass of "CipherSpi" implements "algName" with the
                // specified "mode" and "padding"
<code>Cipher.</code><i>algName/mode/padding</i>

</ul>

たとえば、プロバイダーは CipherSpi を実装するのサブクラス、DES/CBC/PKCS5Padding を実装するサブクラス、DES/CFB/PKCS5Padding を実装するサブクラス、さらに DES/OFB/PKCS5Padding を実装するサブクラスを提供できます。 そのプロバイダーのマスター クラスには、次の Cipher プロパティがあります。

<ul>

<li>

<code>Cipher.</code><i>DES/ECB/PKCS5Padding</i>

<li>

<code>Cipher.</code><i>DES/CBC/PKCS5Padding</i>

<li>

<code>Cipher.</code><i>DES/CFB/PKCS5Padding</i>

<li>

<code>Cipher.</code><i>DES/OFB/PKCS5Padding</i>

</ul>

別のプロバイダーは、上記の各モードのクラス (たとえば、ECB 用に 1 つのクラス、CBC 用に 1 つ、CFB 用に 1 つ、OFB 用に 1 つ)、PKCS5Padding 用の 1 つのクラス、およびからサブクラス化するジェネリック CipherSpi クラスを実装できます。 そのプロバイダーのマスター クラスには、次の Cipher プロパティがあります。

<ul>

<li>

<code>Cipher.</code><i>DES</i>

</ul>

getInstance エンジン クラスの Cipher ファクトリ メソッドは、"CipherSpi" 形式の変換に対するプロバイダーのの実装をインスタンス化するために、次の規則に従います。

<ol><li> プロバイダーが指定された "CipherSpi" ののサブクラスを登録しているかどうかを確認します。

回答が YES の場合は、モードとパディング スキームの既定値 (プロバイダーによって提供される) が使用されるこのクラスをインスタンス化します。

回答が NO の場合は、 NoSuchAlgorithmException 例外をスローします。 </ol>

getInstance エンジン クラスの Cipher ファクトリ メソッドは、"CipherSpi" 形式の変換に対するのプロバイダーの実装をインスタンス化するために、次の規則に従います。

<ol><li> 指定された "CipherSpi" 変換ののサブクラスがプロバイダーによって登録されているかどうかを確認します。

答えが YES の場合は、インスタンス化します。

回答が NO の場合は、次の手順に進みます。 <li> サブ変換 "CipherSpi" ののサブクラスがプロバイダーによって登録されているかどうかを確認します。

答えが YES の場合は、インスタンス化し、新しいインスタンスで engineSetPadding(<i>padding</i>) を呼び出します。

回答が NO の場合は、次の手順に進みます。 <li> プロバイダーがサブ変換 "CipherSpi" ののサブクラスを登録しているかどうかを確認します (二重スラッシュに注意してください)。

答えが YES の場合は、インスタンス化し、新しいインスタンスで engineSetMode(<i>mode</i>) を呼び出します。

回答が NO の場合は、次の手順に進みます。 <li> プロバイダーがサブ変換 "CipherSpi" ののサブクラスを登録しているかどうかを確認します。

答えが YES の場合は、インスタンス化し、新しいインスタンスで engineSetMode(<i>mode</i>) と engineSetPadding(<i>padding</i>) を呼び出します。

回答が NO の場合は、 NoSuchAlgorithmException 例外をスローします。 </ol>

1.4 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。