com.sun.identity.saml.protocol
Class Response

java.lang.Object
  |
  +--com.sun.identity.saml.protocol.AbstractResponse
        |
        +--com.sun.identity.saml.protocol.Response

public class Response

extends AbstractResponse

This Response class represents a Response XML document. The schema of Response is defined as the following: ...

Constructor Summary

Response(org.w3c.dom.Element root)
Constructor.

Response(java.lang.String responseID, Status status, java.util.List contents)
This constructor shall only be used at the server side to construct a Response object.

Response(java.lang.String responseID, Status status, java.lang.String recipient, java.util.List contents)
This constructor shall only be used at the server side to construct a Response object.

Response(java.lang.String responseID, java.lang.String inResponseTo, Status status, java.util.List contents)
This constructor shall only be used at the server side to construct a Response object.

Response(java.lang.String responseID, java.lang.String inResponseTo, Status status, java.lang.String recipient, java.util.List contents)
This constructor shall only be used at the server side to construct a Response object.

Method Summary

boolean	addAssertion(Assertion assertion) Add an assertion to the Response.
java.util.List	getAssertion() This method returns the set of Assertions that is the content of the response.
Status	getStatus() Gets the Status of the Response.
static Response	parseXML(java.io.InputStream is)
static Response	parseXML(java.lang.String xml) This method is used primarily at the client side to reconstruct a Response object based on the XML document received from server.
boolean	setSignature(org.w3c.dom.Element elem) Set the signature for the Response.
boolean	setStatus(Status status) Set the Status of the Response.
void	signXML() Method that signs the Response.
java.lang.String	toString() This method translates the response to an XML document String based on the Response schema described above.
java.lang.String	toString(boolean includeNS, boolean declareNS) Creates a String representation of the <samlp:Response> element.
java.lang.String	toString(boolean includeNS, boolean declareNS, boolean includeHeader) Creates a String representation of the <samlp:Response> element.

Methods inherited from class com.sun.identity.saml.protocol.AbstractResponse

getInResponseTo, getIssueInstant, getMajorVersion, getMinorVersion, getRecipient, getResponseID, getSignature, isSignatureValid, isSigned, setInResponseTo, setIssueInstant, setRecipient, setResponseID

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Response

public Response(java.lang.String responseID,
                java.lang.String inResponseTo,
                Status status,
                java.util.List contents)
         throws SAMLException

This constructor shall only be used at the server side to construct a Response object. NOTE: The content here is just the body for the Response. The constructor will add the unique ResponseId, MajorVersion, etc. to form a complete Response object.

Parameters:

responseID - If it's null, the constructor will create one.

inResponseTo - the RequestID that this response is corresponding. It could be null or empty string "".

status - The status of the response.

contents - A List of Assertions that are the content of the Response. It could be null when there is no Assertion.

Response

public Response(java.lang.String responseID,
                java.lang.String inResponseTo,
                Status status,
                java.lang.String recipient,
                java.util.List contents)
         throws SAMLException

This constructor shall only be used at the server side to construct a Response object. NOTE: The content here is just the body for the Response. The constructor will add the unique ResponseId, MajorVersion, etc. to form a complete Response object.

Parameters:

responseID - If it's null, the constructor will create one.

inResponseTo - the RequestID that this response is corresponding. It could be null or empty string "".

status - The status of the response.

recipient - The intended recipient of the response. It could be null or empty string since it's optional.

contents - A List of Assertions that are the content of the Response. It could be null when there is no Assertion.

Response

public Response(java.lang.String responseID,
                Status status,
                java.lang.String recipient,
                java.util.List contents)
         throws SAMLException

This constructor shall only be used at the server side to construct a Response object. NOTE: The content here is just the body for the Response. The constructor will add the unique ResponseId, MajorVersion, etc. to form a complete Response object.

Parameters:

responseID - If it's null, the constructor will create one.

status - The status of the response.

recipient - The intended recipient of the response. It could be null or empty string since it's optional.

contents - A List of Assertions that are the content of the Response. It could be null when there is no Assertion.

Response

public Response(java.lang.String responseID,
                Status status,
                java.util.List contents)
         throws SAMLException

This constructor shall only be used at the server side to construct a Response object. NOTE: The content here is just the body for the Response. The constructor will add the unique ResponseId, MajorVersion, etc. to form a complete Response object.

Parameters:

responseID - If it's null, the constructor will create one.

status - The status of the response.

contents - A List of Assertions that are the content of the Response. It could be null when there is no Assertion.

Response

public Response(org.w3c.dom.Element root)
         throws SAMLException

Constructor.

Method Detail

signXML

public void signXML()
             throws SAMLException

Method that signs the Response.

Overrides:

signXML in class AbstractResponse

Throws:

SAMLException - if couldn't sign the Response.

parseXML

public static Response parseXML(java.lang.String xml)
                         throws SAMLException

This method is used primarily at the client side to reconstruct a Response object based on the XML document received from server. The schema of the XML document is describe above.

Parameters:

xml - The Response XML document String. NOTE: this is a complete SAML response xml string with ResponseID, MajorVersion, etc.

Returns:

Response

Throws:

SAMLException - when an error occurs.

parseXML

public static Response parseXML(java.io.InputStream is)
                         throws SAMLException

getAssertion

public java.util.List getAssertion()

This method returns the set of Assertions that is the content of the response.

Returns:

The set of Assertions that is the content of the response. It could be Collections.EMPTY_LIST when there is no Assertion in the response.

addAssertion

public boolean addAssertion(Assertion assertion)

Add an assertion to the Response.

Parameters:

assertion - The assertion to be added.

Returns:

A boolean value: true if the operation is successful; false otherwise.

getStatus

public Status getStatus()

Gets the Status of the Response.

Returns:

The Status of the response.

setStatus

public boolean setStatus(Status status)

Set the Status of the Response.

Parameters:

status - The Status of the Response to be set.

Returns:

A boolean value: true if the operation is successfule; false otherwise.

setSignature

public boolean setSignature(org.w3c.dom.Element elem)

Set the signature for the Response.

Overrides:

setSignature in class AbstractResponse

Parameters:

elem - ds:Signature element

Returns:

A boolean value: true if the operation succeeds; false otherwise.

toString

public java.lang.String toString()

This method translates the response to an XML document String based on the Response schema described above.

Overrides:

toString in class java.lang.Object

Returns:

An XML String representing the response. NOTE: this is a complete SAML response xml string with ResponseID, MajorVersion, etc.

toString

public java.lang.String toString(boolean includeNS,
                                 boolean declareNS)

Creates a String representation of the <samlp:Response> element.

Parameters:

IncludeNS - : Determines whether or not the namespace qualifier is prepended to the Element when converted

DeclareNS - : Determines whether or not the namespace is declared within the Element.

Returns:

A string containing the valid XML for this element

toString

public java.lang.String toString(boolean includeNS,
                                 boolean declareNS,
                                 boolean includeHeader)

Creates a String representation of the <samlp:Response> element.

Parameters:

IncludeNS - : Determines whether or not the namespace qualifier is prepended to the Element when converted

DeclareNS - : Determines whether or not the namespace is declared within the Element.

includeHeader: - Determines whether the output include the xml declaration header.

Returns:

A string containing the valid XML for this element