struts2（2.0.9）（学习一）HelloWorld篇

井底之蛙 — Mon, 20 Aug 2007 01:23:00 GMT

本文参考struts-2.0.9-all\struts-2.0.9\docs\docs\hello-world.html，并根据笔者在学习过程中的实践增加了部分内容。

当你提交一个HTML表单到这个框架中的时候，输入并不是被发送到服务页，而是被发送到你提供的Java类，这些类被称为Action。在这些Action执行完后，选择某一个资源来呈现返回结果，这个资源一般是页面，但也可以是PDF文件，或者是Excel文件，亦或是Java applet窗口。

假设你想要创建一个“Hello World”的例子来呈现欢迎信息，在你准备好开发环境后，为了创建一个“Hello World”的例子，你需要做如下三件事情：

1. 创建一个jsp页面来呈现欢迎信息；

2. 创建一个Action类来创建信息；

3. 在配置文件中配置action和页面的映射关系。

注意：为了创建这个组件，我们将工作流分成几乎无人不晓的三部分：视图、模型和控制器。分离这三部分的原因是当系统变得越来月复杂的时候，我们能够更好的管理。

一． 准备工作

建立web工程，其中工程名为tutorial，在WebRoot下引入struts2的lib下的如下4个包：

commons-logging-1.1.jar

freemarker-2.3.8.jar

ognl-2.6.11.jar

struts2-core-2.0.9.jar

xwork-2.0.3.jar

在web.xml文件中增加struts2的FilterDispatcher，修改后的web.xml如下：

xml version="1.0" encoding="UTF-8"?>

<web-app id="WebApp_9" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
    <display-name>tutorialdisplay-name>
    <filter>
        <filter-name>struts2filter-name>
        <filter-class>org.apache.struts2.dispatcher.FilterDispatcherfilter-class>
    filter>

    <filter-mapping>
        <filter-name>struts2filter-name>
        <url-pattern>/*url-pattern>
    filter-mapping>

    <welcome-file-list>
        <welcome-file>index.htmlwelcome-file>
    welcome-file-list>
web-app>

二．代码

首先，我们需要一个jsp页面来呈现信息，HelloWorld.jsp页面代码如下所示：

<%@ taglib prefix="s" uri="/struts-tags" %>
<html>
    <head>
        <title>Hello World!title>
    head>
    <body>
        <h2><s:property value="message" />h2>
    body>
html>

接着，我们需要一个Action类来创建信息，代码如下：

package tutorial;
import com.opensymphony.xwork2.ActionSupport;
public class HelloWorld extends ActionSupport {
    public static final String MESSAGE = "Struts is up and running ";
    public String execute() throws Exception {
        setMessage(MESSAGE);
        return SUCCESS;
    }
    private String message;
    public void setMessage(String message){
        this.message = message;
    }
    public String getMessage() {
        return message;
    }
}

第三步，我们需要在配置文件中进行相应配置来将两者联系起来。让我们编辑src下的struts.xml文件，该文件内容如下：

DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
    <package name="tutorial" extends="struts-default">
        <action name="HelloWorld" class="tutorial.HelloWorld">
            <result>/HelloWorld.jspresult>
        action>

    package>
struts>

代码已经完成，让我们来尝试运行它。部署该应用程序并打开http://localhost:8080/tutorial/HelloWorld.action，我们可以看到标题栏为：Hello World，并且显示“Struts is up and running!”的页面呈现在我们面前。

三． 代码是如何工作的？

你的浏览器向Web服务器发送了的http://localhost:8080/tutorial/HelloWorld.action（注：tutorial为部署在Tomcat中的的项目名称）的URL请求后，服务器做了如下工作：

1. 容器接收到了Web服务器对资源HelloWorld.action的请求，根据web.xml中的配置，服务器将包含有.action后缀的请求转到org.apache.struts2.dispatcher.FilterDispatcher类进行处理。这个FilterDispatcher是框架的一个进入点；

2. 框架在struts.xml配置文件中找到名为HelloWorld的action对应的类。框架初始化该Action并且执行该Action类的execute方法；

3. execute方法将信息放入message变量中，并返回成功。框架检查配置以查看当返回成功时对应的页面。框架告诉容器来获得请求返回的结果页面HelloWorld.jsp;

4. 在HelloWorld.jsp执行完后，标签调用HelloWorld的Action类中的getMessage方法来获得message的值，并将合并了值的页面呈现给用户；

5. 一个纯粹的HTML页面显示在用户的浏览器上。

四． 测试Action

测试Action很简单，以下是上述HelloWorld的Action类的测试类的代码：

package tutorial;
import junit.framework.TestCase;
import com.opensymphony.xwork2.Action;
import com.opensymphony.xwork2.ActionSupport;
public class HelloWorldTest extends TestCase {
public void testHelloWorld() throws Exception {
    HelloWorld hello_world = new HelloWorld();
    String result = hello_world.execute();
    assertTrue("Expected a success result!",
      ActionSupport.SUCCESS.equals(result));
    assertTrue("Expected the default message!",
      HelloWorld.MESSAGE.equals(hello_world.getMessage()));
    }
}

五． 需要记住的东西

本框架利用Action来处理HTML的表单以及其余请求。Action返回一个结果的名字字符串，例如SUCCESS、ERROR以及INPUT等，从struts.xml中获取映射信息。一个给定的结果字符串将选择一个页面或其他资源（图片或PDF）来返回给用户。

当一个jsp被载入的时候，通常有一些动态变化的元素需要Action来载入。为了更加容易的显示动态数据，本框架提供了一些可以跟HTML配合使用的标签。

六． 问题汇总

对于出现启动失败，例如Cannot locate the chosen ObjectFactory implementation: spring等错误的朋友，请仔细检查你引入的包。关于需引入的包，请参见第一节（准备工作）。也希望遇到其余问题的朋友留言或发Email给我，在此进行汇总。

井底之蛙 2007-08-20 09:23 发表评论

语源科技BlogJava-没有做不到，只有想不到

struts2（2.0.9）（学习一）HelloWorld篇