From f20ded5f637f4032c1a31c913a934904413d606d Mon Sep 17 00:00:00 2001
From: Oliver Gierke <ogierke@vmware.com>
Date: Tue, 28 Dec 2010 09:42:58 +0000
Subject: [PATCH] SPR-7674 - Documented value defaulting in Spring EL

Added short note of how to use the Elvis operator for defaulting values in the Spring expression language sections.
---
 spring-framework-reference/src/expressions.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/spring-framework-reference/src/expressions.xml b/spring-framework-reference/src/expressions.xml
index 20ff8f1d58..e31e9103f5 100644
--- a/spring-framework-reference/src/expressions.xml
+++ b/spring-framework-reference/src/expressions.xml
@@ -1011,6 +1011,15 @@ tesla.setPlaceOfBirth(null);
 city = parser.parseExpression("PlaceOfBirth?.City").getValue(context, String.class);
 
 System.out.println(city); // null - does not throw NullPointerException!!!</programlisting>
+      <note>
+        <para>The Elvis operator can be used to apply default values in
+        expressions, e.g. in an <interfacename>@Value</interfacename> expression:</para>
+
+        <programlisting>@Value("#{systemProperties['pop3.port'] ?: 25}")</programlisting>
+
+        <para>This will inject a system property <code>pop3.port</code> if it
+        is defined or 25 if not.</para>
+      </note>
     </section>
 
     <section>