struts2.0标签

1. OGNL 中有生成 List 和 Map 的表达式，分别是：{e1,e2,e3,...} 和 #{key1:val1,key2:val2,...}。对集合 OGNL 提供了两个操作符 in 和 not in，如：

   <s:if test="'foo' in {'foo','bar'}" ... </s:if>            ---- not in 的用法当然是一样的了。

之外，OGNL 还允许通过某个规则取集合的子集

    ·? ：取出所有符合条件逻辑的元素

    ·^：取出符合条件的第一个元素

    ·$：取出符合条件的最后一个元素

请将上面这三个符号与正则表达式的表示法联系起来

例了：persons.relatives.{? #this.gender == 'male'}        //取出集合 persons 中所有 gender 属性为 'male' 的子集。

理解 ValueStack 和 Stack Context：

   1) ValueStack 可以用 request.getAttribute("struts.valueStack") 取得的一个 com.opensymphony.xwork2.util.OgnlValueStack 实例，它实现为一个栈，有 peek()、pop()、push(obj) 方法。

   2) Stack Context 是在前面的 ValueStack 的上下中的一个 java.util.Stack 实例：

   //stack 为 ValueStack 实例，COMPONENT_STACK="__component_stack"

   // org.apache.struts2.components.Component.getComponentStack() 中的代码

   Stack componentStack = (Stack) stack.getContext().get(COMPONENT_STACK);

取值要通过<s:property value="" />或在任意的<s:/>标签内使用%{}；

当Action的valueStack中有该属性的值时，只需直接使用该属性的名字即可；

当Action的valueStack中没有该属性的值时，比如在session,application范围中的属性值时，需要加#或者#attr.；


假设某Action中有person成员变量，在application中存在company属性
那么我们可以通过以下方法取值：
<s:property value= "person.name" />
<s:property value= "#person.name" />
<s:property value= "company.name" /> //无法取到，因为company不在action的valueStack中
<s:property value= "#company.name" />
<s:textfield name= "person.name" value= "person.name" /> //错误，value会直接显示person.name字样
<s:textfield name= "person.name" value= "%{person.name}" />
<s:textfield name= "person.company.name" value= "%{#company.name}" />
<s:textfield name= "person.company.name" value= "%{#attr.company.name}" />



2. Struts2 的各路标签

    <s:if test="exp">...</s:if><s:elseif test="exp">...</s:elseif><s:else>...</s:else> 对应了 java 的 if/else if/else

    <s:iterator.../> value 未指定是默认为 ValueStack 栈顶集合。id 为当前元素变量名。status 为 IteratorStatus 实例，包含奇还是偶行，当前索引，是否第一或最后一条记录。

  

3. iterator 可以迭代 List、Set 和数组，也可以迭代 Map，用法如下：


<s:iterator value= "{'e1','e2','e3'}" id= "name" status= "st" >    //这是用 OGNL 生成的 List
          <s:property value= "name" /> //也可以写成 <s:property value="#name"/>
            <s: if test= "#st.odd" >偶数位</s: if >
            // st 其他属必如：#st.count、#st.index、#st.even、#st.first、#st.last，前面的 # 号不能少
     </s:iterator>
    迭代 Map，用 key 和 map 对应
    <s:iterator value= "#{'key1':'val1','key2':'val2','key3':'val3'}" >
       <s:property value= "key" /> | <s:property value= "value" /> //不能写成 #key 和 #value
    </s:iterator>


4. <s:append.../> 用于将多个集合拼成一个新集合，从而能用一个<s:iterator .../> 对多个集合迭代，也能拼 Map 的。<s:merge .../> 也是用来拼接集合，只是不像 <s:append .../> 那样依次保持着顺序，<s:merge .../> 是交错的。可以理解为前一个是深度拼接，后一个是广度拼接。

5. 在学习 <s:generator .../> 时我们能同时体验一下 Struts2 标签是如何操作栈的，当然这里指的是 ValueStack，而非 Java 的方法栈。

    <s:generator val="'1,2,3'" separator=","> <!--字符串'123'以","分隔生成一个集合，并压栈-->

        <s:iterator>      <!-- 这里没有指定 value 属性，默认弹栈，并取一个元素压栈 -->             

           <s:property/> <!-- 也没有指定 value 属性，默认也是取栈顶元素 -->

        </s:iterator>     <!-- 迭代完成则从集合遍历的最后一个元素出栈 -->

    </s:generator>      <!-- 最后，自动出栈，generator 生成的集合出栈 -->

    汇编是基于寄存器操作的，而 Java 是基于栈的操作，Struts2 引入了存放在 request 中的 ValueStack 正好完美再现了 Java 的这一原始本性，并可使标签使用更简洁，灵活。Struts2 还有很多标签也有这个特性：

    1) 生成的新实例，压栈，标签结束后自动出栈

    2) 在未指定数据来源时，默认从栈顶取数据。

    不禁回想起 Struts1 的 <nested:root> 等 nested 标签要显示的声明操作的根元素，是多么麻烦的一件事。

    补充：如果指定了 <s:generator .../> 的 id 属性的话，同时还会把生成的集合放到 pageContext 中，key 就是 id 指定的值。

6. <s:subset .../> 是用来取集合子集的，可从 source (未指定则为栈顶集合) 集合的 start 位置起取 count 个元素。或者按自定义的 decider 条件，取符合条件的子集。你的 decider 要实现 SubsetIteratorFilter.Decider 接口的 decide(object element) 方法，符合条件的返回 true。此处不列出具体用法的实例。

7. <s:sort .../> 依据 comparator 指定的比较器，对 source (未指定则为栈顶集合) 集合排序。排序头的集合当然也是压入栈中，标签结束自动出栈。

8. <s:debug/> 会在页面生成一个 debug 链接，展开能看到 ValueStack 和 Stack Context 中的内容，该页面有显示用 #key 能获取到 Stack Context 中的值。<s:property .../> 在前面用很多次了，就相当于 Struts1 的 <bean:write .../>，value 未指定，输出栈顶值；若要输出的值为 null 时，指定了 default 属性则输出它；escape 指定是否忽略 HTML 代码，同 <bean:write .../> 的 ignore 属性。

9. <s:push .../> 用于将某个值压栈，标签结束后自动出栈，可方便某些操作，Struts1 的 <nested:root> 有类似功能。<s:set .../> 标签用于把某个值放入指定范围内，用 scope 指定，如 application、session、request、page、action。若未指定 scope 则放到 Stack Context 中；name 为新变量名；value 为欲处理的变量，未指定则取栈顶值。

10. 从前面的标签，你也许已经注意到，Struts2 常操作的几个数据结构有 ValueStack、pageContext 和 StackContext。例如：generator、sort、subset 等生成的新实例会压到栈顶，并在标签结束自动出栈；如果 sort、subset 未指定 source 源集合，则从栈顶取，iterator、property 也是一样的；若为 generator 指定了 id 属性，则生的集合会存到 pageContext 中，key 就是 id 对应值；如果为 bean 指定了 id 属性，则会把 bean 实例存入到 Stack Context 中，key 就是 id 对应值，Stack Conext 中的值可以用 #key 取得。其他标签类似的地方应该要注意到。



1. property标签

property标签用于输出指定值：

<s:set name="name" value="'kk'" />

<s:property value="#name"/>

default：可选属性，如果需要输出的属性值为null，则显示该属性指定的值

escape：可选属性(true，false)，指定是否格式化HTML代码。

value：可选属性，指定需要输出的属性值，如果没有指定该属性，则默认输出ValueStack栈顶的值。

id：可选属性，指定该元素的标识


--------------------------------------------------------------------------------


2. iterator标签

iterator标签用于对集合进行迭代，这里的集合包含List、Set和数组。

<s:set name="list" value="{'zhangming','xiaoi','liming'}" />

<s:iterator value="#list" id="name" status="st">

       <font color=<s:if test="#st.odd">red</s:if><s:else>blue</s:else>>

       <s:property value="name"/></font><br>

</s:iterator>

value：可选属性，指定被迭代的集合，如果没有设置该属性，则使用ValueStack栈顶的集合。

id：可选属性，指定集合里元素的id。

status：可选属性，该属性指定迭代时的IteratorStatus实例。该实例包含如下几个方法：

       int getCount()，返回当前迭代了几个元素。

       int getIndex()，返回当前迭代元素的索引。

       boolean isEven()，返回当前被迭代元素的索引是否是偶数

       boolean isOdd()，返回当前被迭代元素的索引是否是奇数

       boolean isFirst()，返回当前被迭代元素是否是第一个元素。

       boolean isLast()，返回当前被迭代元素是否是最后一个元素。


--------------------------------------------------------------------------------


3. 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>


--------------------------------------------------------------------------------


4. 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


--------------------------------------------------------------------------------


5. 表单标签_checkboxlist复选框

<1> 如果集合为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>

<2> 如果集合为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>

<3> 如果集合里存放的是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 和name 为Person 的属性

生成如下html代码：

<input type="checkbox" name=“beans" value="1"/><label>第一个</label>

<input type="checkbox" name=“beans" value="2"/><label>第二个</label>


--------------------------------------------------------------------------------


6. 表单标签_radio单选框

该标签的使用和checkboxlist复选框相同。

<1> 如果集合里存放的是javabean(personid和name为Person的属性)

<s:checkboxlist 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>

<2> 如果集合为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>

<3> 如果集合为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>


--------------------------------------------------------------------------------


7. 表单标签_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>


--------------------------------------------------------------------------------


8. <s:token />标签

<s:token />标签防止重复提交，用法如下：

第一步：在表单中加入<s:token />

<s:form action="helloworld_other" method="post" namespace="/test">

  <s:textfield name="person.name"/><s:token/><s:submit/>

  </s:form>

第二步：

<action name="helloworld_*" class="cn.itcast.action.HelloWorldAction" method="{1}">

       <interceptor-ref name="defaultStack" />

        <interceptor-ref name="token" />

        <result name="invalid.token">/WEB-INF/page/message.jsp</result> 

        <result>/WEB-INF/page/result.jsp</result>        

</action>

以上配置加入了“token”拦截器和“invalid.token”结果，因为“token”拦截器在会话的token与请求的token不一致时，将会直接返回“invalid.token”结果。

在debug状态,控制台出现下面信息,是因为Action中并没有struts.token和struts.token.name属性,我们不用关心这个错误：

严重: ParametersInterceptor - [setParameters]: Unexpected Exception caught setting 'struts.token' on 'class xxx: Error setting expression_r 'struts.token' with value '[Ljava.lang.String;@39f16f'

严重: ParametersInterceptor - [setParameters]: Unexpected Exception caught setting 'struts.token.name'



Struts2<5> 国际化

1. 准备资源文件，资源文件的命名格式如下：

baseName_language_country.properties

baseName_language.properties

baseName.properties

其中baseName是资源文件的基本名，我们可以自定义，但language和country必须是java支持的语言和国家。如：

中国大陆： baseName_zh_CN.properties

美国： baseName_en_US.properties

注意：对于中文的属性文件，我们编写好后，应该使用jdk提供的native2ascii命令把文件转换为unicode编码的文件。命令的使用方式如下：

native2ascii  源文件.properties  目标文件.properties


--------------------------------------------------------------------------------


2. 配置全局资源与输出国际化信息

现在两个资源文件：

第一个存放中文：itcast_zh_CN.properties

内容为：user=黎明

第二个存放英语（美国）： itcast_en_US.properties

内容为： user=liming

使用上面的资源文件，在struts.xml中使用常量加载全局资源文件如下：

<constant name="struts.custom.i18n.resources" value="itcast" />

itcast为资源文件的基本名。

<1> 在JSP页面中使用<s:text name=“”/>标签输出国际化信息：

<s:text name=“user”/>，name为属性文件中的key

<2> 在Action类中，可以继承ActionSupport，使用getText()方法，该方法的第一个参数用于指定属性文件中的key。

<3> 在表单标签中，通过key属性指定属性文件中的key，如：

<s:textfield name="realname" key="user"/>


--------------------------------------------------------------------------------


3. 输出带占位符的国际化信息

<1> 属性文件中的内容如下：

welcome={0},你好,欢迎来到{1}

<2> 在jsp页面中输出带占位符的国际化信息

<s:text name="welcome">

       <s:param><s:property value="realname"/></s:param>

       <s:param>传智播客</s:param>

</s:text>

<3> 在Action类中获取带占位符的国际化信息，可以使用getText(String key, String[] args)或getText(String aTextName, List args)方法。


--------------------------------------------------------------------------------


4. 包范围资源文件

在一个大型应用中，整个应用有大量的内容需要实现国际化，我们可以针对不同模块、不同的action来组织国际化文件。

<1> 在java的包下放置package_language_country.properties资源文件，package为固定写法，处于该包及子包下的 action都可以访问该资源。当查找指定key的消息时，系统会先从package资源文件查找，当找不到对应的key时，才会从常量 struts.custom.i18n.resources指定的资源文件中寻找。

<2> 使用<s:i18n>标签指定从某个特定的资源文件中取数据

<s:i18n name="messageResource">

    <s:text name="helloWorld"></s:text>

</s:i18n>

<3> 指定从messageResource取资源


--------------------------------------------------------------------------------


5. Action范围资源文件

我们也可以为某个action单独指定资源文件，方法如下：

在Action类所在的路径，放置ActionClassName_language_country.properties资源文件，ActionClassName为action类的简单名称。

当查找指定key的消息时，系统会先从ActionClassName_language_country.properties资源文件查找，如果没有找到对应的key，然后沿着当前包往上查找基本名为package 的资源文件，一直找到最顶层包。如果还没有找到对应的key，最后会从常量struts.custom.i18n.resources指定的资源文件中寻找。


--------------------------------------------------------------------------------


6.JSP中直接访问某个资源文件

使用<s:i18n>标签指定直接从某个特定的资源文件中取数据

<s:i18n name="itcast">

    <s:text name=“welcome”/>

</s:i18n>

Itcast为类路径下资源文件的基本名。

如果要访问类路径下某个包下的资源文件，如下：

<s:i18n name=“cn/itcast/action/package">

      <s:text name="welcome">

             <s:param>小张</s:param>

      </s:text>

</s:i18n>

上面访问cn.itcast.action包下基本名为package的资源文件。



Struts2<6> OGNL表达式语言

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


--------------------------------------------------------------------------------


1. OGNL的特点：

相对EL表达式，它提供了平时我们需要的一些功能，如：

<1> 支持对象方法调用，如xxx.sayHello()；

<2> 支持类静态的方法调用和值访问，表达式的格式为@[类全名（包括包路径）]@[方法名 |  值名]，例如：@java.lang.String@format('foo %s', 'bar')或@cn.itcast.Constant@APP_NAME；

<3> 操作集合对象。


--------------------------------------------------------------------------------


2. 标准的OGNL会设定一个根对象（root对象）。假设使用标准OGNL表达式来求值（不使用Struts 2的OGNL表达式），如果OGNL上下文（OgnlContext Map类型）有两个对象：foo对象，在OgnlContext中名称为foo；bar对象，在OgnlContext中名称为bar。同时foo对象被设置为根对象（root）。则利用下面的OGNL表达式求值：

#foo.blah // 返回foo.getBlah()

#bar.blah //返回bar.getBlah()

blah //返回foo.getBlah() ，因为foo为根对象

访问Ognl Context中的对象需要使用#符号标注命名空间，如#bar，如果要访问的属性属于根对象，则可以省略命名空间，直接访问该属性。


--------------------------------------------------------------------------------


3. Struts 2中的OGNL Context是ActionContext，结构示意图如下:



<1> 当Struts2接受一个请求时，它迅速创建ActionContext,ValueStack,action object。然后action被存到ValueStack，所以action的实例变量可以被OGNL访问。

<2> 由于ValueStack(值栈)是Struts 2中OGNL的根对象，如果用户需要访问值栈中的对象，则可以直接通过下面的EL表达式访问ValueStack(值栈)中对象的属性：

${foo} //获得值栈中某个对象的foo属性

<3> 如果访问其他Context中的对象，由于不是根对象，在访问时，需要加#前缀。

① application对象：用于访问ServletContext，例如#application.userName或者#application['userName']，相当于调用Servlet的getAttribute("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. 如果需要一个集合元素的时候（例如List对象或者Map对象），可以使用OGNL中同集合相关的表达式。

<1> 使用如下代码直接生成一个List对象：

<s:set name="list" value="{'zhangming','xiaoi','liming'}" />

<s:iterator value="#list" id="n">

       <s:property value="n"/><br>

</s:iterator> 

<2> 生成一个Map对象：

<s:set name="foobar" value="#{'foo1':'bar1', 'foo2':'bar2'}" />

<s:iterator value="#foobar" id="n" status="st">

       <s:property value="key"/>=<s:property value="value"/><br>

</s:iterator>

Set标签用于将某个值放入指定范围。

scope：指定变量被放置的范围，该属性可以接受application、session、request、 page或action。如果没有设置该属性，则默认放置在OGNL Context中。

value：赋给变量的值.如果没有设置该属性,则将ValueStack栈项的值赋给变量。

<3> 对于集合类型，OGNL表达式可以使用in和not 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>

<4> 除了in和not in之外，OGNL还允许使用某个规则获得集合对象的子集，常用的有以下3个相关操作符。

?：获得所有符合逻辑的元素。

^：获得符合逻辑的第一个元素。

$：获得符合逻辑的最后一个元素。

例如代码：

<s:iterator value="books.{?#this.price > 35}">

      <s:property value="title" /> - $<s:property value="price" /><br>

</s:iterator>

在上面代码中，直接在集合后紧跟.{}运算符表明用于取出该集合的子集，{}内的表达式用于获取符合条件的元素，本例的表达式用于获取集合中价格大于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", 45));

       }