一个完整的struts 2 Hello World程序(5)

2.2  一个简单的HelloWorld

上节介绍了搭建开发Struts 2应用所需要的环境的配置，本节将以一个简单的HelloWorld示例来介绍Struts 2给读者带来的体验。

为了使读者能够更清楚地了解示例的编写过程，示例将采用文本编辑器的方式来开发，这样避免了IDE集成编辑器给读者带来的困扰。开发一个Web应用，要建立符合规范的目录结构，上节中已经对Web应用目录进行了详细的介绍，为了开发HelloWorld应用，读者应该先建立一个目录。笔者建立的顺序如下：

 在E盘中建立一个文件夹：E:/myweb。

 在此文件夹中建立WEB-INF文件夹。

 建立E:/myweb/WEB-INF/classes文件夹。

 建立E:/myweb/WEB-INF/lib文件夹。

 将Tomcat默认的web.xml文件拷贝到E:/myweb/WEB-INF/目录下，web.xml文件在Tomcat安装目录中的webapps/ROOT/WEB-INF目录下。

 使用文本编辑器建立一个struts.xml文件，保存到E:/myweb/WEB-INF/classes目录下。

2.2.1  配置web.xml文件

完成上述步骤后，一个简单的Web目录就完工了，接下来需要修改web.xml文件和struts.xml文件。web.xml文件内容如代码2.4所示。

代码2.4  HelloWorld示例的web.xml

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

<web-app id="WebApp_ID" 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">

    <filter>

        <!— 配置filter-- >

        <filter-name>struts2</filter-name>

        <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>

    </filter>

    <filter-mapping>

            <!—拦截所有URL用户请求

        <filter-name>struts2</filter-name>

        <url-pattern>/*</url-pattern>

    </filter-mapping>

    <!—配置欢迎界面文件-- >

<welcome-file-list>

        <welcome-file>index.html</welcome-file>

        <welcome-file>index.htm</welcome-file>

        <welcome-file>index.jsp</welcome-file>

        <welcome-file>default.html</welcome-file>

        <welcome-file>default.htm</welcome-file>

        <welcome-file>default.jsp</welcome-file>

    </welcome-file-list>

</web-app>

 

在代码2.4所示内容中，相比原来的内容，增加了<filter>和<filter-mapping>。<filter>指定了需要加载的Struts 2核心控制器org.apache.struts2.dispatcher.FilterDispatcher，而<filter-mapping>使用通配符“/*”来拦截所有的URL请求，保证了用户请求都被Struts 2接收处理。

2.2.2  配置struts.xml文件

编辑struts.xml文件内容，如代码2.5所示。

代码2.5  HelloWorld示例的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">

<!—配置struts2-->

<struts>

    <!-- 配置包，名称为bookcode  -->

    <package name="bookcode" extends='struts-default'>

    <!-- 配置Action  -->

    <action name="HelloWorld" class="ch2.helloworld.HelloWorld">

            <!-- 配置返回结果  -->

            <result name="success">/ch2/helloworld/success.jsp</result>

            <result name="error">/ch2/helloworld/error.jsp</result>

        </action>

    </package>

 

</struts>

 

在默认情况下，Struts 2将会自动加载位于WEB-INF/classes目录下的struts.xml配置文件。<package>定义了一个包空间，可以看到，该文件中只配置了一个Action，name为“HelloWorld”，对应的class为“ch2.HelloWorld”，也就是指定WEB-INF/classes/ch2目录下的HelloWorld.class类文件，当然现在还没有这个文件，后面将会编写该文件。

★ 说明 ★

bookcode是本书示例的包名称，该包继承Struts 2框架的默认包struts-default，读者在后面章节将会学习使用extends属性。

 

另外一个配置就是result，即Action处理后返回给用户的视图资源，从配置中可以看到配置了两个result：success和error，分别对应E:/myweb/ch2目录下的success.jsp和error.jsp，后面也将会建立这两个文件。

本节介绍的HelloWorld的思路是用户在客户端输入一个字符串，由Action判断输入的字符串是否为空，如果不为空，则返回给用户success.jsp页面，并在控制台打印出该字符串；如果用户输入为空，则返回error.jsp页面给用户，提示输入为空。这个流程可以用图2.16来说明。用户输入字符串，发送请求给Struts 2框架的核心控制器FilterDispatcher，FilterDispatcher根据配置，将请求转发给Action，Action是业务控制器，来判断用户输入的内容进行相应的操作。

图2.16  HelloWorld的流程图

2.2.3  Action业务控制器

如图2.16所示，HelloWorld应用中的Action是业务控制器。通过第1章对Struts 2的简单介绍，读者应该知道，Struts 2的Action可以是一个普通的Java类（POJO），与Struts 1有很大的不同，这里的HelloWorld内容如代码2.6所示。

代码2.6  业务控制器HelloWord

package ch2.helloworld;

public class HelloWorld ...{

    //定义msg属性

    private String msg;

    //msg的get方法

    public String getMsg() ...{

        return msg;

    }

    //msg的set方法

    public void setMsg(String msg) ...{

        this.msg = msg;

    }

    //Action的execute()处理方法

    public String execute() ...{

        //判断条件

        if (getMsg().equals("")) ...{

            //显示错误信息

            System.out.println("no String input!");

            //返回错误结果

            return "error";

        } else ...{

            //显示用户输入的信息

            System.out.println(getMsg());

            //返回一个处理成功结果

            return "success";

        }

    }

}

 

（1）如代码2.6所示，HelloWorld没有继承任何类，也没有实现任何接口，是一个标准的Java类。定义了一个msg属性，对应用户输入的字符串，并提供了msg的get()、set()方法。execute()方法是实现业务控制器的默认方法，该方法只是返回一个String，并没有特别之处。

（2）在execute()方法中，对msg内容进行判断，如果非空，则在控制台打印该字符串，并返回一个“success”字符串，对应代码2.5中的success.jsp页面。

（3）如果msg为空，则在控制台输出一条警告，并返回“error”，对应error.jsp页面。读者会发现，Struts 2中的Action变得简单易懂，很容易对其进行测试。

★ 说明 ★

Struts 2的业务控制器Action是一个普通的Java类。

 

2.2.4  视图资源

到这里为止，该示例只缺少success.jsp、error.jsp和一个用户输入界面HelloWorld.jsp，读者可以使用文本编辑器建立，也可以使用各种网页编辑器来制作，以提高效率。

（1）HelloWorld.jsp内容如代码2.7所示。

代码2.7  输入界面HelloWorld.jsp

<%...@ page contentType="text/html; charset=gb2312" language="java" import="java.sql.*" errorPage="" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=gb2312" />

<title>Hello World!!</title>

</head>

<body>

    <!—form的action指向定义的action名称 -->

<form id="form1" name="form1" method="post" action="HelloWorld.action">

  <p>输入信息：

    <label>

    <input name="msg" type="text" id="username" />

    </label>

  </p>

   <p>

    <label>

    <input type="submit" name="Submit" value="提交" />

    </label>

  </p>

 </form>

</body>

</html>

 

在代码2.7所示内容中，form的action指向“HelloWorld”，提交一个name为msg的字符串，这是一个普通的JSP文件。

（2）success.jsp内容如代码2.8所示。

代码2.8  输出界面success.jsp

<%...@ page language="java" contentType="text/html; charset=gb2312"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

<title>返回界面</title>

</head>

<body>

HelloWorld,Struts 2!

</body>

</html>

 

代码2.8所示内容很简单，只是输出“HelloWorld,Struts 2!”提示。

（3）error.jsp内容如代码2.9所示。

代码2.9  错误界面error.jsp

<%...@ page language="java" contentType="text/html; charset=gb2312"

    pageEncoding="gb2312"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">

<title>错误界面</title>

</head>

<body>

您没有输入内容！

</body>

</html>

 

error.jsp也只是提示录入错误信息。

★ 说明 ★

Struts 2框架支持多种结果类型，默认类型支持JSP。

 

2.2.5  运行HelloWorld

经过上述编写，第一个Struts 2应用已经完成，将E:/myweb文件夹复制到C:/Program Files/Apache Software Foundation/Tomcat 6.0/webapps目录下，启动Tomcat，准备运行程序。

 在浏览器中输入http://localhost:8080/bookcode/ch2/helloworld/HelloWorld.jsp，出现如图2.17所示界面。

 在文本框中输入“Hello World！”，单击“提交”按钮，出现如图2.18所示界面。Tomcat控制台会输出如下内容：

2007-11-21 21:19:56 com.opensymphony.xwork2.validator.ActionValidatorManagerFactory <clinit>

信息: Detected AnnotationActionValidatorManager, initializing it...

Hello World!

 如果用户没有输入内容，直接单击“提交”按钮，返回页面如图2.19所示。同时，Tomcat控制台输出如下内容：

no String input!

         

图2.17  HelloWorld.jsp页面           

              

图2.18  success.jsp页面

图2.19  error.jsp页面

成功运行这个示例，是了解Struts 2的良好开端，这是一个极其简单的示例，并没有完全展示Struts 2的所有特点，但给读者带来了一个感性了解Struts 2的体验。

★ 说明 ★

Struts 2框架默认URL后缀不再是Struts 1.X框架的*.do，而是*.action。

 

2.2.6  HelloWorld小结

初次完成一个Struts 2的Hello World示例，读者将会了解：

— web.xml中需要加入Struts 2的加载配置。

— 在struts.xml中定义Action，其中包含Action返回视图的定义。

— Struts 2的Action是一个简单的Java类，没有丝毫特别之处。

— Action的execute()方法只是返回一个String。