From 3ed26d170f95c1c82e9aac7e4e9fc3aefa045e03 Mon Sep 17 00:00:00 2001
From: Iwein Fuld <iwein@fuld.net>
Date: Fri, 11 Jun 2010 09:38:14 +0000
Subject: [PATCH] INT-1164: added paragraph on expression attribute.

---
 src/docbkx/filter.xml | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/src/docbkx/filter.xml b/src/docbkx/filter.xml
index 5546f9fe80..7da324e52e 100644
--- a/src/docbkx/filter.xml
+++ b/src/docbkx/filter.xml
@@ -28,6 +28,7 @@
       The <classname>MessageFilter</classname> constructor accepts a selector instance:
       <programlisting language="java"><![CDATA[ MessageFilter filter = new MessageFilter(someSelector);]]></programlisting>
     </para>
+      In combination with the namespace and SpEL very powerful filters can be configured with very little java code.
   </section>
 
   <section id="filter-namespace">
@@ -81,6 +82,21 @@
         is not allowed, as it creates an ambiguous condition, and it will therefore result in an Exception being thrown.
       </para>
     </note>
+    <para>
+      With the introduction of SpEL Spring Integration has added the <code>expression</code> attribute to the filter
+      element. It can be used to avoid Java entirely for simple filters.
+      <programlisting language="xml">
+        <![CDATA[  <filter input-channel="input" expression="payload.equals(nonsense)"/>]]>
+      </programlisting>
+      The string passed as the expression attribute will be evaluated as a SpEL expression in the context of the message.
+      If it is needed to include the result of an expression in the scope of the application context you can use the
+      #{} notation as defined in the SpEL reference documentation
+      <ulink url="http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/expressions.html#expressions-beandef">
+        SpEL reference documentation
+      </ulink>.
+      <programlisting language="xml">
+        <![CDATA[  <filter input-channel="input" expression="payload.matches(#{filterPatterns.nonsensePattern})"/>]]>
+      </programlisting>
+    </para>
   </section>
-
 </chapter>
\ No newline at end of file