Spring 3.0 RC1发布,一些新特性很吸引人,看了一下Reference,顺便翻译了SpEL这节,水平有限,还望指教。
Spring 3.0 Reference:http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/index.html
Part III 核心技术
6.Spring 表达式语言(SpEL)
6.1 简介
Spring表达式语言(简称SpEL)是一个支持运行时查询和操作对象图的强大的表达式语言。其语法类似于统一EL,但提供了额外特性,显式方法调用和基本字符串模板函数。
同很多可用的Java 表达式语言相比,例如OGNL,MVEL和JBoss EL,SpEL的诞生是为了给Spring社区提供一个可以给Spring目录中所有产品提供单一良好支持的表达式语言。其语言特性由Spring目录中的项目需求驱动,包括基于eclipse的SpringSource套件中的代码补全工具需求。那就是说,SpEL是一个基于技术中立的API允许需要时与其他表达式语言集成。
SpEL作为Spring目录中表达式求值的基础,它并不是直接依赖于Spring而是可以被独立使用。为了能够自包含,本章中的许多示例把SpEL作为一个独立的表达式语言来使用。这就需要创建一些如解析器的引导基础组件类。大多数Spring用户只需要为求值编写表达式字符串而不需要关心这些基础组件。一个典型的使用例子是集成SpEL和创建基于XML或注解的bean定义,见6.4 bean定义的表达式支持一节。
本章涵盖了表达式语言的特性,API和语法。在很多地方,一个Inventor类和Invertor的Society类作为表达式求值的目标对象。这些类声明和操作它们使用的数据列在本章的末尾。
6.2 特性概览
表达式语言支持下列功能:
字符表达式
布尔和关系操作符
正则表达式
类表达式
访问properties,arrays,lists,maps
方法调用
关系操作符
赋值
调用构造器
三元操作符
变量
用户自定义函数
集合投影
集合选择
模板表达式
6.3 使用Spring Expression接口进行表达式求值
这一节介绍SpEL接口和其表达式语言的简单实用。完整的语言参考参见语言参考一节。
下面的代码使用SpEL API求字符表达式‘Hello World’的值。
message变量的值是最简单的‘Hello World’。
最常使用的SpEL类和接口在包org.springframework.expression和其子包以及spel.support中。
ExpressionParser接口用来解析一个表达式字符串。在这个例子中,表达式串是一个被单引号包括标注的字符串。Expression接口用来求前面定义的表达式串的值。当调用parser.parseExpression和exp.getValue时分别可能抛出ParseException和EvaluationException异常。
SpEL支持一系列特性,例如方法调用,访问属性和调用构造器。
下面调用字符串文字的concat方法作为方法调用的一个例子。
message的值为‘Hello World!’。
下面的String属性Bytes可以被调用作为调用JavaBean属性的一个例子。
SpEL使用标准的‘.’符号支持属性嵌套和属性设值,例如:prop1.prop2.prop3.
公共属性也可以被访问。
使用字符串构造器而不是字符串文字。
记住使用泛型方法public < <script src="http://hi.images.csdn.net/js/blog/tiny_mce/themes/advanced/langs/zh.js" type="text/javascript"></script><script src="http://hi.images.csdn.net/js/blog/tiny_mce/plugins/syntaxhl/langs/zh.js" type="text/javascript"></script> T> T getValue(Class<T> desiredResultType)。使用这个方法省去了需要时对表达式的值显式类型转换。如果该值不能被转换为T或者使用已注册的类型转换器转换则会抛出EvaluationException.
SpEL中更常见的用途是提供一个针对特定对象实例求值的表达式字符串。在下面的例子中,我们检索一个Inventor类的实例的name属性。
在最后一行,该字符串变量'name'将被设置为“Nikola Tesla”。类StandardEvaluationContext是您可以指定对象的将被求值的“name”属性。你可以重复使用相同的表达式,在求值上下文内设定一个新的根对象。表达式是使用反射求值。
Note:在单独使用SpEL时,你需要创建一个解析器并提供一个求值上下文。但是更为广泛的应用仅仅提供一个SpEL表达式字符串作为配置文件的一部分。例如为Spring bean或Spring Web Flow定义。这种情况下,解析器,求值上下文,根对象和其他预定义变量都会被隐含创建。
作为最后一个例子,使用前面例子中的Inventor对象中使用布尔操作符。
EvaluationContext接口
EvaluationContext接口用来求一个解析属性,方法,域的表达式值以及帮助类型转换。其即插即用实现StandardEvaluationContext使用反射机制来操作对象。为获得好的性能缓存java.lang.reflect的Method,Field,和Constructor实例。
该StandardEvaluationContext是你用来通过方法setRootObject指定求值根对象或传递根对象到构造器的接口。你还可以指定将在表达式中使用的方法setVariable和registerFunction的变量和函数。变量和函数使用的描述见语言参考部分的变量和函数。StandardEvaluationContext还是你可以注册自定义ConstructorResolvers,MethodResolvers,和PropertyAccessors来扩展SpEL如何计算表达式。请参阅这些类的JavaDoc了解详情
类型转换
默认情况下,SpEL使用的转换服务可在Spring的核心(org.springframework.core.convert.ConversionService)找到。这种转换的服务由很多内建的为通常转换的转换器构成,但也是可扩展的,这样可以添加自定义类型之间的转换。此外它的主要支持是它是泛型敏感的。这意味着,当处理表达式中的泛型时,SpEL将尝试转换来维持对所遇到的任何对象类型的正确性。
这是什么在实践中意味着什么呢?比如赋值,用setValue()来设置List类型,实际是List<Boolean>。SpEL将会认识到,在List的元素需要在使用之前转换为布尔类型。一个简单的例子:
6.4 bean定义的表达式支持
SpEL可以和Bean定义中基于XML或注解的元数据配置一起使用。两种情况下的语法都是如#{ <expression string> }的形式。
基于XML的配置
下面一个属性或者构造参数值可以使用表达式设值。
变量‘systemProperties’是预先定义的,所以你可以在表达式中如下使用,记住在这个上下文中你不必在预定义的变量前加#号。
你可以通过名字引用其他bean的属性,如下:
基于注解的配置
@Value注解可以在域,方法和方法/构造器参数中使用来指定一个默认值。
这是一个设置域变量默认值的例子。
和下面在属性的setter方法中使用等价。
自动装配的方法和构造器同样可以使用@Value注解。
6.5 语言参考
文字表达式
支持的文字表达的类型是字符串,日期,数值(整型,实型,和十六进制),布尔和空。字符串是由单引号分隔。使用反斜杠字符转移把一个单引号字符本身放在字符串中。以下清单显示文字的简单用法。通常它们不会使用这样单独使用,而是作为一个更复杂的表达式的一部分,例如,使用一个文字表达式作为逻辑比较运算符的一边。
数字支持负号,指数符号的使用和小数点。默认情况下实数解析使用Double.parseDouble()。
Properties,Arrays,Lists,Maps,Indexers
用属性引用导航很简单,只需使用一个句点来表示一个嵌套的属性值。Inventor类实例,pupin和tesla,使用示例中使用的类一节中列出的数据填充。要“向下”导航并获得tesla的出生年份和pupin的出生的城市则使用下列表达式。
属性名的首字母区分大小写,数组和列表的内容使用方括号符号得到。
Map的内容通过指定括号内的文字键值得到。在这种情况下,因为Officers Map的键是字符串,我们可以指定字符串。
方法
方法调用采用典型的Java编程语法。您还可以调用文字的方法。可变参数也支持。
操作符
关系操作符
使用标准的操作符号支持关系操作符:等于,不等于,小于,小于等于,大于,大于等于。
除此之外,SpEL支持‘instanceof’和基于正则表达式的‘match’操作。
//evaluatestofalse
boolean falseValue=parser.parseExpression("'xyz'instanceofT(int)").getValue(Boolean.class);
//evaluatestotrue
boolean trueValue=
parser.parseExpression("'5.00'matches'^-?//d+(//.//d{2})?$'").getValue(Boolean.class);
//evaluatestofalse
boolean falseValue=
parser.parseExpression("'5.0067'matches'^-?//d+(//.//d{2})?$'").getValue(Boolean.class);
逻辑操作符
支持的逻辑操作符包括and,or和not,使用方法如下。
算术操作符
加法运算符可以用于数字,字符串和日期。减法可用于数字和日期。乘法和除法仅可以用于。其他支持的数学运算包括取模(%)和指数幂(^)。使用标准的运算符优先级。这些运算符示例如下。
赋值
属性设置是通过使用赋值运算符。这通常是在调用setValue中执行但也可以在调用getValue内。
类型
特殊的‘T'操作符可以用来指定一个java.lang.Class的实例('类型')。静态方法调用也使用此操作符。该StandardEvaluationContext使用TypeLocator寻找类型,StandardTypeLocator(可更换)建立在java.lang包的基础上。这意味着T()引用在java.lang中的类型不须被完全限定,但所有其他类型的引用必须。
构造器
可以使用new运算符调用构造器。完全限定类名应被用于所有类型除了原始类型和字符串(如整型,浮点,等等,可以使用)。
变量
变量可以在表达式中使用语法#’变量名’引用。变量设置使用StandardEvaluationContext的方法setVariable。
#this变量
#this变量通常被定义和引用当前求值对象(该对象的不合格引用将解决)。
函数
你可以通过注册可在表达式字符串内调用的用户自定义函数来扩展SpEL。使用StandardEvaluationContext中的下列方法注册函数。
所引用的Java方法实现该函数,例如如下这个有用的反转字符串方法。
随后这个方法就可以在求值上下文注册并在表达式字符串中使用了。
三元操作符(If-Then-Else)
可以在表达式内使用if-then-else条件逻辑三元操作符。下面是个小例子:
这个情况下,布尔false结果返回‘falseExp‘字符串,一个真实的例子如下:
下一节将看到三元操作符更短的语法Elvis操作符。
Elvis操作符
ElvIs操作符是Groovy语言中使用的三元操作符的缩短。在三元运算符中通常要重复变量两次,例如:
可以使用Elvis操作符替代,命名为和Elvis相似的风格。
这里是一个复杂的例子。
安全导航操作符
安全导航操作符来源于Groovy语言,它避免了空指针异常。通常当你有一个对象的引用,在访问其方法或属性时你需要验证该引用是否为空。为了避免这种情况,安全导航操作符,只会返回null而不是抛出异常。
集合选择
选择是一个强大的表达式语言特性,它允许你通过从入口选择将原集合转换为其他集合。
选择使用语法?[selectExpression]。这将过滤原集合并返回包含原集合子集的新的集合。例如,选择将允许我们很容易得到Serbian 发明者列表。
通常是对List和Map的选择。在前一种情况下的选择标准是针对每个人的列表求值而对Map选择标准是针对每一个映射项(Java类型Map.Entry对象)求值,而评价。Map入口有其如属性的可访问的键和值供选择使用。
这个表达式将返回一个新的Map,其元素由原始Map中项的值小于27的元素组成。
除了返回所有被选择的元素,也可以检索第一个和最后一个值。用^[…]获得第一个匹配入口,用$[…]获得最后一个匹配入口。
集合投影
投影允许集合驱动子表达式的求值,其结果是一个新的集合。对于投影语法![projectionExpression]。最容易理解的例子,假设我们有一个发明者列表,但要在城市名单中寻找他们在那里出生。我们要对发明者列表中每项有效地求出‘placeOfBirth.city'。使用投影:
Map也可以用于驱动投影,这时投影表达式对Map中的每个项目求值(作为一个Java Map.Entry表示)。跨越Map投影的结果是对每个Map入口投影表达式求值后组成的列表。
表达式模板
表达式模板允许与一个或多个求值块复合文字文本。每个求值块有可自定义的前缀和后缀的字符定界,一个普遍的选择是使用的分隔符$()定界。例如,
该字符串的求值是通过连接文字文本的‘random number is’和$()定界符内求值表达式的结果,在这里是调用的random()方法的结果。parseExpression()方法的第二个参数是ParserContext的类型。该ParserContext接口通常影响表达式如何被解析以支持模板功能。在TemplatedParserContext的定义如下所示。
6.6 示例中使用的类
Inventor.java
PlaceOfBirth.java
Society.java