Struts2的OGNL表达式语言

14年前

1.OGNL表达式语言
OGNL
Object Graphic Navigation Language(对象图导航语言)的缩写,它是一个开源项目。 Struts 2框架使用OGNL作为默认的表达式语言。

相对EL表达式,它提供了平时我们需要的一些功能,如:
支持对象方法调用,如xxx.sayHello()
支持类静态方法调用和值访问,表达式的格式为@[类全名(包括包路径)]@[方法名 | 值名],例如:@java.lang.String@format('foo %s', 'bar')@cn.itcast.Constant@APP_NAME

操作集合对象

Ognl 有一个上下文(Context)概念,说白了上下文就是一个MAP结构,它实现了java.utils.Map接口,在Struts2中上下文(Context)的实现为ActionContext,下面是上下文(Context)的结构示意图
2.
访问上下文(Context)中的对象需要使用#符号标注命名空间,如#application#session

另外OGNL会设定一个根对象(root对象),在Struts2中根对象就是ValueStack(值栈) 。如果要访问根对象(即ValueStack)中对象的属性,则可以省略#命名空间,直接访问该对象的属性即可。

struts2中,根对象ValueStack的实现类为OgnlValueStack,该对象不是我们想像的只存放单个值,而是存放一组对象。在OgnlValueStack类里有一个List类型的root变量,就是使用他存放一组对象
|--request  
|--application  
context ------|--OgnlValueStack root
变量[action, OgnlUtil, ... ]  
|--session  
|--attr  
|--parameters

root变量中处于第一位的对象叫栈顶对象。通常我们在OGNL表达式里直接写上属性的名称即可访问root变量里对象的属性,搜索顺序是从栈顶对象开始寻找,如果栈顶对象不存在该属性,就会从第二个对象寻找,如果没有找到就从第三个对象寻找,依次往下访问,直到找到为止。
大家注意: Struts2中,OGNL表达式需要配合Struts标签才可以使用。如:<s:property value="name"/>

3.由于ValueStack(值栈)Struts 2OGNL的根对象,如果用户需要访问值栈中的对象,在JSP页面可以直接通过下面的EL表达式访问ValueStack(值栈)中对象的属性:
${foo} //
获得值栈中某个对象的foo属性

如果访问其他Context中的对象,由于他们不是根对象,所以在访问时,需要添加#前缀。
application
对象:用于访问ServletContext,例如#application.userName或者#application['userName'],相当于调用ServletContextgetAttribute("username")

session对象:用来访问HttpSession,例如#session.userName或者#session['userName'],相当于调用session.getAttribute("userName")

request对象:用来访问HttpServletRequest属性(attribute)的Map,例如#request.userName或者#request['userName'],相当于调用request.getAttribute("userName")

parameters对象:用于访问HTTP的请求参数,例如#parameters.userName或者#parameters['userName'],相当于调用request.getParameter("username")

attr对象:用于按page->request->session->application顺序访问其属性。

4.为何使用EL表达式能够访问valueStack中对象的属性

原因是Struts2HttpServletRequest作了进一步的封装。简略代码如下:

public class StrutsRequestWrapper extends HttpServletRequestWrapper {
public StrutsRequestWrapper(HttpServletRequest req) {
super(req);
}
public Object getAttribute(String s) {
......
ActionContext ctx = ActionContext.getContext();
Object attribute = super.getAttribute(s);//
先从request范围获取属性值

if (ctx != null) {
if (attribute == null) {//
如果从request范围没有找到属性值,即从ValueStack中查找对象的属性值
......
ValueStack stack = ctx.getValueStack();
attribute = stack.findValue(s);
......
}
}
return attribute;
}
}

5.采用OGNL表达式创建List/Map集合对象

如果需要一个集合元素的时候(例如List对象或者Map对象),可以使用OGNL中同集合相关的表达式。
使用如下代码直接生成一个List对象:
<s:set name="list" value="{'zhangming','xiaoi','liming'}" />
<s:iterator value="#list" id="n">
<s:property value="n"/><br>
</s:iterator>

生成一个Map对象:
<s:set name="foobar" value="#{'foo1':'bar1', 'foo2':'bar2'}" />
<s:iterator value="#foobar" >
<s:property value="key"/>=<s:property value="value"/><br>
</s:iterator>

Set标签用于将某个值放入指定范围。
scope
:指定变量被放置的范围,该属性可以接受applicationsessionrequest pageaction。如果没有设置该属性,则默认放置在OGNL Context中。
value
:赋给变量的值.如果没有设置该属性,则将ValueStack栈顶的值赋给变量。


6.
采用OGNL表达式判断对象是否存在于集合中
对于集合类型,OGNL表达式可以使用innot in两个元素符号。其中,in表达式用来判断某个元素是否在指定的集合对象中;not in判断某个元素是否不在指定的集合对象中,如下所示。
in
表达式:
<s:if test="'foo' in {'foo','bar'}">

</s:if>
<s:else>
不在
</s:else>

not in表达式:
<s:if test="'foo' not in {'foo','bar'}">
不在
</s:if>
<s:else>

</s:else>

7.OGNL表达式的投影功能
除了innot in之外,OGNL还允许使用某个规则获得集合对象的子集,常用的有以下3个相关操作符。
?
:获得所有符合逻辑的元素。
^
:获得符合逻辑的第一个元素。
$
:获得符合逻辑的最后一个元素。
例如代码:
<s:iterator value="books.{?#this.price > 35}">
<s:property value="title" /> - $<s:property value="price" /><br>
</s:iterator>
在上面代码中,直接在集合后紧跟.{}运算符表明用于取出该集合的子集,{}内的表达式用于获取符合条件的元素,this指的是为了从大集合books筛选数据到小集合,需要对大集合books进行迭代,this代表当前迭代的元素。本例的表达式用于获取集合中价格大于35的书集合。
public class BookAction extends ActionSupport {
private List<Book> books;
....
@Override
public String execute() {
books = new LinkedList<Book>();
books.add(new Book("A735619678", "spring", 67));
books.add(new Book("B435555322", "ejb3.0",15));
}
}

8.property标签
property
标签用于输出指定值:
<s:set name="name" value="'kk'" />
<s:property value="#name"/>
default
:可选属性,如果需要输出的属性值为null,则显示该属性指定的值
escape
:可选属性,指定是否格式化HTML代码。
value
:可选属性,指定需要输出的属性值,如果没有指定该属性,则默认输出ValueStack栈顶的值。
id
:可选属性,指定该元素的标识


9. iterator
标签
iterator
标签用于对集合进行迭代,这里的集合包含ListSet和数组。
<s:set name="list" value="{'zhangming','xiaoi','liming'}" />
<s:iterator value="#list" status="st">
<font color=<s:if test="#st.odd">red</s:if><s:else>blue</s:else>>
<s:property /></font><br>
</s:iterator>
value
:可选属性,指定被迭代的集合,如果没有设置该属性,则使用ValueStack栈顶的集合。
id
:可选属性,指定集合里元素的id
status
:可选属性,该属性指定迭代时的IteratorStatus实例。该实例包含如下几个方法:
int getCount()
,返回当前迭代了几个元素。
int getIndex()
,返回当前迭代元素的索引。
boolean isEven()
,返回当前被迭代元素的索引是否是偶数
boolean isOdd()
,返回当前被迭代元素的索引是否是奇数
boolean isFirst()
,返回当前被迭代元素是否是第一个元素。
boolean isLast()
,返回当前被迭代元素是否是最后一个元素。

10.if/elseif/else标签
<s:set name="age" value="21" />
<s:if test="#age==23">
23
</s:if>
<s:elseif test="#age==21">
21
</s:elseif>
<s:else>
都不等
</s:else>

10.url标签

<s:url action="helloworld_add" namespace="/test"><s:param name="personid" value="23"/></s:url>
生成类似如下路径:

/struts/test/helloworld_add.action?personid=23
红色部分为内容路径。

当标签的属性值作为字符串类型处理时, “%”符号的用途是计算OGNL表达式的值。
<s:set name="myurl" value="'http://www.foshanshop.net'"/>
<s:url value="#myurl" /><br>
<s:url value="%{#myurl}" />
输出结果:
#myurl
http://www.foshanshop.net


11.
表单标签_checkboxlist复选框

如果集合为list
<s:checkboxlist name="list" list="{'Java','.Net','RoR','PHP'}" value="{'Java','.Net'}"/>
生成如下html代码:

<input type="checkbox" name="list" value="Java" checked="checked"/><label>Java</label>
<input type="checkbox" name="list" value=".Net" checked="checked"/><label>.Net</label>
<input type="checkbox" name="list" value="RoR"/><label>RoR</label>
<input type="checkbox" name="list" value="PHP"/><label>PHP</label>

如果集合为MAP
<s:checkboxlist name="map" list="#{1:'
瑜珈用品',2:'户外用品',3:'球类',4:'自行车
'}" listKey="key" listValue="value" value="{1,2,3}"/>
生成如下html代码:

<input type="checkbox" name="map" value="1" checked="checked"/><label>
瑜珈用品</label>
<input type="checkbox" name="map" value="2" checked="checked"/><label>
户外用品
</label>
<input type="checkbox" name="map" value="3" checked="checked"/><label>
球类
</label>
<input type="checkbox" name="map" value="4"/><label>
自行车</label>


12.
表单标签_checkboxlist复选框
如果集合里存放的是javabean
<%
Person person1 = new Person(1,"
第一个
");
Person person2 = new Person(2,"
第二个
");
List<Person> list = new ArrayList<Person>();
list.add(person1);
list.add(person2);
request.setAttribute("persons",list);
%>
<s:checkboxlist name="beans" list="#request.persons" listKey="personid" listValue="name"/>
Personid
namePerson的属性

生成如下html代码:
<input type="checkbox" name=“beans" value="1"/><label>
第一个</label>
<input type="checkbox" name=“beans" value="2"/><label>
第二个</label>

13.表单标签_radio单选框
该标签的使用和checkboxlist复选框相同。
如果集合里存放的是javabean(personidnamePerson的属性)
< s:radio name="beans" list="#request.persons" listKey="personid" listValue="name"/>
生成如下html代码:

<input type="radio" name="beans" id="beans1" value="1"/><label>
第一个</label>
<input type="radio" name="beans" id="beans2" value="2"/><label>
第二个
</label>
如果集合为
MAP
<s:radio name="map" list="#{1:'
瑜珈用品',2:'户外用品',3:'球类',4:'自行车
'}" listKey="key" listValue="value“ value="1"/>
生成如下html代码:

<input type="radio" name="map" id="map1" value="1"/><label for="map1">
瑜珈用品</label>
<input type="radio" name="map" id="map2" value="2"/><label for="map2">
户外用品
</label>
<input type="radio" name="map" id="map3" value="3"/><label for="map3">
球类
</label>
<input type="radio" name="map" id="map4" value="4"/><label for="map4">
自行车
</label>
如果集合为
list
<s:radio name="list" list="{'Java','.Net'}" value="'Java'"/>
生成如下html代码:

<input type="radio" name="list" checked="checked" value="Java"/><label>Java</label>
<input type="radio" name="list" value=".Net"/><label>.Net</label>

14.表单标签_select下拉选择框
<s:select name="list" list="{'Java','.Net'}" value="'Java'"/>
<select name="list" id="list">
<option value="Java" selected="selected">Java</option>
<option value=".Net">.Net</option>
</select>
<s:select name="beans" list="#request.persons" listKey="personid" listValue="name"/>
<select name="beans" id="beans">
<option value="1">
第一个</option>
<option value="2">
第二个
</option>
</select>
<s:select name="map" list="#{1:'
瑜珈用品',2:'户外用品',3:'球类',4:'自行车
'}" listKey="key" listValue="value" value="1"/>
<select name="map" id="map">
<option value="1" selected="selected">
瑜珈用品
</option>
<option value="2">
户外用品
</option>
<option value="3">
球类
</option>
<option value="4">
自行车
</option>
</select>

 

struts2 OGNL表达式

Struts2 2010-01-29 11:03:00 阅读301 评论0 字号:大中

OGNLObject Graph Navigation Language的简称,详细相关的信息可以参考:http://www.ognl.org。这里我们只涉及Struts2框架中对OGNL的基本支持。

Struts 2默认的表达式语言是OGNL,原因是它相对其它表达式语言具有下面几大优势:

1.  支持对象方法调用,如xxx.doSomeSpecial()

2.  支持类静态的方法调用和值访问,表达式的格式为@[类全名(包括包路径)]@[方法名 | 值名],例如:@java.lang.String@format('foo %s', 'bar')@tutorial.MyConstant@APP_NAME

3.  支持赋值操作和表达式串联,如price=100, discount=0.8, calculatePrice(),这个表达式会返回80

4.  访问OGNL上下文(OGNL context)和ActionContext

5.  操作集合对象。

#%$这三个符号的使用:

“#”主要有三种用途:

1.  访问OGNL上下文和Action上下文,#相当于ActionContext.getContext();下表有几个ActionContext中有用的属性:

名称

作用

例子

parameters

包含当前HTTP请求参数的Map

#parameters.id[0]作用相当于request.getParameter("id")

request

包含当前HttpServletRequest的属性(attribute)Map

#request.userName相当于request.getAttribute("userName")

session

包含当前HttpSession的属性(attribute)的Map

#session.userName相当于session.getAttribute("userName")

application

包含当前应用的ServletContext的属性(attribute)的Map

#application.userName相当于application.getAttribute("userName")

attr

用于按request > session > application顺序访问其属性(attribute

#attr.userName相当于按顺序在以上三个范围(scope)内读取userName属性,直到找到为止

2.  用于过滤和投影(projecting)集合,如books.{?#this.price<100}

3.  构造Map,如#{'foo1':'bar1', 'foo2':'bar2'}

“%”符号的用途是在标志的属性为字符串类型时,计算OGNL表达式的值。例如在Ognl.jsp中加入以下代码:

<hr />
<h3>%的用途</h3>
<p><s:url value="#foobar['foo1']" /></p>
<p><s:url value="%{#foobar['foo1']}" /></p>

OGNL是一个对象,属性的查询语言。在OGNL中有一个类型为MapContext(称为上下文),在这个上下文中有一个根元素(root),对根元素的属性的访问可以直接使用属性名字,但是对于其他非根元素属性的访问必须加上特殊符号#

Struts2中上下文为ActionContext,根元素位Value Stack(值堆栈,值堆栈代表了一族对象而不是一个对象,其中Action类的实例也属于值堆栈的一个)。ActionContext中的内容如下图:

              |--application

              |

              |--session

context map---|

              |--value stack(root)

              |

              |--request

              |

              |--parameters

              |

              |--attr (searches page, request, session, then application scopes)

             

因为Action实例被放在Value Stack中,而Value Stack又是根元素(root)中的一个,所以对Action中的属性的访问可以不使用标记#,而对其他的访问都必须使用#标记。

引用Action的属性

<s:property value="postalCode"/>

ActionContext中的其他非根(root)元素的属性可以按照如下的方式访问:

<s:property value="#session.mySessionPropKey"/> or

<s:property value="#session["mySessionPropKey"]"/> or

<s:property value="#request["mySessionPropKey"]/>

Action类可以使用ActionContext中的静态方法来访问ActionContext

ActionContext.getContext().getSession().put("mySessionPropKey", mySessionObject);

 

OGNLCollectionListsMapsSets

 

生成List的语法为: {e1,e2,e3}.

<s:select label="label" name="name"

list="{'name1','name2','name3'}" value="%{'name2'}" />

上面的代码生成了一个HTML Select对象,可选的内容为: name1name2name3,默认值为:name2

生成Map的语法为:#{key1:value1,key2:value2}.

<s:select label="label" name="name"

list="#{'foo':'foovalue', 'bar':'barvalue'}" />

上面的代码生成了一个HTML Select对象,foo名字表示的内容为:foovaluebar名字表示的内容为:barvalue

对于集合,OGNL提供了两个元素符:innot in,其中in判断某个元素是否在指定集合中;not in则用于判断某个元素是否不在指定集合中。

判断一个对象是否在List内存在:

<s:if test="'foo' in {'foo','bar'}">

   muhahaha

</s:if>

<s:else>

   boo

</s:else>

<s:if test="'foo' not in {'foo','bar'}">

   muhahaha

</s:if>

<s:else>

   boo

</s:else>

取得一个List的一部分:

? – 所有满足选择逻辑的对象

^ -   第一个满足选择逻辑的对象

$ -   最后一个满足选择逻辑的对象

例如:

person.relatives.{? #this.gender == 'male'}

上述代码取得这个人(person)所有的男性(this.gender==male)的亲戚(relatives)

 

Lambda 表达式

 

OGNL支持简单的Lambda表达式语法,使用这些语法可以建立简单的lambda函数。

例如:

Fibonacci:

if n==0 return 0;

elseif n==1 return 1;

else return fib(n-2)+fib(n-1);

fib(0) = 0

fib(1) = 1

fib(11) = 89

OGNLLambda表达式如何工作呢?

Lambda表达式必须放在方括号内部,#this表示表达式的参数。例如:

<s:property value="#fib =:[#this==0 ? 0 : #this==1 ? 1 : #fib(#this-2)+#fib(#this-1)], #fib(11)" />

#fib =:[#this==0 ? 0 : #this==1 ? 1 : #fib(#this-2)+#fib(#this-1)]定义了一个Lambda表达式,

#fib(11) 调用了这个表达式。

所以上述代码的输出为:89

JSP2.1#被用作了JSP EL(表达式语言)的特殊记好,所以对OGNL的使用可能导致问题,

一个简单的方法是禁用JSP2.1EL特性,这需要修改web.xml文件:

<jsp-config>

    <jsp-property-group>

      <url-pattern>*.jsp</url-pattern>

      <el-ignored>true</el-ignored>

    </jsp-property-group>

</jsp-config>

 

4.6 Tag 语法

代码示例:

表达式

含义

<p>Username: ${user.username}</p>

一个在标准上下文中的JavaBean对象,可以适用FreemarkerVelocity,JSTL EL等(不是OGNL)。

<s:textfield name="username"/>

Value Stack中的一个username属性。

<s:url id="es" action="Hello">

<s:param name="request_locale">

    es

</s:param>

</s:url>

<s:a href="%{es}">Espanol</s:a>

引用Value Stack中属性的另外一种方法。

<s:property

name="#session.user.username" />

Session中的user对象的username属性。

<s:select

label="FooBar" name="foo"

list="#{'username':'trillian',

    'username':'zaphod'}" />

一个简单的静态Map,和put("username","trillian")一样

 

Struts2OGNL基础上的增强


  1、值栈(ValueStack)
    Struts2OGNL上下文设置为Struts2中的ActionContext(内部使用的仍然是OgnlContext),并将值栈设为OGNL的根对象。

    我们知道,OGNL上下文中的根对象可以直接访问,不需要使用任何特殊的标记,而引用上下文中的其他对象则需要使用“#”来标记。由于值栈是 上下文中的根对象,因此可以直接访问。那么对于值栈中的对象该如何访问呢?Struts2提供了一个特殊的OGNLPropertyAccessor,它 可以自动查找栈内的所有对象(从栈顶到栈底),直接找到一个具有你所查找的属性的对象。也就是说,对于值栈中的任何对象都可以直接访问,而不需要使用 “#”
    假设值栈中有两个对象:studentemployee,两个对象都有name属性,student有学号属性number,而 employee有薪水属性salaryemployee先入栈,student后入栈,位于栈顶,那么对于表达式name,访问的就是student name属性,因为student对象位于栈顶;表达式salary,访问的就是employeesalary属性。正如你所见,访问值栈中的对象属 性或方法,无须指明对象,也不用“#”,就好像值栈中的对象都是OGNL上下文中的根对象一样。这就是Struts2OGNL基础上做出的改进。
  2、[N]语法
    如上所述,如果想要访问employeename属性,应该如何写表达式呢?我们可以使用[N].xxx(N是从0开始的整数)这样的语法来指定从哪一个位置开始向下查找对象的属性,表达式[1].name访问的就是employee对象的name属性。
    在使用[N].xxx语法时,要注意位置序号的含义,它并不是表示获取栈中索引为N的对象,而是截取从位置N开始的部分栈。
  3、top关键字
    top用于获取栈顶的对象,结合[N].xxx语法,我们就可以获取栈中任意位置的对象。
    如:[0].top,[1].top
  4、访问静态成员
    除了使用标准的OGNL表达式访问静态字段和静态方法外,Struts2还允许你不指定完整的类名,而是通过“vs”前缀来调用保存在栈中的静态字段和静态方法。
    @vs@FOO_PROPERTY
    
@vs@someMethod()
    
@vs1@someMethod()
    vs表示ValueStack,如果只有vs,那么将使用栈顶对象的类;如果在vs后面跟上一个数字,那么将使用栈中指定位置处的对象类。

  5、值栈中的Action实例
    Struts2框架总是把Action实例放在栈顶。因为Action在值栈中,而值栈又是OGNL中的根,所以引用Action的属性可以省略“#”标记,这也是为什么我们在结果页面中可以直接访问Action的属性的原因。
  6、Struts2中的命名对象
    Struts2还提供了一些命名对象,这些对象没有保存在值栈中,而是保存在ActionContext中,因此访问这些对象需要使用“#”标记。这些命名对象都是Map类型。
   parameters
    用于访问请求参数。如:#parameters['id']#parameters.id,相当于调用了HttpServletRequest对象的getParameter()方法。

    注意,parameters本质上是一个使用HttpServletRequest对象中的请求参数构造的Map对象,一量对象被创建(在调用Action实例之前就已经创建好了),它和HttpServletRequest对象就没有了任何关系。
   request
    用于访问请求属性。如:#request['user']#request.user,相当于调用了HttpServletRequest对象的getAttribute()方法。

   session
    用于访问session属性。如:#session['user']#session.user,相当于调用了HttpSession对象的getAttribute()方法。

   application
    用于访问application属性。如:#application['user']#application.user,相当于调用了ServletContextgetAttribute()方法。

   attr
    如果PageContext可用,则访问PageContext,否则依次搜索requestsessionapplication对象。

 

PS:

JSP 2.1 # 被加入了 JSP EL.中。这可能导致一些应用OGNL#号操作的程序出问题,下面是一种快速修复的方法是在web.xml中加上jsp-config的标签,这适用于一些支持JSP 2.1 EL表达式的容器,如GlassFish.
<jsp-config>
 <jsp-property-group>
 <url-pattern>*.jsp</url-pattern>
 <el-ignored>true</el-ignored>
 </jsp-property-group>
 </jsp-config>