org.springframework.messaging.converter

Class MarshallingMessageConverter

java.lang.Object

org.springframework.messaging.converter.AbstractMessageConverter

org.springframework.messaging.converter.MarshallingMessageConverter

All Implemented Interfaces:

MessageConverter, SmartMessageConverter

public class MarshallingMessageConverter
extends AbstractMessageConverter

Implementation of MessageConverter that can read and write XML using Spring's Marshaller and Unmarshaller abstractions.

This converter requires a Marshaller and Unmarshaller before it can be used. These can be injected by the constructor or bean properties.

Since:

4.2

Author:

Arjen Poutsma

Field Summary

Fields

Modifier and Type	Field and Description
private Marshaller	marshaller
private Unmarshaller	unmarshaller

Fields inherited from class org.springframework.messaging.converter.AbstractMessageConverter

logger

Constructor Summary

Constructors

Constructor and Description
MarshallingMessageConverter() Default construct allowing for setMarshaller(Marshaller) and/or setUnmarshaller(Unmarshaller) to be invoked separately.
MarshallingMessageConverter(Marshaller marshaller) Constructor with Marshaller.
MarshallingMessageConverter(MimeType... supportedMimeTypes) Constructor with a given list of MIME types to support.

Method Summary

Modifier and Type	Method and Description
protected boolean	canConvertFrom(Message<?> message, java.lang.Class<?> targetClass)
protected boolean	canConvertTo(java.lang.Object payload, MessageHeaders headers)
protected java.lang.Object	convertFromInternal(Message<?> message, java.lang.Class<?> targetClass, java.lang.Object conversionHint) Convert the message payload from serialized form to an Object.
protected java.lang.Object	convertToInternal(java.lang.Object payload, MessageHeaders headers, java.lang.Object conversionHint) Convert the payload object to serialized form.
Marshaller	getMarshaller() Return the configured Marshaller.
private javax.xml.transform.Source	getSource(java.lang.Object payload)
Unmarshaller	getUnmarshaller() Return the configured unmarshaller.
void	setMarshaller(Marshaller marshaller) Set the Marshaller to be used by this message converter.
void	setUnmarshaller(Unmarshaller unmarshaller) Set the Unmarshaller to be used by this message converter.
protected boolean	supports(java.lang.Class<?> clazz) Whether the given class is supported by this converter.

Methods inherited from class org.springframework.messaging.converter.AbstractMessageConverter

convertFromInternal, convertToInternal, fromMessage, fromMessage, getContentTypeResolver, getDefaultContentType, getMimeType, getSerializedPayloadClass, getSupportedMimeTypes, isStrictContentTypeMatch, setContentTypeResolver, setSerializedPayloadClass, setStrictContentTypeMatch, supportsMimeType, toMessage, toMessage

Methods inherited from class java.lang.Object

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

Field Detail

marshaller

private Marshaller marshaller

unmarshaller

private Unmarshaller unmarshaller

Constructor Detail

MarshallingMessageConverter

public MarshallingMessageConverter()

Default construct allowing for setMarshaller(Marshaller) and/or setUnmarshaller(Unmarshaller) to be invoked separately.

MarshallingMessageConverter

public MarshallingMessageConverter(MimeType... supportedMimeTypes)

Constructor with a given list of MIME types to support.

Parameters:

supportedMimeTypes - the MIME types

MarshallingMessageConverter

public MarshallingMessageConverter(Marshaller marshaller)

Constructor with Marshaller. If the given Marshaller also implements Unmarshaller, it is also used for unmarshalling.

Note that all Marshaller implementations in Spring also implement Unmarshaller so that you can safely use this constructor.

Parameters:

marshaller - object used as marshaller and unmarshaller

Method Detail

setMarshaller

public void setMarshaller(Marshaller marshaller)

Set the Marshaller to be used by this message converter.

getMarshaller

public Marshaller getMarshaller()

Return the configured Marshaller.

setUnmarshaller

public void setUnmarshaller(Unmarshaller unmarshaller)

Set the Unmarshaller to be used by this message converter.

getUnmarshaller

public Unmarshaller getUnmarshaller()

Return the configured unmarshaller.

canConvertFrom

protected boolean canConvertFrom(Message<?> message,
                                 java.lang.Class<?> targetClass)

Overrides:

canConvertFrom in class AbstractMessageConverter

canConvertTo

protected boolean canConvertTo(java.lang.Object payload,
                               MessageHeaders headers)

Overrides:

canConvertTo in class AbstractMessageConverter

supports

protected boolean supports(java.lang.Class<?> clazz)

Description copied from class: AbstractMessageConverter

Whether the given class is supported by this converter.

Specified by:

supports in class AbstractMessageConverter

Parameters:

clazz - the class to test for support

Returns:

true if supported; false otherwise

convertFromInternal

protected java.lang.Object convertFromInternal(Message<?> message,
                                               java.lang.Class<?> targetClass,
                                               java.lang.Object conversionHint)

Description copied from class: AbstractMessageConverter

Convert the message payload from serialized form to an Object.

Overrides:

convertFromInternal in class AbstractMessageConverter

Parameters:

message - the input message

targetClass - the target class for the conversion

conversionHint - an extra object passed to the MessageConverter, e.g. the associated MethodParameter (may be null}

Returns:

the result of the conversion, or null if the converter cannot perform the conversion

getSource

private javax.xml.transform.Source getSource(java.lang.Object payload)

convertToInternal

protected java.lang.Object convertToInternal(java.lang.Object payload,
                                             MessageHeaders headers,
                                             java.lang.Object conversionHint)

Description copied from class: AbstractMessageConverter

Convert the payload object to serialized form.

Overrides:

convertToInternal in class AbstractMessageConverter

Parameters:

payload - the Object to convert

headers - optional headers for the message (may be null)

conversionHint - an extra object passed to the MessageConverter, e.g. the associated MethodParameter (may be null}

Returns:

the resulting payload for the message, or null if the converter cannot perform the conversion