org.opensaml.saml.saml2.binding.encoding.impl

Class HTTPPostEncoder

java.lang.Object

net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

org.opensaml.messaging.encoder.AbstractMessageEncoder<MessageType>

org.opensaml.messaging.encoder.servlet.AbstractHttpServletResponseMessageEncoder<MessageType>

org.opensaml.messaging.encoder.servlet.BaseHttpServletResponseXMLMessageEncoder<SAMLObject>

org.opensaml.saml.saml2.binding.encoding.impl.BaseSAML2MessageEncoder

org.opensaml.saml.saml2.binding.encoding.impl.HTTPPostEncoder

All Implemented Interfaces:

Component, DestructableComponent, InitializableComponent, UnmodifiableComponent, org.opensaml.messaging.encoder.MessageEncoder<SAMLObject>, org.opensaml.messaging.encoder.servlet.HttpServletResponseMessageEncoder<SAMLObject>, SAMLMessageEncoder

Direct Known Subclasses:

HTTPPostSimpleSignEncoder

public class HTTPPostEncoder
extends BaseSAML2MessageEncoder

SAML 2.0 HTTP Post binding message encoder.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_TEMPLATE_ID Default template ID.

Constructor Summary

Constructors

Constructor and Description
HTTPPostEncoder() Constructor.

Method Summary

Modifier and Type	Method and Description
protected void	doDestroy() Performs component specific destruction logic.
protected void	doEncode()
protected void	doInitialize() Performs the initialization of the component.
String	getBindingURI() Gets the SAML binding URI supported by this encoder.
org.apache.velocity.app.VelocityEngine	getVelocityEngine() Get the VelocityEngine instance.
String	getVelocityTemplateId() Get the Velocity template id.
protected void	populateVelocityContext(org.apache.velocity.VelocityContext velocityContext, org.opensaml.messaging.context.MessageContext<SAMLObject> messageContext, String endpointURL) Populate the Velocity context instance which will be used to render the POST body.
protected void	postEncode(org.opensaml.messaging.context.MessageContext<SAMLObject> messageContext, String endpointURL) Base64 and POST encodes the outbound message and writes it to the outbound transport.
void	setVelocityEngine(org.apache.velocity.app.VelocityEngine newVelocityEngine) Set the VelocityEngine instance.
void	setVelocityTemplateId(String newVelocityTemplateId) Set the Velocity template id.

Methods inherited from class org.opensaml.saml.saml2.binding.encoding.impl.BaseSAML2MessageEncoder

getEndpointURL

Methods inherited from class org.opensaml.messaging.encoder.servlet.BaseHttpServletResponseXMLMessageEncoder

encode, getMessageToLog, logEncodedMessage, marshallMessage

Methods inherited from class org.opensaml.messaging.encoder.servlet.AbstractHttpServletResponseMessageEncoder

getHttpServletResponse, setHttpServletResponse

Methods inherited from class org.opensaml.messaging.encoder.AbstractMessageEncoder

getMessageContext, prepareContext, setMessageContext

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opensaml.messaging.encoder.MessageEncoder

encode, prepareContext, setMessageContext

Methods inherited from interface net.shibboleth.utilities.java.support.component.InitializableComponent

initialize, isInitialized

Methods inherited from interface net.shibboleth.utilities.java.support.component.DestructableComponent

destroy, isDestroyed

Field Detail

DEFAULT_TEMPLATE_ID

public static final String DEFAULT_TEMPLATE_ID

Default template ID.

See Also:

Constant Field Values

Constructor Detail

HTTPPostEncoder

public HTTPPostEncoder()

Constructor.

Method Detail

getBindingURI

public String getBindingURI()

Gets the SAML binding URI supported by this encoder.

Returns:

SAML binding URI supported by this encoder

getVelocityEngine

public org.apache.velocity.app.VelocityEngine getVelocityEngine()

Get the VelocityEngine instance.

Returns:

return the VelocityEngine instance

setVelocityEngine

public void setVelocityEngine(org.apache.velocity.app.VelocityEngine newVelocityEngine)

Set the VelocityEngine instance.

Parameters:

newVelocityEngine - the new VelocityEngine instane

getVelocityTemplateId

public String getVelocityTemplateId()

Get the Velocity template id.

Defaults to DEFAULT_TEMPLATE_ID.

Returns:

return the Velocity template id

setVelocityTemplateId

public void setVelocityTemplateId(String newVelocityTemplateId)

Set the Velocity template id.

Defaults to DEFAULT_TEMPLATE_ID.

Parameters:

newVelocityTemplateId - the new Velocity template id

doDestroy

protected void doDestroy()

Performs component specific destruction logic. This method is executed within the lock on the object being destroyed. The default implementation of this method is a no-op.

Overrides:

doDestroy in class org.opensaml.messaging.encoder.servlet.AbstractHttpServletResponseMessageEncoder<SAMLObject>

doInitialize

protected void doInitialize()
                     throws ComponentInitializationException

Performs the initialization of the component. This method is executed within the lock on the object being initialized. The default implementation of this method is a no-op.

Overrides:

doInitialize in class org.opensaml.messaging.encoder.servlet.AbstractHttpServletResponseMessageEncoder<SAMLObject>

Throws:

ComponentInitializationException - thrown if there is a problem initializing the component

doEncode

protected void doEncode()
                 throws org.opensaml.messaging.encoder.MessageEncodingException

Specified by:

doEncode in class org.opensaml.messaging.encoder.AbstractMessageEncoder<SAMLObject>

Throws:

org.opensaml.messaging.encoder.MessageEncodingException

postEncode

protected void postEncode(org.opensaml.messaging.context.MessageContext<SAMLObject> messageContext,
                          String endpointURL)
                   throws org.opensaml.messaging.encoder.MessageEncodingException

Base64 and POST encodes the outbound message and writes it to the outbound transport.

Parameters:

messageContext - current message context

endpointURL - endpoint URL to which to encode message

Throws:

org.opensaml.messaging.encoder.MessageEncodingException - thrown if there is a problem encoding the message

populateVelocityContext

protected void populateVelocityContext(org.apache.velocity.VelocityContext velocityContext,
                                       org.opensaml.messaging.context.MessageContext<SAMLObject> messageContext,
                                       String endpointURL)
                                throws org.opensaml.messaging.encoder.MessageEncodingException

Populate the Velocity context instance which will be used to render the POST body.

Parameters:

velocityContext - the Velocity context instance to populate with data

messageContext - the SAML message context source of data

endpointURL - endpoint URL to which to encode message

Throws:

org.opensaml.messaging.encoder.MessageEncodingException - thrown if there is a problem encoding the message