> Struts2中文手册 > Struts2 值栈/OGNL

值栈是一组对象,按照提供的顺序存储以下这些对象:

序号 对象和说明
1 Temporary对象

实际中存在各种在页面执行期间创建的temporary对象。例如,jsp标签循环集合的当前迭代值。

2 Model对象

如果在struts应用程序中使用Model对象,则当前Model对象放在值堆栈上的action之前。

3 Action对象

这是指正在执行的当前action对象。

4 命名对象

这些对象包括#application,#session,#request,#attr和#parameters以及所引用的相应的servlet作用域。

值栈可以通过为JSP,Velocity或Freemarker提供的标签进行访问。我们将在单独的章节中学习到用于获取和设置struts2 值栈的各种标签。你可以在action中获取值栈对象,如下所示:

ActionContext.getContext().getValueStack()

一旦你有一个值栈对象,你可以使用以下方法来操纵该对象:

序号 值栈方法和说明
1 Object findValue(String expr)

通过在默认搜索顺序中对值栈评估所给定的表达式来查找值。

2 CompoundRoot getRoot()

获取将对象推入值栈的CompoundRoot。

3 Object peek()

获取值栈顶部的对象而不改变值栈。

4 Object pop()

获取值栈顶部的对象,并将其从值栈中删除。

5 void push(Object o)

将对象放在值栈的顶部。

6 void set(String key,Object o)

使用给定的key在值栈上设置一个对象,使其可通过findValue(key,...)检索。

7 void setDefaultType(Class defaultType)

设置在获取值时要转换的默认类型。

8 void setValue(String expr,Object value)

尝试使用由默认搜索顺序给定的表达式在值栈的bean上设置属性。

9 int size()

获取值栈中的对象数。

OGNL

OGNL(Object-Graph Navigation Language,对象图导航语言)是一种强大的表达式语言,用于引用和操作值栈上的数据,还可用于数据传输和类型转换。
OGNL非常类似于JSP表达式语言。OGNL基于上下文中存有根对象或默认对象的理念,使用标记符号(即#号)来引用默认或根对象的属性。
如前面所述,OGNL是基于上下文的,而Struts构建了一个ActionContext映射以供OGNL使用。 ActionContext映射包含以下内容:

  • 应用程序 - 应用程序作用域变量

  • 会话 - 会话作用域变量

  • 根/值栈 - 所有的action变量都存储在这里

  • 请求 - 请求作用域变量

  • 参数 - 请求参数

  • 属性 - 存储在页面,请求,会话和应用程序作用域中的属性

有必要了解的是,Action对象在值栈中总是可用的,因此如果你的Action对象有x和y属性,你可以随时使用。
ActionContext中的对象使用#号引用,但是,值栈中的对象可以直接引用,例如,如果employee是action类的属性,则可以按如下方式引用:

  <s:property value="name"/>

替代

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

如果你在会话中有一个名为“login”的属性,你可以按如下方式检索:

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

OGNL还支持处理集合 - 即Map,List和Set。例如,要显示颜色的下拉列表,你可以执行以下操作:

  <s:select name="color" list="{'red','yellow','green'}" />

OGNL表达式很智能地将“红色”,“黄色”,“绿色”解释为颜色,并基于此构建了列表。
在下一章我们学习各种的标签时,OGNL表达式将会广泛的用到。因此,不要用孤立的方式去了解OGNL,让我们结合Form标签/Control标签/Data标签和Ajax标签部分中的一些示例来了解它。

值栈/ OGNL示例

创建Action:

让我们参考下面用于访问值栈的action类,然后在ie.JSP视图页面设置使用OGNL进行访问的几个key。

package cn.w3cschool.struts2;

import java.util.*; 

import com.opensymphony.xwork2.util.ValueStack;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.ActionSupport;

public class HelloWorldAction extends ActionSupport{
   private String name;

   public String execute() throws Exception {
      ValueStack stack = ActionContext.getContext().getValueStack();
      Map<String, Object> context = new HashMap<String, Object>();

      context.put("key1", new String("This is key1")); 
      context.put("key2", new String("This is key2"));
      stack.push(context);

      System.out.println("Size of the valueStack: " + stack.size());
      return "success";
   }  

   public String getName() {
      return name;
   }

   public void setName(String name) {
      this.name = name;
   }
}

实际上,Struts 2在执行时会将action添加到值栈的顶部。所以,通常放置东西在值栈的方法是添加getters/setters的值到Action类,然后使用<s:property>标签访问值。我们前面已展示了ActionContext和值栈在struts中的工作原理。

创建视图

在你的eclipse项目的WebContent文件夹中创建下面的jsp文件HelloWorld.jsp,如果action返回为success将显示视图:

<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<html>
<head>
<title>Hello World</title>
</head>
<body>
   Entered value : <s:property value="name"/><br/>
   Value of key 1 : <s:property value="key1" /><br/>
   Value of key 2 : <s:property value="key2" /> <br/>
</body>
</html>

我们还需要在WebContent文件夹中创建index.jsp文件,其内容如下:

<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
   pageEncoding="ISO-8859-1"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"Http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Hello World</title>
</head>
<body>
   <h1>Hello World From Struts2</h1>
   <form action="hello">
      <label for="name">Please enter your name</label><br/>
      <input type="text" name="name"/>
      <input type="submit" value="Say Hello"/>
   </form>
</body>
</html>

配置文件

以下是struts.xml文件的内容:

 
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>
   <constAnt name="struts.devMode" value="true" />
   <package name="helloworld" extends="struts-default">

      <action name="hello" 
         class="cn.w3cschool.struts2.HelloWorldAction" 
         method="execute">
         <result name="success">/HelloWorld.jsp</result>
      </action>

   </package>
</struts>

以下是web.xml文件的内容:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns="http://java.sun.com/xml/ns/javaee" 
   xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
   xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
   http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
   id="WebApp_ID" version="3.0">
   
   <display-name>Struts 2</display-name>
   <welcome-file-list>
      <welcome-file>index.jsp</welcome-file>
   </welcome-file-list>
   <filter>
      <filter-name>struts2</filter-name>
      <filter-class>
         org.apache.struts2.dispatcher.FilterDispatcher
      </filter-class>
   </filter>

   <filter-mapping>
      <filter-name>struts2</filter-name>
      <url-pattern>/*</url-pattern>
   </filter-mapping>
</web-app>

右键单击项目名称,然后单击“Export”>“WAR File”创建WAR文件。然后在Tomcat的webapps目录中部署WAR文件。最后,启动Tomcat服务器并尝试访问URL http://localhost:8080/HelloWorldStruts2/index.jsp。将显示如下界面:

Struts2 值栈/OGNL

现在,在给定的文本框中输入任意单词,然后单击“Say Hello”按钮执行定义的action。如果你查看生成的日志,可以在底部看到以下文本:

 
Size of the valueStack: 3

这意味着它将显示你输入的任何值和我们放在值栈上的key1和key2的值。