gov.nih.nci.cagrid.opensaml
Class SAMLAttributeQuery

java.lang.Object
  gov.nih.nci.cagrid.opensaml.SAMLObject
      gov.nih.nci.cagrid.opensaml.SAMLQuery
          gov.nih.nci.cagrid.opensaml.SAMLSubjectQuery
              gov.nih.nci.cagrid.opensaml.SAMLAttributeQuery

All Implemented Interfaces:

java.lang.Cloneable

public class SAMLAttributeQuery
extends SAMLSubjectQuery
implements java.lang.Cloneable

Represents a SAML Attribute Query object

Author:

Scott Cantor

Field Summary

protected java.util.ArrayList	designators
protected java.lang.String	resource

Fields inherited from class gov.nih.nci.cagrid.opensaml.SAMLSubjectQuery

subject

Fields inherited from class gov.nih.nci.cagrid.opensaml.SAMLQuery

queryTypeMap

Fields inherited from class gov.nih.nci.cagrid.opensaml.SAMLObject

config, dirty, log, parentObject, root

Constructor Summary

SAMLAttributeQuery()
Default constructor

SAMLAttributeQuery(org.w3c.dom.Element e)
Reconstructs an attribute query from a DOM tree

SAMLAttributeQuery(java.io.InputStream in)
Reconstructs an attribute query from a stream

SAMLAttributeQuery(SAMLSubject subject, java.lang.String resource, java.util.Collection designators)
Builds an attribute query out of its component parts

Method Summary

void	addDesignator(SAMLAttributeDesignator designator) Adds an attribute designator to the query
protected org.w3c.dom.Element	buildRoot(org.w3c.dom.Document doc, boolean xmlns) Delegates the process of building the root element of an object and inserting appropriate namespaces.
java.lang.Object	clone() Copies a SAML object such that no dependencies exist between the original and the copy
void	fromDOM(org.w3c.dom.Element e) Initialization of an object from a DOM element
java.util.Iterator	getDesignators() Gets the attribute designators inside the query
java.lang.String	getResource() Gets the resource URI inside the query
void	removeDesignator(int index) Removes a designator by position (zero-based)
void	setDesignators(java.util.Collection designators) Sets the attribute designators inside the query
void	setResource(java.lang.String resource) Sets the resource URI inside the query
org.w3c.dom.Node	toDOM(org.w3c.dom.Document doc, boolean xmlns) Transforms the object into a DOM tree using an existing document context

Methods inherited from class gov.nih.nci.cagrid.opensaml.SAMLSubjectQuery

checkValidity, getSubject, setSubject

Methods inherited from class gov.nih.nci.cagrid.opensaml.SAMLQuery

getInstance, getInstance, regFactory, unregFactory

Methods inherited from class gov.nih.nci.cagrid.opensaml.SAMLObject

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

resource

protected java.lang.String resource

designators

protected java.util.ArrayList designators

Constructor Detail

SAMLAttributeQuery

public SAMLAttributeQuery()

Default constructor

SAMLAttributeQuery

public SAMLAttributeQuery(SAMLSubject subject,
                          java.lang.String resource,
                          java.util.Collection designators)
                   throws SAMLException

Builds an attribute query out of its component parts

Parameters:

subject - Subject of query

resource - URI of resource being accessed at time of query

designators - Indicates specific attributes to query for

Throws:

SAMLException - Raised if the query cannot be constructed from the supplied information

SAMLAttributeQuery

public SAMLAttributeQuery(org.w3c.dom.Element e)
                   throws SAMLException

Reconstructs an attribute query from a DOM tree

Parameters:

e - The root of a DOM tree

Throws:

SAMLException - Thrown if the object cannot be constructed

SAMLAttributeQuery

public SAMLAttributeQuery(java.io.InputStream in)
                   throws SAMLException

Reconstructs an attribute query 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(org.w3c.dom.Element e)
             throws SAMLException

Description copied from class: SAMLObject

Initialization of an object from a DOM element

Overrides:

fromDOM in class SAMLSubjectQuery

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)

getResource

public java.lang.String getResource()

Gets the resource URI inside the query

Returns:

The resource URI

setResource

public void setResource(java.lang.String resource)

Sets the resource URI inside the query

Parameters:

resource - The resource URI

getDesignators

public java.util.Iterator getDesignators()

Gets the attribute designators inside the query

Returns:

An iterator of attribute designators

setDesignators

public void setDesignators(java.util.Collection designators)
                    throws SAMLException

Sets the attribute designators inside the query

Parameters:

designators - The designators to include

Throws:

SAMLException - Raised if the designators are invalid

addDesignator

public void addDesignator(SAMLAttributeDesignator designator)
                   throws SAMLException

Adds an attribute designator to the query

Parameters:

designator - The designator to add

Throws:

SAMLException - Raised if the designator is invalid

removeDesignator

public void removeDesignator(int index)

Removes a designator by position (zero-based)

Parameters:

index - The position of the designator to remove

buildRoot

protected org.w3c.dom.Element buildRoot(org.w3c.dom.Document doc,
                                        boolean xmlns)

Description copied from class: SAMLObject

Delegates the process of building the root element of an object and inserting appropriate namespaces.

Specified by:

buildRoot in class SAMLObject

Parameters:

doc - The document context to use

xmlns - Include namespace(s) on root element?

Returns:

A new root element for the object

See Also:

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

toDOM

public org.w3c.dom.Node toDOM(org.w3c.dom.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 SAMLSubjectQuery

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)

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

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

Overrides:

clone in class SAMLSubjectQuery

Returns:

The new object

Throws:

java.lang.CloneNotSupportedException

See Also:

Object.clone()