Package se.litsec.opensaml.core

Class AbstractSAMLObjectBuilder<T extends SAMLObject>

java.lang.Object

se.litsec.opensaml.core.AbstractSAMLObjectBuilder<T>

Type Parameters:

T - the type

All Implemented Interfaces:

SAMLObjectBuilder<T>

Direct Known Subclasses:

AbstractEntityDescriptorBuilder, AbstractRequestBuilder, AssertionConsumerServiceBuilder, AttributeBuilder, AttributeConsumingServiceBuilder, ContactPersonBuilder, DigestMethodBuilder, EncryptionMethodBuilder, KeyDescriptorBuilder, LogoBuilder, NameIDPolicyBuilder, OrganizationBuilder, RequestedAttributeBuilder, RequestedAuthnContextBuilder, ScopingBuilder, SigningMethodBuilder, SingleLogoutServiceBuilder, SingleSignOnServiceBuilder, UIInfoBuilder

public abstract class AbstractSAMLObjectBuilder<T extends SAMLObject>
extends Object
implements SAMLObjectBuilder<T>

Abstract base class for the builder pattern.

Author:

Martin Lindström (martin.lindstrom@litsec.se)

Constructor Summary

Constructors

Constructor	Description
AbstractSAMLObjectBuilder()	Constructor setting up the object to build.
AbstractSAMLObjectBuilder(InputStream resource)	Constructor setting up the builder with a template object that is read from an input stream.
AbstractSAMLObjectBuilder(T template)	Constructor setting up the builder with a template object.

Method Summary

Modifier and Type	Method	Description
T	build()	The default implementation of this method assumes that the object has been built during assignment of its attributes and elements so it simply returns the object.
protected QName	getDefaultElementName()	Gets the default element name for the object.
protected abstract Class<T>	getObjectType()	Returns the object type.
T	object()	Returns the object being built.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractSAMLObjectBuilder

public AbstractSAMLObjectBuilder()

Constructor setting up the object to build.

AbstractSAMLObjectBuilder

public AbstractSAMLObjectBuilder(T template)
                          throws MarshallingException,
                                 UnmarshallingException

Constructor setting up the builder with a template object. Users of the instance may now change, add or delete, the elements and attributes of the template object using the assignment methods of the builder.

Note that the supplied object is cloned, so any modifications have no effect on the passed object.

Parameters:

template - the template object

Throws:

UnmarshallingException - for unmarshalling errors

MarshallingException - for marshalling errors

AbstractSAMLObjectBuilder

public AbstractSAMLObjectBuilder(InputStream resource)
                          throws XMLParserException,
                                 UnmarshallingException

Constructor setting up the builder with a template object that is read from an input stream. Users of the instance may now change, add or delete, the elements and attributes of the template object using the assignment methods of the builder.

Parameters:

resource - the template resource

Throws:

UnmarshallingException - for unmarshalling errors

XMLParserException - for XML parsing errors

Method Detail

build

public T build()

The default implementation of this method assumes that the object has been built during assignment of its attributes and elements so it simply returns the object.

Implementations that need to perform additional processing during the build step should override this method.

Specified by:

build in interface SAMLObjectBuilder<T extends SAMLObject>

Returns:

the built object

getObjectType

protected abstract Class<T> getObjectType()

Returns the object type.

Returns:

the object type

object

public final T object()

Returns the object being built.

Returns:

the object

getDefaultElementName

protected QName getDefaultElementName()

Gets the default element name for the object.

Returns:

a QName