CipherSpi Klasse

Definition

[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

Vererbung

Object

JavaObject

Object

CipherSpi

Attribute

RegisterAttribute

Hinweise

Diese Klasse definiert die Dienstanbieterschnittstelle (<b>SPI</b>) für die Cipher Klasse. Alle abstrakten Methoden in dieser Klasse müssen von jedem Kryptografiedienstanbieter implementiert werden, der die Implementierung eines bestimmten Verschlüsselungsalgorithmus bereitstellen möchte.

Zum Erstellen einer Instanz von Cipher, die eine Instanz dieser CipherSpi Klasse kapselt, ruft eine Anwendung eine der Cipher#getInstance(java.lang.String) getInstance Factorymethoden der Cipher Cipher Modulklasse auf und gibt die angeforderte Transformation an. Optional kann die Anwendung auch den Namen eines Anbieters angeben.

Eine Transformation ist eine Zeichenfolge, die den Vorgang (oder die Gruppe von Vorgängen) beschreibt, die für die angegebene Eingabe ausgeführt werden sollen, um eine Ausgabe zu erzeugen. Eine Transformation enthält immer den Namen eines kryptografischen Algorithmus (z. B. DES) und kann von einem Feedbackmodus- und Abstandsschema gefolgt werden.

Eine Transformation ist der Form:

<ul><li>"algorithm/mode/padding" oder

<li>"algorithm" </ul>

(In letzterem Fall werden anbieterspezifische Standardwerte für das Modus- und Abstandsschema verwendet). Beispielsweise ist folgendes eine gültige Transformation:

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

Ein Anbieter kann eine separate Klasse für jede Kombination von Algorithmus/Modus/Abstand bereitstellen oder sich entscheiden, allgemeinere Klassen bereitzustellen, die Teiltransformationen darstellen, die algorithmus - oder algorithmus-/algorithmus - /algorithmus//padding entsprechen (beachten Sie die doppelten Schrägstriche), in diesem Fall werden der angeforderte Modus und/oder Abstand automatisch durch die getInstance Methoden Cipherfestgelegt, von denen die #engineSetMode(java.lang.String) engineSetMode Und #engineSetPadding(java.lang.String) engineSetPadding Methoden der Unterklasse CipherSpides Anbieters aufgerufen werden.

Eine Cipher Eigenschaft in einer Anbietermasterklasse kann eines der folgenden Formate aufweisen:

<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>

Beispielsweise kann ein Anbieter eine Unterklasse bereitstellen, die CipherSpiDES/ECB/PKCS5Padding implementiert, eine, die DES/CBC/PKCS5Padding implementiert, eine, die DES/CFB/PKCS5Padding implementiert, und eine weitere, die DES/OFB/PKCS5Padding implementiert. Dieser Anbieter hätte die folgenden Cipher Eigenschaften in seiner Masterklasse:

<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>

Ein anderer Anbieter kann eine Klasse für jeden der oben genannten Modi implementieren (d. h. eine Klasse für ECB, eine für CBC, eine für CFB und eine für OFB), eine Klasse für PKCS5Padding und eine generische DES-Klasse , von der unterklassen verwendet CipherSpiwird. Dieser Anbieter hätte die folgenden Cipher Eigenschaften in seiner Masterklasse:

<Ul>

<li>

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

</ul>

Die getInstance Factorymethode der Cipher Modulklasse folgt diesen Regeln, um die Implementierung CipherSpi eines Anbieters für eine Transformation des Formulars "Algorithmus" instanziieren zu können:

<ol><li> Check if the provider has registered a subclass of CipherSpi for the specified "algorithm".

Wenn die Antwort JA lautet, instanziieren Sie diese Klasse, für deren Standardwerte für den Modus und den Abstand des Schemas (wie vom Anbieter angegeben) verwendet werden.

Wenn die Antwort "NEIN" lautet, lösen Sie eine Ausnahme aus NoSuchAlgorithmException . </ol>

Die getInstance Factorymethode der Cipher Modulklasse folgt diesen Regeln, um die Implementierung CipherSpi eines Anbieters für eine Transformation des Formulars "algorithm/mode/padding" zu instanziieren:

<ol><li> Check if the provider has registered a subclass of CipherSpi for the specified "algorithm/mode/padding" transformation.

Wenn die Antwort JA lautet, instanziieren Sie sie.

Wenn die Antwort "NEIN" lautet, fahren Sie mit dem nächsten Schritt fort. <li> Check if the provider has registered a subclass of CipherSpi for the sub-transformation "algorithm/mode".

Wenn die Antwort "JA" lautet, instanziieren Sie sie, und rufen Sie die neue Instanz auf engineSetPadding(<i>padding</i>) .

Wenn die Antwort "NEIN" lautet, fahren Sie mit dem nächsten Schritt fort. <li> Check if the provider has registered a subclass of CipherSpi for the sub-transformation "algorithm//padding" (note the double slashes).

Wenn die Antwort "JA" lautet, instanziieren Sie sie, und rufen Sie die neue Instanz auf engineSetMode(<i>mode</i>) .

Wenn die Antwort "NEIN" lautet, fahren Sie mit dem nächsten Schritt fort. <li> Check if the provider has registered a subclass of CipherSpi for the sub-transformation "algorithm".

Wenn die Antwort "JA" lautet, instanziieren Sie sie, und rufen engineSetMode(<i>mode</i>) Sie die engineSetPadding(<i>padding</i>) neue Instanz auf.

Wenn die Antwort "NEIN" lautet, lösen Sie eine Ausnahme aus NoSuchAlgorithmException . </ol>

In 1.4 hinzugefügt.

Java Dokumentation für javax.crypto.CipherSpi.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.