Struts 2 简明教程

Struts 2 - Value Stack/OGNL

The Value Stack

值堆栈是一组包含以下对象的对象，这些对象按照给定的顺序排列 −

Sr.No	Objects & Description
1	Temporary Objects 在页面执行期间创建了各种临时对象。例如，JSP 标记中反复循环集合的当前迭代值。
2	The Model Object 如果您在 struts 应用程序中使用模型对象，则当前模型对象将被放置在值堆栈上的操作之前。
3	The Action Object 这将是当前正在执行的操作对象。
4	Named Objects 这些对象包括 #application、#session、#request、#attr 和 #parameters，并且它们对应于相应的 Servlet 作用域。

可以通过为 JSP、Velocity 或 Freemarker 提供的标记访问值堆栈。我们将使用各种标记，在单独的章节中学习如何使用这些标记来获取和设置 struts 2.0 值堆栈。您可以按如下方式在操作中获取 ValueStack 对象 −

ActionContext.getContext().getValueStack()

一旦您获得 ValueStack 对象，就可以使用以下方法来操作该对象 −

Sr.No	ValueStack Methods & Description
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) 使用给定的键在堆栈上设置一个对象，以便可通过 findValue(key,…) 检索到该对象。
7	void setDefaultType(Class defaultType) 设置获取值时未提供类型的默认类型。
8	void setValue(String expr, Object value) 尝试使用默认搜索顺序，利用给定的表达式设置堆栈中某个 bean 的一个属性。
9	int size() 获取堆栈中的对象数。

The OGNL

Object-Graph Navigation Language （OGNL）是一种功能强大的表达式语言，用于引用和操作 ValueStack 上的数据。OGNL 还帮助进行数据传输和类型转换。

OGNL 非常类似于 JSP 表达式语言。OGNL 以在上下文中拥有 root 或默认对象的想法为基础。可以使用井号符号（即标记符号）来引用默认对象或 root 对象的属性。

如前所述，OGNL 基于上下文，而 Struts 会构建一个 ActionContext 映射以用于 OGNL。ActionContext 映射包含以下内容：

Application − 应用范围变量
Session − 会话范围变量
Root / value stack − 此处存储所有操作变量
Request − 请求范围变量
Parameters − Request parameters
Atributes − 存储在页面、请求、会话和应用范围中的属性

了解 Action 对象始终在值栈中可用非常重要。所以，如果您的 Action 对象具有属性 “x” 和 “y” ，您可以随时使用它们。

ActionContext 中的对象使用井号符号进行引用，但是，可以直接引用值栈中的对象。

例如，如果 employee 是一个操作类的属性，那么它可以按如下方式引用：

<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 表达式巧妙地将“red”、“yellow”、“green”解释为颜色，并基于此构建了一个列表。

在后续章节中研究不同标记时，OGNL 表达式将被广泛使用。因此，与其孤立地查看它们，不如让我们在表单标记/控制标记/数据标记和 Ajax 标记部分中使用一些示例来查看它们。

ValueStack/OGNL Example

Create Action

让我们考虑以下操作类，在该类中我们将访问 valueStack，然后设置一些键，我们将在我们的视图中使用 OGNL 来访问这些键，即 JSP 页面。

package com.tutorialspoint.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 时会将操作添加到 valueStack 的顶部。所以，将内容放入值栈的通常方式是为值添加到您的操作类添加 getter/setter，然后使用 <s:property> 标记来访问值。但是，我将向您展示 ActionContext 和 ValueStack 在 struts 中如何工作的。

Create Views

让我们在 eclipse 项目中的 WebContent 文件夹中创建以下 jsp 文件 HelloWorld.jsp 。如果执行返回成功，则该视图将被显示：

<%@ 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>

Configuration Files

以下为 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 = "com.tutorialspoint.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 文件。然后将此 WAR 部署到 Tomcat 的 webapps 目录中。

最后，启动 Tomcat 服务器并尝试访问 URL http://localhost:8080/HelloWorldStruts2/index.jsp 。这将生成以下屏幕

现在在给定的文本框中输入任何单词并点击“Say Hello”按钮以执行定义的操作。现在，如果你将检查引发的日志，你将会在底部找到以下文本 −

Size of the valueStack: 3

这将显示以下屏幕，该屏幕将显示你输入的任何值以及我们在 ValueStack 上放置的 key1 和 key2 的值。