Package org.opensaml.messaging.decoder.httpclient

Class BaseHttpClientResponseXMLMessageDecoder

java.lang.Object

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

org.opensaml.messaging.decoder.AbstractMessageDecoder

org.opensaml.messaging.decoder.httpclient.AbstractHttpClientResponseMessageDecoder

org.opensaml.messaging.decoder.httpclient.BaseHttpClientResponseXMLMessageDecoder

All Implemented Interfaces:

Component, DestructableComponent, InitializableComponent, UnmodifiableComponent, HttpClientResponseMessageDecoder, MessageDecoder

Direct Known Subclasses:

HttpClientResponseSOAP11Decoder

public abstract class BaseHttpClientResponseXMLMessageDecoder
extends AbstractHttpClientResponseMessageDecoder

Base class for message decoders which decode XML messages from an HttpResponse.

Field Summary

Fields

Modifier and Type	Field	Description
private final org.slf4j.Logger	log	Class logger.
private ParserPool	parserPool	Parser pool used to deserialize the message.
private org.slf4j.Logger	protocolMessageLog	Used to log protocol messages.

Constructor Summary

Constructors

Constructor	Description
BaseHttpClientResponseXMLMessageDecoder()	Constructor.

Method Summary

Modifier and Type	Method	Description
void	decode()	Decode message data from the source and store it so that it may be retrieved via MessageDecoder.getMessageContext().
protected void	doDestroy()
protected void	doInitialize()
protected Object	getMessageToLog()	Get the XMLObject which will be logged as the protocol message.
ParserPool	getParserPool()	Gets the parser pool used to deserialize incoming messages.
protected void	logDecodedMessage()	Log the decoded message to the protocol message logger.
void	setParserPool(ParserPool pool)	Sets the parser pool used to deserialize incoming messages.
protected XMLObject	unmarshallMessage(InputStream messageStream)	Helper method that deserializes and unmarshalls the message from the given stream.

Methods inherited from class org.opensaml.messaging.decoder.httpclient.AbstractHttpClientResponseMessageDecoder

getHttpResponse, setHttpResponse

Methods inherited from class org.opensaml.messaging.decoder.AbstractMessageDecoder

doDecode, getMessageContext, 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 net.shibboleth.utilities.java.support.component.DestructableComponent

destroy, isDestroyed

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

initialize, isInitialized

Methods inherited from interface org.opensaml.messaging.decoder.MessageDecoder

getMessageContext

Field Details

protocolMessageLog

private org.slf4j.Logger protocolMessageLog

Used to log protocol messages.

log

private final org.slf4j.Logger log

Class logger.

parserPool

private ParserPool parserPool

Parser pool used to deserialize the message.

Constructor Details

BaseHttpClientResponseXMLMessageDecoder

public BaseHttpClientResponseXMLMessageDecoder()

Constructor.

Method Details

decode

public void decode()
            throws MessageDecodingException

Decode message data from the source and store it so that it may be retrieved via MessageDecoder.getMessageContext().

Specified by:

decode in interface MessageDecoder

Overrides:

decode in class AbstractHttpClientResponseMessageDecoder

Throws:

MessageDecodingException - if there is a problem decoding the message context

getParserPool

@Nonnull
public ParserPool getParserPool()

Gets the parser pool used to deserialize incoming messages.

Returns:

parser pool used to deserialize incoming messages

setParserPool

public void setParserPool(@Nonnull
 ParserPool pool)

Sets the parser pool used to deserialize incoming messages.

Parameters:

pool - parser pool used to deserialize incoming messages

doDestroy

protected void doDestroy()

Overrides:

doDestroy in class AbstractHttpClientResponseMessageDecoder

doInitialize

protected void doInitialize()
                     throws ComponentInitializationException

Overrides:

doInitialize in class AbstractHttpClientResponseMessageDecoder

Throws:

ComponentInitializationException

logDecodedMessage

protected void logDecodedMessage()

Log the decoded message to the protocol message logger.

getMessageToLog

protected Object getMessageToLog()

Get the XMLObject which will be logged as the protocol message.

Returns:

the XMLObject message considered to be the protocol message for logging purposes

unmarshallMessage

protected XMLObject unmarshallMessage(InputStream messageStream)
                               throws MessageDecodingException

Helper method that deserializes and unmarshalls the message from the given stream.

Parameters:

messageStream - input stream containing the message

Returns:

the inbound message

Throws:

MessageDecodingException - thrown if there is a problem deserializing and unmarshalling the message