CipherSpi Classe

Definizione

[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

Ereditarietà

Object

JavaObject

Object

CipherSpi

Attributi

RegisterAttribute

Commenti

Questa classe definisce l'interfaccia del provider di servizi (<b>SPI</b>) per la Cipher classe . Tutti i metodi astratti in questa classe devono essere implementati da ogni provider di servizi di crittografia che desidera fornire l'implementazione di un particolare algoritmo di crittografia.

Per creare un'istanza di Cipher, che incapsula un'istanza di questa CipherSpi classe, un'applicazione chiama uno dei Cipher#getInstance(java.lang.String) getInstance metodi factory della Cipher Cipher classe del motore e specifica la trasformazione richiesta. Facoltativamente, l'applicazione può anche specificare il nome di un provider.

Una trasformazione è una stringa che descrive l'operazione (o il set di operazioni) da eseguire sull'input specificato, per produrre un output. Una trasformazione include sempre il nome di un algoritmo di crittografia (ad esempio , DES) e può essere seguito da una modalità di feedback e uno schema di riempimento.

Una trasformazione è del formato:

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

<li>"algorithm" </ul>

(nel secondo caso vengono usati valori predefiniti specifici del provider per la modalità e lo schema di spaziatura interna). Ad esempio, di seguito è riportata una trasformazione valida:

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

Un provider può fornire una classe separata per ogni combinazione di algoritmo/modalità/spaziatura interna oppure può decidere di fornire più classi generiche che rappresentano le trasformazioni secondarie corrispondenti all'algoritmo o all'algoritmo/modalità o all'algoritmo/riempimento (si notino le barre doppie), nel qual caso la modalità richiesta e/o la spaziatura interna vengono impostate automaticamente dai getInstance metodi di Cipher, che richiamano i #engineSetMode(java.lang.String) engineSetMode metodi e #engineSetPadding(java.lang.String) engineSetPadding della sottoclasse del provider di CipherSpi.

Una Cipher proprietà in una classe master del provider può avere uno dei formati seguenti:

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

Ad esempio, un provider può fornire una sottoclasse di CipherSpi che implementa DES/ECB/PKCS5Padding, una che implementa DES/CBC/PKCS5Padding, una che implementa DES/PKCS5Padding e un'altra che implementa DES/OFB/PKCS5Padding. Tale provider avrà le proprietà seguenti Cipher nella relativa classe master:

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

Un altro provider può implementare una classe per ognuna delle modalità precedenti (ad esempio, una classe per LA BCE, una per CBC, una per LBC e una per OFB), una classe per PKCS5Padding e una classe DES generica che sottoclassa da CipherSpi. Tale provider avrà le proprietà seguenti Cipher nella relativa classe master:

<ul>

<li>

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

</ul>

Il getInstance metodo factory della Cipher classe del motore segue queste regole per creare un'istanza dell'implementazione di un provider di CipherSpi per una trasformazione del modulo "algoritmo":

<ol><li> Controllare se il provider ha registrato una sottoclasse di CipherSpi per l'"algoritmo" specificato.

Se la risposta è SÌ, creare un'istanza di questa classe per i cui valori predefiniti della modalità e dello schema di riempimento (forniti dal provider) vengono usati.

Se la risposta è NO, generare un'eccezione NoSuchAlgorithmException . </ol>

Il getInstance metodo factory della Cipher classe del motore segue queste regole per creare un'istanza dell'implementazione di un provider di CipherSpi per una trasformazione del modulo "algoritmo/modalità/riempimento":

<ol><li> Controllare se il provider ha registrato una sottoclasse di CipherSpi per la trasformazione "algorithm/mode/padding" specificata.

Se la risposta è SÌ, crearne un'istanza.

Se la risposta è NO, andare al passaggio successivo. <li> Controllare se il provider ha registrato una sottoclasse di CipherSpi per la trasformazione secondaria "algoritmo/modalità".

Se la risposta è SÌ, crearne un'istanza e chiamare engineSetPadding(<i>padding</i>) la nuova istanza.

Se la risposta è NO, andare al passaggio successivo. <li> Controllare se il provider ha registrato una sottoclasse di CipherSpi per la trasformazione secondaria "algorithm//padding" (si notino le doppie barre).

Se la risposta è SÌ, crearne un'istanza e chiamare engineSetMode(<i>mode</i>) la nuova istanza.

Se la risposta è NO, andare al passaggio successivo. <li> Controllare se il provider ha registrato una sottoclasse di CipherSpi per l'"algoritmo" di trasformazione secondaria.

Se la risposta è SÌ, crearne un'istanza e chiamare engineSetMode(<i>mode</i>) e engineSetPadding(<i>padding</i>) sulla nuova istanza.

Se la risposta è NO, generare un'eccezione NoSuchAlgorithmException . </ol>

Aggiunta nella versione 1.4.

per javax.crypto.CipherSpi.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.