INT-539

org.springframework.integration.jms/src/main/java/org/springframework/integration/jms/DefaultJmsHeaderMapper.java

@@ -34,7 +34,20 @@ import org.springframework.integration.core.MessageHeaders;
 import org.springframework.util.StringUtils;
 
 /**
- * Default implementation of {@link JmsHeaderMapper}. 
+ * Default implementation of {@link JmsHeaderMapper}.
+ * <p/>
+ * This implementation copies JMS API headers (e.g. JMSReplyTo) to and from
+ * Spring Integration Messages. Any user-defined properties will also be copied
+ * from a JMS Message to a Spring Integration Message, and any other headers
+ * on a Spring Integration Message (beyond the JMS API headers) will likewise
+ * be copied to a JMS Message. Those other headers will be copied to the
+ * general properties of a JMS Message whereas the JMS API headers are passed
+ * to the appropriate setter methods (e.g. setJMSReplyTo).
+ * <p/>
+ * Constants for the JMS API headers are defined in {@link JmsHeaders}.
+ * Note that the JMSMessageID and JMSRedelivered flag are only copied
+ * <em>from</em> a JMS Message. Those values will <em>not</em> be passed
+ * along from a Spring Integration Message to an outbound JMS Message.
  * 
  * @author Mark Fisher
  */

org.springframework.integration.jms/src/main/java/org/springframework/integration/jms/JmsHeaders.java

@@ -27,7 +27,9 @@ import org.springframework.integration.core.MessageHeaders;
 public abstract class JmsHeaders {
 
 	/**
-	 * Prefix for any message header that should be passed for usage by the JMS transport.
+	 * Prefix used for JMS API related headers in order to distinguish from
+	 * user-defined headers and other internal headers (e.g. correlationId).
+	 * @see DefaultJmsHeaderMapper
 	 */
 	public static final String PREFIX = MessageHeaders.PREFIX + "jms_";