org.apache.camel.component.jms
Class JmsBinding

java.lang.Object
  org.apache.camel.component.jms.JmsBinding

public class JmsBinding
extends Object

A Strategy used to convert between a Camel Exchange and JmsMessage to and from a JMS Message

Version:

$Revision: 20285 $

Constructor Summary

JmsBinding()

JmsBinding(JmsEndpoint endpoint)

Method Summary

void	appendJmsProperties(Message jmsMessage, Exchange exchange) Appends the JMS headers from the Camel JmsMessage
void	appendJmsProperties(Message jmsMessage, Exchange exchange, Message in) Appends the JMS headers from the Camel JmsMessage
void	appendJmsProperty(Message jmsMessage, Exchange exchange, Message in, String headerName, Object headerValue)
protected byte[]	createByteArrayFromBytesMessage(BytesMessage message)
protected Message	createJmsMessage(Exception cause, Session session)
protected Message	createJmsMessage(Exchange exchange, Object body, Map<String,Object> headers, Session session, CamelContext context)
Map<String,Object>	createMapFromMapMessage(MapMessage message) Extracts a Map from a MapMessage
Object	extractBodyFromJms(Exchange exchange, Message message) Extracts the body from the JMS message
Map<String,Object>	extractHeadersFromJms(Message jmsMessage, Exchange exchange)
Object	getObjectProperty(Message jmsMessage, String name)
protected Object	getValidJMSHeaderValue(String headerName, Object headerValue) Strategy to test if the given header is valid according to the JMS spec to be set as a property on the JMS message.
protected boolean	isStandardJMSHeader(String headerName) Is the given header a standard JMS header
Message	makeJmsMessage(Exchange exchange, Message camelMessage, Session session, Exception cause) Creates a JMS message from the Camel exchange and message
Message	makeJmsMessage(Exchange exchange, Session session) Creates a JMS message from the Camel exchange and message
protected void	populateMapMessage(MapMessage message, Map<?,?> map, CamelContext context) Populates a MapMessage from a Map instance.
protected boolean	shouldOutputHeader(Message camelMessage, String headerName, Object headerValue, Exchange exchange) Strategy to allow filtering of headers which are put on the JMS message Note: Currently only supports sending java identifiers as keys

Methods inherited from class java.lang.Object

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

Constructor Detail

JmsBinding

public JmsBinding()

JmsBinding

public JmsBinding(JmsEndpoint endpoint)

Method Detail

extractBodyFromJms

public Object extractBodyFromJms(Exchange exchange,
                                 Message message)

Extracts the body from the JMS message

Parameters:

exchange - the exchange

message - the message to extract its body

Returns:

the body, can be null

extractHeadersFromJms

public Map<String,Object> extractHeadersFromJms(Message jmsMessage,
                                                Exchange exchange)

getObjectProperty

public Object getObjectProperty(Message jmsMessage,
                                String name)
                         throws JMSException

Throws:

JMSException

createByteArrayFromBytesMessage

protected byte[] createByteArrayFromBytesMessage(BytesMessage message)
                                          throws JMSException

Throws:

JMSException

makeJmsMessage

public Message makeJmsMessage(Exchange exchange,
                              Session session)
                       throws JMSException

Creates a JMS message from the Camel exchange and message

Parameters:

exchange - the current exchange

session - the JMS session used to create the message

Returns:

a newly created JMS Message instance containing the

Throws:

JMSException - if the message could not be created

makeJmsMessage

public Message makeJmsMessage(Exchange exchange,
                              Message camelMessage,
                              Session session,
                              Exception cause)
                       throws JMSException

Creates a JMS message from the Camel exchange and message

Parameters:

exchange - the current exchange

camelMessage - the body to make a javax.jms.Message as

session - the JMS session used to create the message

cause - optional exception occurred that should be sent as reply instead of a regular body

Returns:

a newly created JMS Message instance containing the

Throws:

JMSException - if the message could not be created

appendJmsProperties

public void appendJmsProperties(Message jmsMessage,
                                Exchange exchange)
                         throws JMSException

Appends the JMS headers from the Camel JmsMessage

Throws:

JMSException

appendJmsProperties

public void appendJmsProperties(Message jmsMessage,
                                Exchange exchange,
                                Message in)
                         throws JMSException

Appends the JMS headers from the Camel JmsMessage

Throws:

JMSException

appendJmsProperty

public void appendJmsProperty(Message jmsMessage,
                              Exchange exchange,
                              Message in,
                              String headerName,
                              Object headerValue)
                       throws JMSException

Throws:

JMSException

isStandardJMSHeader

protected boolean isStandardJMSHeader(String headerName)

Is the given header a standard JMS header

Parameters:

headerName - the header name

Returns:

true if its a standard JMS header

getValidJMSHeaderValue

protected Object getValidJMSHeaderValue(String headerName,
                                        Object headerValue)

Strategy to test if the given header is valid according to the JMS spec to be set as a property on the JMS message.

This default implementation will allow:

• any primitives and their counter Objects (Integer, Double etc.)
• String and any other literals, Character, CharSequence
• Boolean
• Number
• java.util.Date

Parameters:

headerName - the header name

headerValue - the header value

Returns:

the value to use, null to ignore this header

createJmsMessage

protected Message createJmsMessage(Exception cause,
                                   Session session)
                            throws JMSException

Throws:

JMSException

createJmsMessage

protected Message createJmsMessage(Exchange exchange,
                                   Object body,
                                   Map<String,Object> headers,
                                   Session session,
                                   CamelContext context)
                            throws JMSException

Throws:

JMSException

populateMapMessage

protected void populateMapMessage(MapMessage message,
                                  Map<?,?> map,
                                  CamelContext context)
                           throws JMSException

Populates a MapMessage from a Map instance.

Throws:

JMSException

createMapFromMapMessage

public Map<String,Object> createMapFromMapMessage(MapMessage message)
                                           throws JMSException

Extracts a Map from a MapMessage

Throws:

JMSException

shouldOutputHeader

protected boolean shouldOutputHeader(Message camelMessage,
                                     String headerName,
                                     Object headerValue,
                                     Exchange exchange)

Strategy to allow filtering of headers which are put on the JMS message

Note: Currently only supports sending java identifiers as keys