From 109de2b16a93594ee986e4a2c7930a2940c76101 Mon Sep 17 00:00:00 2001 From: Gunnar Hillert Date: Tue, 28 Aug 2012 12:58:15 -0400 Subject: [PATCH] INT-2448 - Document JMS message "selector" attribute For reference see: https://jira.springsource.org/browse/INT-2448 INT-2448 - Code review changes --- src/reference/docbook/jms.xml | 36 ++++++++++++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) diff --git a/src/reference/docbook/jms.xml b/src/reference/docbook/jms.xml index c2e196520d..0e9b2d0c05 100644 --- a/src/reference/docbook/jms.xml +++ b/src/reference/docbook/jms.xml @@ -324,7 +324,41 @@ connection-factory="customConnectionFactory"/>]]> - +
+ Using JMS Message Selectors + + With JMS message selectors you can filter JMS Messages + based on JMS headers as well as JMS properties. For example, + if you want to listen to messages whose custom JMS header + property fooHeaderProperty equals + bar, you can specify the following expression: + + + + Message selector expressions are a subset of the SQL-92 + conditional expression syntax, and are defined as part of the + Java Message Service + specification (Version 1.1 April 12, 2002). Specifically, please see + chapter "3.8 Message Selection". It contains a detailed explanation of the + expressions syntax. + + + You can specify the JMS message selector attribute + using XML Namespace configuration for the following Spring Integration + JMS components: + + + JMS Channel + JMS Publish Subscribe Channel + JMS Inbound Channel Adapter + JMS Inbound Gateway + JMS Message-driven Channel Adapter + + + It is important to remember that you cannot reference message body values + using JMS Message selectors. + +
JMS Samples