java.lang.Object
   |
   +--java.security.SignatureSpi
         |
         +--java.security.Signature

Deklaration

Beschreibung

Methoden
public Object	clone()
public final String	getAlgorithm()
public static Signature	getInstance(String algorithm)
public static Signature	getInstance(String algorithm, String provider)
public static Signature	getInstance(String algorithm, Provider provider)
public final Object	getParameter(String param)       Verworfen in Version 1.2.
public final AlgorithmParameters	getParameters()
public final Provider	getProvider()
public final void	initSign(PrivateKey privateKey)
public final void	initSign(PrivateKey privateKey, SecureRandom random)
public final void	initVerify(PublicKey publicKey)
public final void	initVerify(Certificate certificate)
public final void	setParameter(AlgorithmParameterSpec params)
public final void	setParameter(String param, Object value)       Verworfen in Version 1.2. Ersetzt durch setParameter(java.security.spec.AlgorithmParameterSpec).
public final byte[]	sign()
public final byte[]	sign(byte[] outbuf, int offset, int len)
public String	toString()
public final void	update(byte b)
public final void	update(byte[] data)
public final void	update(byte[] data, int off, int len)
public final boolean	verify(byte[] signature)
public final boolean	verify(byte[] signature, int offset, int length)

Datenelemente im Detail

protected final static int UNINITIALIZED

Signalisiert, daß das Objekt noch nicht initialisiert wurde.

protected final static int SIGN

Signalisiert, daß das Objekt zum Signieren initialisiert wurde.

protected final static int VERIFY

Signalisiert, daß das Objekt zum Verifizieren initialisiert wurde.

protected int state

Der aktuelle Zustand des Objekts

Konstruktoren im Detail

protected Signature(String algorithm)

Erzeugt ein neues Objekt, daß den durch algorithm bezeichneten Algorithmus verwendet.

Methoden im Detail

public Object clone()

Liefert eine Kopie des Objekts zurück.

Exception: CloneNotSupportedException

public final String getAlgorithm()

Liefert den Namen des verwendeten Algorithmus zurück.

public static Signature getInstance(String algorithm)

Erzeugt ein neues Objekt, das den durch algorithm bezeichneten Algorithmus verwendet, und liefert ihn zurück.

Exception: NoSuchAlgorithmException

• Falls algorithm ungültig ist oder nicht unterstützt wird.

public static Signature getInstance(String algorithm, String provider)

Bei dieser Variante kann zusätzlich ein bestimmter Provider angegeben werden, dessen Implementierung verwendet werden soll.

Exception: NoSuchAlgorithmException

• Falls algorithm ungültig ist oder nicht unterstützt wird.

Exception: NoSuchProviderException

• Falls provider ungültig ist oder nicht unterstützt wird.

public static Signature getInstance(String algorithm, Provider provider)     

Bei dieser Variante wird der Provider als Exemplar der Klasse Provider spezifiziert.

Exception: NoSuchAlgorithmException

• Falls algorithm vom angegebenen Provider nicht unterstützt wird.

public final Object getParameter(String param)

Liefert den durch name bezeichneten Parameter des Signatur-Algorithmus zurück.

Exception: InvalidParameterException

public final AlgorithmParameters getParameters()     

Liefert die Parameter dieses Objekts zurück.

public final Provider getProvider()

Liefert den Provider zurück, von dem dieses Objekt stammt.

public final void initSign(PrivateKey privateKey)

Initialisiert das Objekt zum Signieren mit dem privaten Schlüssel privateKey. Ein weiterer Aufruf mit einem anderem Parameter macht den Aufruf rückgängig.

Exception: InvalidKeyException

• Falls privateKey ungültig ist.

public final void initSign(PrivateKey privateKey, SecureRandom random)

Bei dieser Variante kann zusätzlich mit random ein Zufallszahlen-Generator angegeben werden.

Exception: InvalidKeyException

• Falls privateKey ungültig ist.

public final void initVerify(PublicKey publicKey)

Initialisiert das Objekt zum Verifizieren einer Signatur mit dem öffentlichen Schlüssel publicKey. Ein weiterer Aufruf mit einem anderem Parameter macht den Aufruf rückgängig.

Exception: InvalidKeyException

• Falls publicKey ungültig ist.

public final void initVerify(Certificate certificate)     

Initialisiert das Objekt zum Verifizieren einer Signatur mit dem Zertifikate certificate

Exception: InvalidKeyException

public final void setParameter(AlgorithmParameterSpec params)

Initialisiert den Signatur-Algorithmus mit den in params enthaltenen Parametern.

Exception: InvalidAlgorithmParameterException

• Falls der übergebene Parameter-Satz nicht zum Algorithmus paßt..

public final void setParameter(String param, Object value)

Setzt den durch param bezeichneten Parameter auf value.

Exception: InvalidParameterException

public final byte[] sign()

Signiert die zuvor mit update() gesendeten Bytes und liefert die Signatur zurück.

Exception: SignatureException

• Falls das Objekt noch nicht initialisiert wurde.

public final byte[] sign(byte[] outbuf, int offset, int len)     

Signiert die zuvor mit update() gesendeten Bytes und trägt die Signatur ab der Position offset in outbuf ein. len gibt an, wieviele Bytes in outbuf zum Speichern der Signatur zur Verfügung stehen. Rückgabewert ist die Anzahl der eingetragenen Bytes.

Exception: SignatureException

• Falls das Objekt noch nicht initialisiert wurde.
• Falls len kleiner als die Länge der Signatur ist.

public String toString()

Liefert eine String-Darstellung des Objekts.

public final void update(byte b)

Aktualisiert die Signatur-Daten mit dem Byte b.

Exception: SignatureException

• Falls das Objekt noch nicht initialisiert wurde.

public final void update(byte[] data)

Aktualisiert die Signatur-Daten mit den in data enthaltenen Bytes.

Exception: SignatureException

• Falls das Objekt noch nicht initialisiert wurde.

public final void update(byte[] data, int off, int len)

Aktualisiert die Signatur-Daten mit den ersten len Bytes ab der Position off in data.

Exception: SignatureException

• Falls das Objekt noch nicht initialisiert wurde.

public final boolean verify(byte[] signature)

Verifiziert die Signatur signature und liefert true, wenn sie erfolgreich verifiziert werden konnte, sonst false.

Exception: SignatureException

• Falls das Objekt nicht zum Verifizieren initialisiert wurde.
• Falls das Format von signature nicht korrekt ist.

public final boolean verify(byte[] signature, int offset, int length)     

Verifiziert die Signatur signature und liefert true, wenn sie erfolgreich verifiziert werden konnte, sonst false. Dabei werden nur die ersten length Bytes ab der Position offset von signature ausgelesen.

Exception: SignatureException

• Falls das Objekt nicht zum Verifizieren initialisiert wurde.
• Falls das Format von signature nicht korrekt ist.