org.opensaml.saml2.metadata.impl
Class RoleDescriptorImpl

java.lang.Object
  org.opensaml.xml.AbstractXMLObject
      org.opensaml.xml.signature.AbstractSignableXMLObject
          org.opensaml.xml.AbstractValidatingSignableXMLObject
              org.opensaml.common.impl.AbstractSignableSAMLObject
                  org.opensaml.saml2.metadata.impl.RoleDescriptorImpl

All Implemented Interfaces:

SAMLObject, SignableSAMLObject, CacheableSAMLObject, TimeBoundSAMLObject, RoleDescriptor, AttributeExtensibleXMLObject, SignableXMLObject, ValidatingXMLObject, XMLObject

Direct Known Subclasses:

AttributeAuthorityDescriptorImpl, AuthnAuthorityDescriptorImpl, PDPDescriptorImpl, QueryDescriptorTypeImpl, SSODescriptorImpl

public abstract class RoleDescriptorImpl
extends AbstractSignableSAMLObject
implements RoleDescriptor

Concrete implementation of RoleDescriptor.

Field Summary

private Long	cacheDuration cacheDurection attribute.
private XMLObjectChildrenList<ContactPerson>	contactPersons Contact persons for this role.
private String	errorURL Error URL.
private Extensions	extensions Extensions child.
private String	id ID attribute.
private XMLObjectChildrenList<KeyDescriptor>	keyDescriptors Key descriptors for this role.
private Organization	organization Organization administering this role.
private List<String>	supportedProtocols Set of supported protocols.
private AttributeMap	unknownAttributes "anyAttribute" attributes.
private org.joda.time.DateTime	validUntil validUntil attribute.

Fields inherited from interface org.opensaml.saml2.metadata.RoleDescriptor

DEFAULT_ELEMENT_LOCAL_NAME, DEFAULT_ELEMENT_NAME, ERROR_URL_ATTRIB_NAME, ID_ATTRIB_NAME, PROTOCOL_ENUMERATION_ATTRIB_NAME, TYPE_LOCAL_NAME, TYPE_NAME

Fields inherited from interface org.opensaml.saml2.common.TimeBoundSAMLObject

VALID_UNTIL_ATTRIB_NAME, VALID_UNTIL_ATTRIB_QNAME

Fields inherited from interface org.opensaml.saml2.common.CacheableSAMLObject

CACHE_DURATION_ATTRIB_NAME, CACHE_DURATION_ATTRIB_QNAME

Constructor Summary

protected

RoleDescriptorImpl(String namespaceURI, String elementLocalName, String namespacePrefix) Constructor.

Method Summary

void	addSupportedProtocol(String protocol) Adds a protocol to the list of supported protocols for this role.
Long	getCacheDuration() Gets the maximum time, in milliseconds, that this descriptor should be cached.
List<ContactPerson>	getContactPersons() Gets an immutable list of ContactPersons for this role.
String	getErrorURL() Gets the URI users should be sent to in the event of an error.
Extensions	getExtensions() Gets the Extensions child of this object.
String	getID() Gets the ID of this role descriptor.
List<KeyDescriptor>	getKeyDescriptors() Gets the key descriptors for this role.
List<XMLObject>	getOrderedChildren()
Organization	getOrganization() Gets the organization responsible for this role.
String	getSignatureReferenceID() Gets the value of the ID attribute for this SAML object which will be used as its signature reference.
List<String>	getSupportedProtocols() Gets an immutable list of protocol URIs supported by this role.
AttributeMap	getUnknownAttributes()
org.joda.time.DateTime	getValidUntil() Gets the date until which this descriptor is valid.
boolean	isSupportedProtocol(String protocol) Chckes to see if the given protocol is supported by this role.
boolean	isValid() Checks to see if the current time is past the validUntil time.
void	removeAllSupportedProtocols() Removes all the supported protocols from this role.
void	removeSupportedProtocol(String protocol) Removes a protocol to the list of supported protocols for this role.
void	removeSupportedProtocols(Collection<String> protocols) Removes a list of protocols to the list of supported protocols for this role.
void	setCacheDuration(Long duration) Sets the maximum time, in milliseconds, that this descriptor should be cached.
void	setErrorURL(String errorURL) Sets the URI users should be sent to in the event of an error.
void	setExtensions(Extensions extensions) Sets the Extensions child of this object.
void	setID(String newID) Sets the ID of this role descriptor.
void	setOrganization(Organization organization) Sets the organization responsible for this role.
void	setValidUntil(org.joda.time.DateTime validUntil) Sets the date until which this descriptor is valid.

Methods inherited from class org.opensaml.common.impl.AbstractSignableSAMLObject

equals, prepareForAssignment, setSignature

Methods inherited from class org.opensaml.xml.AbstractValidatingSignableXMLObject

deregisterValidator, getValidators, registerValidator, validate, validateChildren

Methods inherited from class org.opensaml.xml.signature.AbstractSignableXMLObject

getSignature, isSigned

Methods inherited from class org.opensaml.xml.AbstractXMLObject

addNamespace, detach, getDOM, getElementQName, getIDIndex, getNamespaceManager, getNamespaces, getNoNamespaceSchemaLocation, getParent, getSchemaLocation, getSchemaType, hasChildren, hasParent, isNil, isNilXSBoolean, manageQualifiedAttributeNamespace, prepareAttributeValueForAssignment, prepareElementContentForAssignment, prepareForAssignment, prepareForAssignment, prepareForAssignment, prepareForAssignment, registerOwnID, releaseChildrenDOM, releaseDOM, releaseParentDOM, releaseThisAndChildrenDOM, releaseThisandParentDOM, removeNamespace, resolveID, resolveIDFromRoot, setDOM, setElementNamespacePrefix, setElementQName, setNil, setNil, setNoNamespaceSchemaLocation, setParent, setSchemaLocation, setSchemaType

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opensaml.saml2.metadata.RoleDescriptor

getEndpoints, getEndpoints

Methods inherited from interface org.opensaml.xml.signature.SignableXMLObject

getSignature, isSigned, setSignature

Methods inherited from interface org.opensaml.xml.validation.ValidatingXMLObject

deregisterValidator, getValidators, registerValidator, validate

Methods inherited from interface org.opensaml.xml.XMLObject

addNamespace, detach, getDOM, getElementQName, getIDIndex, getNamespaceManager, getNamespaces, getNoNamespaceSchemaLocation, getParent, getSchemaLocation, getSchemaType, hasChildren, hasParent, isNil, isNilXSBoolean, releaseChildrenDOM, releaseDOM, releaseParentDOM, removeNamespace, resolveID, resolveIDFromRoot, setDOM, setNil, setNil, setNoNamespaceSchemaLocation, setParent, setSchemaLocation

Field Detail

id

private String id

ID attribute.

validUntil

private org.joda.time.DateTime validUntil

validUntil attribute.

cacheDuration

private Long cacheDuration

cacheDurection attribute.

supportedProtocols

private final List<String> supportedProtocols

Set of supported protocols.

errorURL

private String errorURL

Error URL.

extensions

private Extensions extensions

Extensions child.

organization

private Organization organization

Organization administering this role.

unknownAttributes

private final AttributeMap unknownAttributes

"anyAttribute" attributes.

contactPersons

private final XMLObjectChildrenList<ContactPerson> contactPersons

Contact persons for this role.

keyDescriptors

private final XMLObjectChildrenList<KeyDescriptor> keyDescriptors

Key descriptors for this role.

Constructor Detail

RoleDescriptorImpl

protected RoleDescriptorImpl(String namespaceURI,
                             String elementLocalName,
                             String namespacePrefix)

Constructor.

Parameters:

namespaceURI - the namespace the element is in

elementLocalName - the local name of the XML element this Object represents

namespacePrefix - the prefix for the given namespace

Method Detail

getID

public String getID()

Gets the ID of this role descriptor.

Specified by:

getID in interface RoleDescriptor

Returns:

the ID of this role descriptor

setID

public void setID(String newID)

Sets the ID of this role descriptor.

Specified by:

setID in interface RoleDescriptor

Parameters:

newID - the ID of this role descriptor

isValid

public boolean isValid()

Checks to see if the current time is past the validUntil time.

Specified by:

isValid in interface TimeBoundSAMLObject

Returns:

true of this descriptor is still valid otherwise false

getValidUntil

public org.joda.time.DateTime getValidUntil()

Gets the date until which this descriptor is valid.

Specified by:

getValidUntil in interface TimeBoundSAMLObject

Returns:

the date until which this descriptor is valid

setValidUntil

public void setValidUntil(org.joda.time.DateTime validUntil)

Sets the date until which this descriptor is valid.

Specified by:

setValidUntil in interface TimeBoundSAMLObject

Parameters:

validUntil - the date until which this descriptor is valid

getCacheDuration

public Long getCacheDuration()

Gets the maximum time, in milliseconds, that this descriptor should be cached.

Specified by:

getCacheDuration in interface CacheableSAMLObject

Returns:

the maximum time that this descriptor should be cached

setCacheDuration

public void setCacheDuration(Long duration)

Sets the maximum time, in milliseconds, that this descriptor should be cached.

Specified by:

setCacheDuration in interface CacheableSAMLObject

Parameters:

duration - the maximum time that this descriptor should be cached

getSupportedProtocols

public List<String> getSupportedProtocols()

Gets an immutable list of protocol URIs supported by this role.

Specified by:

getSupportedProtocols in interface RoleDescriptor

Returns:

list of protocol URIs supported by this role

isSupportedProtocol

public boolean isSupportedProtocol(String protocol)

Chckes to see if the given protocol is supported by this role.

Specified by:

isSupportedProtocol in interface RoleDescriptor

Parameters:

protocol - the protocol

Returns:

true if the protocol is supported, false if not

addSupportedProtocol

public void addSupportedProtocol(String protocol)

Adds a protocol to the list of supported protocols for this role.

Specified by:

addSupportedProtocol in interface RoleDescriptor

Parameters:

protocol - the protocol

removeSupportedProtocol

public void removeSupportedProtocol(String protocol)

Removes a protocol to the list of supported protocols for this role.

Specified by:

removeSupportedProtocol in interface RoleDescriptor

Parameters:

protocol - the protocol

removeSupportedProtocols

public void removeSupportedProtocols(Collection<String> protocols)

Removes a list of protocols to the list of supported protocols for this role.

Specified by:

removeSupportedProtocols in interface RoleDescriptor

Parameters:

protocols - the protocol

removeAllSupportedProtocols

public void removeAllSupportedProtocols()

Removes all the supported protocols from this role.

Specified by:

removeAllSupportedProtocols in interface RoleDescriptor

getErrorURL

public String getErrorURL()

Gets the URI users should be sent to in the event of an error.

Specified by:

getErrorURL in interface RoleDescriptor

Returns:

the URI users should be sent to in the event of an error

setErrorURL

public void setErrorURL(String errorURL)

Sets the URI users should be sent to in the event of an error.

Specified by:

setErrorURL in interface RoleDescriptor

Parameters:

errorURL - the URI users should be sent to in the event of an error

getExtensions

public Extensions getExtensions()

Gets the Extensions child of this object.

Specified by:

getExtensions in interface RoleDescriptor

Returns:

the Extensions child of this object

setExtensions

public void setExtensions(Extensions extensions)
                   throws IllegalArgumentException

Sets the Extensions child of this object.

Specified by:

setExtensions in interface RoleDescriptor

Parameters:

extensions - the Extensions child of this object

Throws:

IllegalArgumentException - thrown if the given extensions Object is already a child of another SAMLObject

getOrganization

public Organization getOrganization()

Gets the organization responsible for this role.

Specified by:

getOrganization in interface RoleDescriptor

Returns:

the organization responsible for this role

setOrganization

public void setOrganization(Organization organization)
                     throws IllegalArgumentException

Sets the organization responsible for this role.

Specified by:

setOrganization in interface RoleDescriptor

Parameters:

organization - the organization responsible for this role

Throws:

IllegalArgumentException - thrown if the given organization is owned by another element

getContactPersons

public List<ContactPerson> getContactPersons()

Gets an immutable list of ContactPersons for this role.

Specified by:

getContactPersons in interface RoleDescriptor

Returns:

list of ContactPersons for this role

getKeyDescriptors

public List<KeyDescriptor> getKeyDescriptors()

Gets the key descriptors for this role.

Specified by:

getKeyDescriptors in interface RoleDescriptor

Returns:

the key descriptors for this role

getUnknownAttributes

public AttributeMap getUnknownAttributes()

Specified by:

getUnknownAttributes in interface AttributeExtensibleXMLObject

getSignatureReferenceID

public String getSignatureReferenceID()

Gets the value of the ID attribute for this SAML object which will be used as its signature reference.

Specified by:

getSignatureReferenceID in interface SignableSAMLObject

Returns:

the value of this SAMLObject ID attribute

getOrderedChildren

public List<XMLObject> getOrderedChildren()

Specified by:

getOrderedChildren in interface XMLObject