Class SignatureAlgorithm

java.lang.Object

org.apache.xml.security.utils.ElementProxy

org.apache.xml.security.algorithms.Algorithm

org.apache.xml.security.algorithms.SignatureAlgorithm

public class SignatureAlgorithm
extends Algorithm

Allows selection of digital signature's algorithm, private keys, other security parameters, and algorithm's ID.

Author:

Christian Geuer-Pollmann

Field Summary

Fields

Modifier and Type	Field	Description
protected SignatureAlgorithmSpi	_signatureAlgorithm	Field _signatureAlgorithm

Fields inherited from class ElementProxy

_baseURI, _constructionElement, _doc, _state, MODE_CREATE, MODE_DECRYPT, MODE_ENCRYPT, MODE_PROCESS, MODE_SIGN, MODE_UNKNOWN, MODE_VERIFY

Constructor Summary

Constructors

Constructor	Description
SignatureAlgorithm(Document doc, String algorithmURI)	Constructor SignatureAlgorithm
SignatureAlgorithm(Document doc, String algorithmURI, int HMACOutputLength)	Constructor SignatureAlgorithm
SignatureAlgorithm(Element element, String BaseURI)	Constructor SignatureAlgorithm

Method Summary

Modifier and Type	Method	Description
String	getBaseLocalName()	Method getBaseLocalName
String	getBaseNamespace()	Method getBaseNamespace
String	getJCEAlgorithmString()	Proxy method for Signature.getAlgorithm() which is executed on the internal Signature object.
String	getJCEProviderName()	Method getJCEProviderName
final String	getURI()	Returns the URI representation of Transformation algorithm
void	initSign(Key signingKey)	Proxy method for Signature.initSign(java.security.PrivateKey) which is executed on the internal Signature object.
void	initSign(Key signingKey, SecureRandom secureRandom)	Proxy method for Signature.initSign(java.security.PrivateKey, java.security.SecureRandom) which is executed on the internal Signature object.
void	initSign(Key signingKey, AlgorithmParameterSpec algorithmParameterSpec)	Proxy method for Signature.initSign(java.security.PrivateKey) which is executed on the internal Signature object.
void	initVerify(Key verificationKey)	Proxy method for Signature.initVerify(java.security.PublicKey) which is executed on the internal Signature object.
static void	providerInit()	Initalizes for this Transform
static void	register(String algorithmURI, String implementingClass)	Registers implementing class of the Transform algorithm with algorithmURI
void	setParameter(AlgorithmParameterSpec params)	Proxy method for Signature.setParameter(java.security.spec.AlgorithmParameterSpec) which is executed on the internal Signature object.
byte[]	sign()	Proxy method for Signature.sign() which is executed on the internal Signature object.
void	update(byte input)	Proxy method for Signature.update(byte) which is executed on the internal Signature object.
void	update(byte[] input)	Proxy method for Signature.update(byte[]) which is executed on the internal Signature object.
void	update(byte[] buf, int offset, int len)	Proxy method for Signature.update(byte[], int, int) which is executed on the internal Signature object.
boolean	verify(byte[] signature)	Proxy method for Signature.verify(byte[]) which is executed on the internal Signature object.

Methods inherited from class Algorithm

getAlgorithmURI, setAlgorithmURI

Methods inherited from class ElementProxy

addBase64Element, addBase64Text, addBigIntegerElement, addText, addTextElement, createElementForFamily, getBaseURI, getBigIntegerFromChildElement, getBytesFromChildElement, getBytesFromTextChild, getDefaultPrefix, getDocument, getElement, getElementPlusReturns, getTextFromChildElement, getTextFromTextChild, guaranteeThatElementInCorrectSpace, length, setDefaultPrefix, setElement, setXPathNamespaceContext

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

_signatureAlgorithm

protected SignatureAlgorithmSpi _signatureAlgorithm

Field _signatureAlgorithm

Constructor Details

SignatureAlgorithm

public SignatureAlgorithm(Document doc,
 String algorithmURI)
                   throws XMLSecurityException

Constructor SignatureAlgorithm

Parameters:

doc -

algorithmURI -

Throws:

XMLSecurityException

SignatureAlgorithm

public SignatureAlgorithm(Document doc,
 String algorithmURI,
 int HMACOutputLength)
                   throws XMLSecurityException

Constructor SignatureAlgorithm

Parameters:

doc -

algorithmURI -

HMACOutputLength -

Throws:

XMLSecurityException

SignatureAlgorithm

public SignatureAlgorithm(Element element,
 String BaseURI)
                   throws XMLSecurityException

Constructor SignatureAlgorithm

Parameters:

element -

BaseURI -

Throws:

XMLSecurityException

Method Details

sign

public byte[] sign()
            throws XMLSignatureException

Proxy method for Signature.sign() which is executed on the internal Signature object.

Returns:

the result of the Signature.sign() method

Throws:

XMLSignatureException

getJCEAlgorithmString

public String getJCEAlgorithmString()

Proxy method for Signature.getAlgorithm() which is executed on the internal Signature object.

Returns:

the result of the Signature.getAlgorithm() method

getJCEProviderName

public String getJCEProviderName()

Method getJCEProviderName

Returns:

The Provider of this Signature Alogrithm

update

public void update(byte[] input)
            throws XMLSignatureException

Proxy method for Signature.update(byte[]) which is executed on the internal Signature object.

Parameters:

input -

Throws:

XMLSignatureException

update

public void update(byte input)
            throws XMLSignatureException

Proxy method for Signature.update(byte) which is executed on the internal Signature object.

Parameters:

input -

Throws:

XMLSignatureException

update

public void update(byte[] buf,
 int offset,
 int len)
            throws XMLSignatureException

Proxy method for Signature.update(byte[], int, int) which is executed on the internal Signature object.

Parameters:

buf -

offset -

len -

Throws:

XMLSignatureException

initSign

public void initSign(Key signingKey)
              throws XMLSignatureException

Proxy method for Signature.initSign(java.security.PrivateKey) which is executed on the internal Signature object.

Parameters:

signingKey -

Throws:

XMLSignatureException

initSign

public void initSign(Key signingKey,
 SecureRandom secureRandom)
              throws XMLSignatureException

Proxy method for Signature.initSign(java.security.PrivateKey, java.security.SecureRandom) which is executed on the internal Signature object.

Parameters:

signingKey -

secureRandom -

Throws:

XMLSignatureException

initSign

public void initSign(Key signingKey,
 AlgorithmParameterSpec algorithmParameterSpec)
              throws XMLSignatureException

Proxy method for Signature.initSign(java.security.PrivateKey) which is executed on the internal Signature object.

Parameters:

signingKey -

algorithmParameterSpec -

Throws:

XMLSignatureException

setParameter

public void setParameter(AlgorithmParameterSpec params)
                  throws XMLSignatureException

Proxy method for Signature.setParameter(java.security.spec.AlgorithmParameterSpec) which is executed on the internal Signature object.

Parameters:

params -

Throws:

XMLSignatureException

initVerify

public void initVerify(Key verificationKey)
                throws XMLSignatureException

Proxy method for Signature.initVerify(java.security.PublicKey) which is executed on the internal Signature object.

Parameters:

verificationKey -

Throws:

XMLSignatureException

verify

public boolean verify(byte[] signature)
               throws XMLSignatureException

Proxy method for Signature.verify(byte[]) which is executed on the internal Signature object.

Parameters:

signature -

Returns:

true if if the signature is valid.

Throws:

XMLSignatureException

getURI

public final String getURI()

Returns the URI representation of Transformation algorithm

Returns:

the URI representation of Transformation algorithm

providerInit

public static void providerInit()

Initalizes for this Transform

register

public static void register(String algorithmURI,
 String implementingClass)
                     throws AlgorithmAlreadyRegisteredException,
XMLSignatureException

Registers implementing class of the Transform algorithm with algorithmURI

Parameters:

algorithmURI - algorithmURI URI representation of Transform algorithm.

implementingClass - implementingClass the implementing class of SignatureAlgorithmSpi

Throws:

AlgorithmAlreadyRegisteredException - if specified algorithmURI is already registered

XMLSignatureException

getBaseNamespace

public String getBaseNamespace()

Method getBaseNamespace

Specified by:

getBaseNamespace in class ElementProxy

Returns:

URI of this element

getBaseLocalName

public String getBaseLocalName()

Method getBaseLocalName

Specified by:

getBaseLocalName in class ElementProxy

Returns:

Local name