Spring 3.0参考手册之SpEL

来源:互联网 发布:阿里巴巴人工智能 编辑:程序博客网 时间:2024/04/29 19:36

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 简介
  • 6.2 特性概览
  • 6.3 使用Spring Expression接口进行表达式求值
  • 6.4 bean定义的表达式支持
  • 6.5 语言参考
  • 6.6 示例类

 6.1 简介

    Spring表达式语言(简称SpEL)是一个支持运行时查询和操作对象图的强大的表达式语言。其语法类似于统一EL,但提供了额外特性,显式方法调用和基本字符串模板函数。

    同很多可用的Java 表达式语言相比,例如OGNLMVELJBoss ELSpEL的诞生是为了给Spring社区提供一个可以给Spring目录中所有产品提供单一良好支持的表达式语言。其语言特性由Spring目录中的项目需求驱动,包括基于eclipseSpringSource套件中的代码补全工具需求。那就是说,SpEL是一个基于技术中立的API允许需要时与其他表达式语言集成。

    SpEL作为Spring目录中表达式求值的基础,它并不是直接依赖于Spring而是可以被独立使用。为了能够自包含,本章中的许多示例把SpEL作为一个独立的表达式语言来使用。这就需要创建一些如解析器的引导基础组件类。大多数Spring用户只需要为求值编写表达式字符串而不需要关心这些基础组件。一个典型的使用例子是集成SpEL和创建基于XML或注解的bean定义,见6.4 bean定义的表达式支持一节。

    本章涵盖了表达式语言的特性,API和语法。在很多地方,一个Inventor类和InvertorSociety类作为表达式求值的目标对象。这些类声明和操作它们使用的数据列在本章的末尾。

6.2 特性概览

    表达式语言支持下列功能:

ž   字符表达式

ž   布尔和关系操作符

ž   正则表达式

ž   类表达式

ž   访问propertiesarrayslistsmaps

ž   方法调用

ž   关系操作符

ž   赋值

ž   调用构造器

ž   三元操作符

ž   变量

ž   用户自定义函数

ž   集合投影

ž   集合选择

ž   模板表达式

6.3 使用SpringExpression接口进行表达式求值

    这一节介绍SpEL接口和其表达式语言的简单实用。完整的语言参考参见语言参考一节。

    下面的代码使用SpEL API求字符表达式‘Hello World’的值。

    

    message变量的值是最简单的‘Hello World’。

    最常使用的SpEL类和接口在包org.springframework.expression和其子包以及spel.support中。

    ExpressionParser接口用来解析一个表达式字符串。在这个例子中,表达式串是一个被单引号包括标注的字符串。Expression接口用来求前面定义的表达式串的值。当调用parser.parseExpressionexp.getValue时分别可能抛出ParseExceptionEvaluationException异常。

    SpEL支持一系列特性,例如方法调用,访问属性和调用构造器。

    下面调用字符串文字的concat方法作为方法调用的一个例子。

     

message的值为‘Hello World!’。

下面的String属性Bytes可以被调用作为调用JavaBean属性的一个例子。

 

SpEL使用标准的‘.’符号支持属性嵌套和属性设值,例如:prop1.prop2.prop3.

公共属性也可以被访问。

 

使用字符串构造器而不是字符串文字。

 

记住使用泛型方法public <T>T getValue(Class<T> desiredResultType)。使用这个方法省去了需要时对表达式的值显式类型转换。如果该值不能被转换为T或者使用已注册的类型转换器转换则会抛出EvaluationException.

SpEL中更常见的用途是提供一个针对特定对象实例求值的表达式字符串。在下面的例子中,我们检索一个Inventor类的实例的name属性。

 

在最后一行,该字符串变量'name'将被设置为“Nikola Tesla”。类StandardEvaluationContext是您可以指定对象的将被求值的“name”属性。你可以重复使用相同的表达式,在求值上下文内设定一个新的根对象。表达式是使用反射求值。

Note在单独使用SpEL时,你需要创建一个解析器并提供一个求值上下文。但是更为广泛的应用仅仅提供一个SpEL表达式字符串作为配置文件的一部分。例如为Spring beanSpring Web Flow定义。这种情况下,解析器,求值上下文,根对象和其他预定义变量都会被隐含创建。

作为最后一个例子,使用前面例子中的Inventor对象中使用布尔操作符。

 

EvaluationContext接口

    EvaluationContext接口用来求一个解析属性,方法,域的表达式值以及帮助类型转换。其即插即用实现StandardEvaluationContext使用反射机制来操作对象。为获得好的性能缓存java.lang.reflectMethod,Field,Constructor实例。

    StandardEvaluationContext是你用来通过方法setRootObject指定求值根对象或传递根对象到构造器的接口。你还可以指定将在表达式中使用的方法setVariableregisterFunction的变量和函数。变量和函数使用的描述见语言参考部分的变量函数StandardEvaluationContext还是你可以注册自定义ConstructorResolversMethodResolvers,和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()。

PropertiesArraysListsMapsIndexers

    用属性引用导航很简单,只需使用一个句点来表示一个嵌套的属性值。Inventor类实例,pupintesla,使用示例中使用的类一节中列出的数据填充。要向下导航并获得tesla的出生年份和pupin的出生的城市则使用下列表达式。

 

    属性名的首字母区分大小写,数组和列表的内容使用方括号符号得到。

 

Map的内容通过指定括号内的文字键值得到。在这种情况下,因为Officers Map的键是字符串,我们可以指定字符串。

 

方法

方法调用采用典型的Java编程语法。您还可以调用文字的方法。可变参数也支持。

 

操作符

    关系操作符

    使用标准的操作符号支持关系操作符:等于,不等于,小于,小于等于,大于,大于等于。

 

    除此之外,SpEL支持‘instanceof’和基于正则表达式的‘match’操作。

//evaluatestofalse

booleanfalseValue=parser.parseExpression("'xyz'instanceofT(int)").getValue(Boolean.class);

//evaluatestotrue

booleantrueValue=

parser.parseExpression("'5.00'matches'^-?//d+(//.//d{2})?$'").getValue(Boolean.class);

//evaluatestofalse

booleanfalseValue=

parser.parseExpression("'5.0067'matches'^-?//d+(//.//d{2})?$'").getValue(Boolean.class);

    逻辑操作符

    支持的逻辑操作符包括andornot,使用方法如下。

 

算术操作符

加法运算符可以用于数字,字符串和日期。减法可用于数字和日期。乘法和除法仅可以用于。其他支持的数学运算包括取模(%)和指数幂(^)。使用标准的运算符优先级。这些运算符示例如下。

 

赋值

    属性设置是通过使用赋值运算符。这通常是在调用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 发明者列表。

 

    通常是对ListMap的选择。在前一种情况下的选择标准是针对每个人的列表求值而对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