public MarshallingMessageConverter() 
{

}

Constructs a new MarshallingMessageConverter with no Marshaller set. The marshaller must be set after construction by invoking #setMarshaller(Marshaller) .

 public MarshallingMessageConverter(Marshaller marshaller) 
{
        Assert.notNull(marshaller, "marshaller must not be null");
        if (!(marshaller instanceof Unmarshaller)) {
            throw new IllegalArgumentException("Marshaller [" + marshaller + "] does not implement the Unmarshaller " +
                    "interface. Please set an Unmarshaller explicitely by using the " +
                    "AbstractMarshallingPayloadEndpoint(Marshaller, Unmarshaller) constructor.");
        }
        else {
            this.marshaller = marshaller;
            this.unmarshaller = (Unmarshaller) marshaller;
        }
}

Constructs a new MarshallingMessageConverter with the given Marshaller set. If the given Marshaller also implements the Unmarshaller interface, it is used for both marshalling and unmarshalling. Otherwise, an exception is thrown.

Note that all Marshaller implementations in Spring-WS also implement the Unmarshaller interface, so that you can safely use this constructor.

Parameters:

marshaller - object used as marshaller and unmarshaller

Throws:

IllegalArgumentException - when marshaller does not implement the Unmarshaller interface

 public MarshallingMessageConverter(Marshaller marshaller,
    Unmarshaller unmarshaller) 
{
        Assert.notNull(marshaller, "marshaller must not be null");
        Assert.notNull(unmarshaller, "unmarshaller must not be null");
        this.marshaller = marshaller;
        this.unmarshaller = unmarshaller;
}

Creates a new MarshallingMessageConverter with the given marshaller and unmarshaller.

Parameters:

marshaller - the marshaller to use

unmarshaller - the unmarshaller to use

 public  void afterPropertiesSet() throws Exception 
{
        Assert.notNull(marshaller, "Property 'marshaller' is required");
        Assert.notNull(unmarshaller, "Property 'unmarshaller' is required");
}

 public Object fromMessage(Message message) throws JMSException, MessageConversionException 
{
        try {
            if (message instanceof TextMessage) {
                TextMessage textMessage = (TextMessage) message;
                return unmarshalFromTextMessage(textMessage, unmarshaller);
            }
            else if (message instanceof BytesMessage) {
                BytesMessage bytesMessage = (BytesMessage) message;
                return unmarshalFromBytesMessage(bytesMessage, unmarshaller);
            }
            else {
                return unmarshalFromMessage(message, unmarshaller);
            }
        }
        catch (UnmarshallingFailureException ex) {
            throw new MessageConversionException("Could not unmarshal message [" + message + "]", ex);
        }
        catch (IOException ex) {
            throw new MessageConversionException("Could not unmarshal message [" + message + "]", ex);
        }
}

Unmarshals the given Message into an object.

 protected BytesMessage marshalToBytesMessage(Object object,
    Session session,
    Marshaller marshaller) throws JMSException, IOException 
{
        ByteArrayOutputStream bos = new ByteArrayOutputStream();
        StreamResult streamResult = new StreamResult(bos);
        marshaller.marshal(object, streamResult);
        BytesMessage message = session.createBytesMessage();
        message.writeBytes(bos.toByteArray());
        return message;
}

Marshals the given object to a BytesMessage .

 protected Message marshalToMessage(Object object,
    Session session,
    Marshaller marshaller) throws JMSException, IOException 
{
        throw new MessageConversionException(
                "Unknown 'marshalTo' value [" + marshalTo + "]. Cannot convert object to Message");
}

Template method that allows for custom message marshalling. Invoked when #setMarshalTo(int) is not #MARSHAL_TO_TEXT_MESSAGE or #MARSHAL_TO_BYTES_MESSAGE .

Default implemenetation throws a MessageConversionException .

 protected TextMessage marshalToTextMessage(Object object,
    Session session,
    Marshaller marshaller) throws JMSException, IOException 
{
        StringResult result = new StringResult();
        marshaller.marshal(object, result);
        return session.createTextMessage(result.toString());
}

Marshals the given object to a TextMessage .

 public  void setMarshalTo(int marshalTo) 
{
        this.marshalTo = marshalTo;
}

Indicates whether #toMessage(Object,Session) should marshal to a BytesMessage or a TextMessage . The default is #MARSHAL_TO_BYTES_MESSAGE , i.e. this converter marshals to a BytesMessage .

 public  void setMarshaller(Marshaller marshaller) 
{
        this.marshaller = marshaller;
}

Sets the Marshaller to be used by this message converter.

 public  void setUnmarshaller(Unmarshaller unmarshaller) 
{
        this.unmarshaller = unmarshaller;
}

Sets the Unmarshaller to be used by this message converter.

 public Message toMessage(Object object,
    Session session) throws JMSException, MessageConversionException 
{
        try {
            switch (marshalTo) {
                case MARSHAL_TO_TEXT_MESSAGE:
                    return marshalToTextMessage(object, session, marshaller);
                case MARSHAL_TO_BYTES_MESSAGE:
                    return marshalToBytesMessage(object, session, marshaller);
                default:
                    return marshalToMessage(object, session, marshaller);
            }
        }
        catch (MarshallingFailureException ex) {
            throw new MessageConversionException("Could not marshal [" + object + "]", ex);
        }
        catch (IOException ex) {
            throw new MessageConversionException("Could not marshal  [" + object + "]", ex);
        }
}

Marshals the given object to a TextMessage or javax.jms.BytesMessage . The desired message type can be defined by setting the marshalTo property.

 protected Object unmarshalFromBytesMessage(BytesMessage message,
    Unmarshaller unmarshaller) throws JMSException, IOException 
{
        byte[] bytes = new byte[(int) message.getBodyLength()];
        message.readBytes(bytes);
        ByteArrayInputStream bis = new ByteArrayInputStream(bytes);
        StreamSource source = new StreamSource(bis);
        return unmarshaller.unmarshal(source);
}

Unmarshals the given BytesMessage into an object.

 protected Object unmarshalFromMessage(Message message,
    Unmarshaller unmarshaller) throws JMSException, IOException 
{
        throw new MessageConversionException(
                "MarshallingMessageConverter only supports TextMessages and BytesMessages");
}

Template method that allows for custom message unmarshalling. Invoked when #fromMessage(Message) is invoked with a message that is not a TextMessage or BytesMessage .

Default implemenetation throws a MessageConversionException .

 protected Object unmarshalFromTextMessage(TextMessage message,
    Unmarshaller unmarshaller) throws JMSException, IOException 
{
        StringSource source = new StringSource(message.getText());
        return unmarshaller.unmarshal(source);
}

Unmarshals the given TextMessage into an object.