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:

net.shibboleth.utilities.java.support.component.Component, net.shibboleth.utilities.java.support.component.DestructableComponent, net.shibboleth.utilities.java.support.component.InitializableComponent, net.shibboleth.utilities.java.support.component.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.
private Logger	log Class logger.
private VelocityEngine	velocityEngine Velocity engine used to evaluate the template when performing POST encoding.
private String	velocityTemplateId ID of the Velocity template used when performing POST encoding.

Constructor Summary

Constructors

Constructor and Description
HTTPPostEncoder() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doDestroy()
protected void	doEncode()
protected void	doInitialize()
String	getBindingURI()
VelocityEngine	getVelocityEngine() Get the VelocityEngine instance.
String	getVelocityTemplateId() Get the Velocity template id.
protected void	populateVelocityContext(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(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

log

private final Logger log

Class logger.

velocityEngine

private VelocityEngine velocityEngine

Velocity engine used to evaluate the template when performing POST encoding.

velocityTemplateId

private String velocityTemplateId

ID of the Velocity template used when performing POST encoding.

Constructor Detail

HTTPPostEncoder

public HTTPPostEncoder()

Constructor.

Method Detail

getBindingURI

public String getBindingURI()

getVelocityEngine

public VelocityEngine getVelocityEngine()

Get the VelocityEngine instance.

Returns:

return the VelocityEngine instance

setVelocityEngine

public void setVelocityEngine(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()

Overrides:

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

doInitialize

protected void doInitialize()
                     throws net.shibboleth.utilities.java.support.component.ComponentInitializationException

Overrides:

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

Throws:

net.shibboleth.utilities.java.support.component.ComponentInitializationException

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(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