Class XMLSignatureInput

java.lang.Object

org.apache.xml.security.signature.XMLSignatureInput

All Implemented Interfaces:

Cloneable

public class XMLSignatureInput
extends Object
implements Cloneable

Class XMLSignatureInput

Author:

Christian Geuer-Pollmann $todo$ check whether an XMLSignatureInput can be _both_, octet stream _and_ node set?

Constructor Summary

Constructors

Constructor	Description
XMLSignatureInput(byte[] inputOctets)	Construct a XMLSignatureInput from an octet array.
XMLSignatureInput(InputStream inputOctetStream)	Constructs a XMLSignatureInput from an octet stream.
XMLSignatureInput(String inputStr)	Deprecated.
XMLSignatureInput(String inputStr, String encoding)	Deprecated.
XMLSignatureInput(Set inputNodeSet)	Constructor XMLSignatureInput
XMLSignatureInput(Node rootNode)	Construct a XMLSignatureInput from a subtree rooted by rootNode.

Method Summary

Modifier and Type	Method	Description
void	addNodeFilter(NodeFilter filter)
byte[]	getBytes()	Returns the byte array from input which was specified as the parameter of XMLSignatureInput constructor
Node	getExcludeNode()	Gets the exclude node of this XMLSignatureInput
String	getHTMLRepresentation()	Method getHTMLRepresentation
String	getHTMLRepresentation(Set inclusiveNamespaces)	Method getHTMLRepresentation
String	getMIMEType()	Returns MIMEType
List	getNodeFilters()
Set	getNodeSet()	Returns the node set from input which was specified as the parameter of XMLSignatureInput constructor
Set	getNodeSet(boolean circunvent)	Returns the node set from input which was specified as the parameter of XMLSignatureInput constructor
InputStream	getOctetStream()	Returns the Octect stream(byte Stream) from input which was specified as the parameter of XMLSignatureInput constructor
InputStream	getOctetStreamReal()
protected InputStream	getResetableInputStream()
String	getSourceURI()	Return SourceURI
Node	getSubNode()	Gets the node of this XMLSignatureInput
boolean	isByteArray()	Determines if the object has been set up with a ByteArray
boolean	isElement()	Determines if the object has been set up with an Element
boolean	isExcludeComments()
boolean	isInitialized()	Is the object correctly set up?
boolean	isNeedsToBeExpanded()	Check if the structured is needed to be circumbented.
boolean	isNodeSet()	Determines if the object has been set up with a Node set
boolean	isOctetStream()	Determines if the object has been set up with an octet stream
void	setExcludeComments(boolean excludeComments)
void	setExcludeNode(Node excludeNode)	Sets the exclude node of this XMLSignatureInput
void	setMIMEType(String MIMEType)	Sets MIMEType
void	setNeedsToBeExpanded(boolean needsToBeExpanded)	Set if the structured is needed to be circumbented.
void	setNodeSet(boolean b)
void	setOutputStream(OutputStream os)
void	setSourceURI(String SourceURI)	Sets SourceURI
String	toString()	Method toString
void	updateOutputStream(OutputStream diOs)

Methods inherited from class Object

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

Constructor Details

XMLSignatureInput

public XMLSignatureInput(byte[] inputOctets)

Construct a XMLSignatureInput from an octet array.

This is a comfort method, which internally converts the byte[] array into an InputStream

NOTE: no defensive copy

Parameters:

inputOctets - an octet array which including XML document or node

XMLSignatureInput

public XMLSignatureInput(InputStream inputOctetStream)

Constructs a XMLSignatureInput from an octet stream. The stream is directly read.

Parameters:

inputOctetStream -

XMLSignatureInput

public XMLSignatureInput(String inputStr)

Deprecated.

Construct a XMLSignatureInput from a String.

This is a comfort method, which internally converts the String into a byte[] array using the String.getBytes() method.

Parameters:

inputStr - the input String which including XML document or node

XMLSignatureInput

public XMLSignatureInput(String inputStr,
 String encoding)
                  throws UnsupportedEncodingException

Deprecated.

Construct a XMLSignatureInput from a String with a given encoding.

This is a comfort method, which internally converts the String into a byte[] array using the String.getBytes() method.

Parameters:

inputStr - the input String with encoding encoding

encoding - the encoding of inputStr

Throws:

UnsupportedEncodingException

XMLSignatureInput

public XMLSignatureInput(Node rootNode)

Construct a XMLSignatureInput from a subtree rooted by rootNode. This method included the node and all his descendants in the output.

Parameters:

rootNode -

XMLSignatureInput

public XMLSignatureInput(Set inputNodeSet)

Constructor XMLSignatureInput

Parameters:

inputNodeSet -

usedXPathAPI -

Method Details

isNeedsToBeExpanded

public boolean isNeedsToBeExpanded()

Check if the structured is needed to be circumbented.

Returns:

true if so.

setNeedsToBeExpanded

public void setNeedsToBeExpanded(boolean needsToBeExpanded)

Set if the structured is needed to be circumbented.

Parameters:

needsToBeExpanded - true if so.

getNodeSet

public Set getNodeSet()
               throws CanonicalizationException,
ParserConfigurationException,
IOException,
SAXException

Returns the node set from input which was specified as the parameter of XMLSignatureInput constructor

Returns:

the node set

Throws:

SAXException

IOException

ParserConfigurationException

CanonicalizationException

CanonicalizationException

IOException

ParserConfigurationException

SAXException

getNodeSet

public Set getNodeSet(boolean circunvent)
               throws ParserConfigurationException,
IOException,
SAXException,
CanonicalizationException

Returns the node set from input which was specified as the parameter of XMLSignatureInput constructor

Parameters:

circunvent -

Returns:

the node set

Throws:

SAXException

IOException

ParserConfigurationException

CanonicalizationException

CanonicalizationException

IOException

ParserConfigurationException

SAXException

getOctetStream

public InputStream getOctetStream()
                           throws IOException

Returns the Octect stream(byte Stream) from input which was specified as the parameter of XMLSignatureInput constructor

Returns:

the Octect stream(byte Stream) from input which was specified as the parameter of XMLSignatureInput constructor

Throws:

IOException

getOctetStreamReal

public InputStream getOctetStreamReal()

Returns:

real octect stream

getBytes

public byte[] getBytes()
                throws IOException,
CanonicalizationException

Returns the byte array from input which was specified as the parameter of XMLSignatureInput constructor

Returns:

the byte[] from input which was specified as the parameter of XMLSignatureInput constructor

Throws:

CanonicalizationException

IOException

isNodeSet

public boolean isNodeSet()

Determines if the object has been set up with a Node set

Returns:

true is the object has been set up with a Node set

isElement

public boolean isElement()

Determines if the object has been set up with an Element

Returns:

true is the object has been set up with a Node set

isOctetStream

public boolean isOctetStream()

Determines if the object has been set up with an octet stream

Returns:

true is the object has been set up with an octet stream

isByteArray

public boolean isByteArray()

Determines if the object has been set up with a ByteArray

Returns:

true is the object has been set up with an octet stream

isInitialized

public boolean isInitialized()

Is the object correctly set up?

Returns:

true if the object has been set up correctly

getMIMEType

public String getMIMEType()

Returns MIMEType

Returns:

MIMEType

setMIMEType

public void setMIMEType(String MIMEType)

Sets MIMEType

Parameters:

MIMEType -

getSourceURI

public String getSourceURI()

Return SourceURI

Returns:

SourceURI

setSourceURI

public void setSourceURI(String SourceURI)

Sets SourceURI

Parameters:

SourceURI -

toString

public String toString()

Method toString

Overrides:

toString in class Object

getHTMLRepresentation

public String getHTMLRepresentation()
                             throws XMLSignatureException

Method getHTMLRepresentation

Returns:

The HTML representation for this XMLSignature

Throws:

XMLSignatureException

getHTMLRepresentation

public String getHTMLRepresentation(Set inclusiveNamespaces)
                             throws XMLSignatureException

Method getHTMLRepresentation

Parameters:

inclusiveNamespaces -

Returns:

The HTML representation for this XMLSignature

Throws:

XMLSignatureException

getExcludeNode

public Node getExcludeNode()

Gets the exclude node of this XMLSignatureInput

Returns:

Returns the excludeNode.

setExcludeNode

public void setExcludeNode(Node excludeNode)

Sets the exclude node of this XMLSignatureInput

Parameters:

excludeNode - The excludeNode to set.

getSubNode

public Node getSubNode()

Gets the node of this XMLSignatureInput

Returns:

The excludeNode set.

isExcludeComments

public boolean isExcludeComments()

Returns:

Returns the excludeComments.

setExcludeComments

public void setExcludeComments(boolean excludeComments)

Parameters:

excludeComments - The excludeComments to set.

updateOutputStream

public void updateOutputStream(OutputStream diOs)
                        throws CanonicalizationException,
IOException

Parameters:

diOs -

Throws:

IOException

CanonicalizationException

setOutputStream

public void setOutputStream(OutputStream os)

Parameters:

os -

getResetableInputStream

protected InputStream getResetableInputStream()
                                       throws IOException

Throws:

IOException

addNodeFilter

public void addNodeFilter(NodeFilter filter)

Parameters:

filter -

getNodeFilters

public List getNodeFilters()

Returns:

the node filters

setNodeSet

public void setNodeSet(boolean b)

Parameters:

b -