org.opensaml
Class SAMLSubjectStatement

java.lang.Object
  org.opensaml.SAMLObject
      org.opensaml.SAMLStatement
          org.opensaml.SAMLSubjectStatement

All Implemented Interfaces:

Cloneable

Direct Known Subclasses:

SAMLAttributeStatement, SAMLAuthenticationStatement, SAMLAuthorizationDecisionStatement

public abstract class SAMLSubjectStatement
extends SAMLStatement
implements Cloneable

Abstract class for a SAML Subject Statement

Author:

Scott Cantor

Field Summary

protected SAMLSubject

subject

Fields inherited from class org.opensaml.SAMLStatement

statementTypeMap

Fields inherited from class org.opensaml.SAMLObject

config, dirty, log, parentObject, root

Constructor Summary

protected	SAMLSubjectStatement() Default constructor
protected	SAMLSubjectStatement(Element e) Reconstructs a subject statement from a DOM tree
protected	SAMLSubjectStatement(InputStream in) Reconstructs a subject statement from a stream
protected	SAMLSubjectStatement(SAMLSubject subject) Builds a statement out of its component parts

Method Summary

void	checkValidity() Evaluates the object's content to see if it is currently valid if serialized.
Object	clone() Copies a SAML object such that no dependencies exist between the original and the copy
void	fromDOM(Element e) Initialization of an object from a DOM element
SAMLSubject	getSubject() Gets the statement subject
void	setSubject(SAMLSubject subject) Sets the statement subject
Node	toDOM(Document doc, boolean xmlns) Transforms the object into a DOM tree using an existing document context

Methods inherited from class org.opensaml.SAMLStatement

getInstance, getInstance, regFactory, unregFactory

Methods inherited from class org.opensaml.SAMLObject

buildRoot, fromStream, fromStream, getParent, plantRoot, setDirty, setParent, toBase64, toDOM, toDOM, toDOM, toStream, toString

Methods inherited from class java.lang.Object

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

Field Detail

subject

protected SAMLSubject subject

Constructor Detail

SAMLSubjectStatement

protected SAMLSubjectStatement()

Default constructor

SAMLSubjectStatement

protected SAMLSubjectStatement(SAMLSubject subject)
                        throws SAMLException

Builds a statement out of its component parts

Parameters:

subject - Subject of statement

Throws:

SAMLException - Raised if a statement cannot be constructed from the supplied information

SAMLSubjectStatement

protected SAMLSubjectStatement(Element e)
                        throws SAMLException

Reconstructs a subject statement from a DOM tree

Parameters:

e - The root of a DOM tree

Throws:

SAMLException - Thrown if the object cannot be constructed

SAMLSubjectStatement

protected SAMLSubjectStatement(InputStream in)
                        throws SAMLException

Reconstructs a subject statement from a stream

Parameters:

in - A stream containing XML

Throws:

SAMLException - Raised if an exception occurs while constructing the object.

Method Detail

fromDOM

public void fromDOM(Element e)
             throws SAMLException

Description copied from class: SAMLObject

Initialization of an object from a DOM element

Overrides:

fromDOM in class SAMLObject

Parameters:

e - Root element of a DOM tree

Throws:

SAMLException - Raised if an exception occurs while constructing the object

See Also:

SAMLObject.fromDOM(org.w3c.dom.Element)

getSubject

public SAMLSubject getSubject()

Gets the statement subject

Returns:

The statement subject

setSubject

public void setSubject(SAMLSubject subject)
                throws SAMLException

Sets the statement subject

Parameters:

subject - The statement subject

Throws:

SAMLException - Raised if the subject is invalid

toDOM

public Node toDOM(Document doc,
                  boolean xmlns)
           throws SAMLException

Description copied from class: SAMLObject

Transforms the object into a DOM tree using an existing document context

Overrides:

toDOM in class SAMLObject

Parameters:

doc - A Document object to use in manufacturing the tree

xmlns - Include namespace(s) on root element?

Returns:

Root element node of the DOM tree capturing the object

Throws:

SAMLException - Raised if the object is incompletely defined

See Also:

SAMLObject.toDOM(org.w3c.dom.Document,boolean)

checkValidity

public void checkValidity()
                   throws SAMLException

Description copied from class: SAMLObject

Evaluates the object's content to see if it is currently valid if serialized. Does not evaluate embedded objects except on the basis of whether they exist. For example, an Assertion must have a Statement, but if an invalid statement is added, SAMLAssertion.checkValidity() would succeed, while SAMLStatement.checkValidity would raise an exception.

Specified by:

checkValidity in class SAMLObject

Throws:

SAMLException - Raised if the serialized object would be invalid SAML, excluding any embedded objects

See Also:

SAMLObject.checkValidity()

clone

public Object clone()
             throws CloneNotSupportedException

Copies a SAML object such that no dependencies exist between the original and the copy

Overrides:

clone in class SAMLObject

Returns:

The new object

Throws:

CloneNotSupportedException

See Also:

Object.clone()