第一章　搭建Struts2开发环境

Struts2概述

在Struts的官方网站上，写着下面两段话：

Apache Struts 2 is an elegant, extensible framework for creating

enterprise-ready Java web applications. The framework is designed to streamline

the full development cycle, from building, to deploying, to maintaining

applications over time.

Apache Struts 2 was originally known as WebWork 2. After working

independently for several years, the WebWork and Struts communities joined

forces to create Struts2. This new version of Struts is simpler to use and

closer to how Struts was always meant to be.

其大意为：Apache Struts2是一个为企业级应用打造的优秀的、可扩展的WEB框架，该框架旨在充分精简应用程序的开发周期，从而减少创建、发布直到应用所花费的时间。

Apache Struts2原本就是举世闻名的Webwork2，在各自经历几年的发展之后，Struts和WebWork社区决定合二为一，也就是今天的Struts2。

Struts是一个基于Model2的MVC框架，为应用程序的WEB层提供了良好的结构严谨的实现。Struts发展较早，早期的Struts1.X已被很多J2EE程序员熟悉，经过多年来的发展，这支队伍变得越来越大，很多企业级应用程序都是基于Struts开发的。

Struts2与Struts1.X已经不能再放到一起比较，虽然都是对MVC架构模式的实现，本质却完全不同。Struts2的前身是WebWork，其实现方式和功能都要优于Struts1.X,但是，Struts先入为主，很多应用程序都基于Struts，其生命力和普及度使得WebWork落于下风。随着新思想和新架构的不断涌入，特别是WEB2.0被大量提及，Struts1.x显然无法跟上日新月异的变化，在很多应用上显得力不从心，最终催生了Struts2.0。可以说Struts2.0是为变而变。

很大程度上，Struts2.0无法避开投机取巧的嫌疑。不过，借助Struts的名声，加上WebWork构建良好的框架，二者取长补短，确实不失为一种黄金组合和一种绝佳的宣传方式。

笔者杜撰此文时，可以下载到的最新版本为2.1.0，但他的魅力已初露尖角，应该会有很好的前途。

Struts2的新特征

如果读者熟悉Struts1.X，会发现Struts2比Struts1.X有了巨大的变化：

Action类:

• Struts1要求Action类继承一个抽象基类。Struts1的一个普遍问题是使用抽象类编程而不是接口。

• Struts 2 Action类可以实现一个Action接口，也可实现其他接口，使可选和定制的服务成为可能。Struts2提供一个ActionSupport基类去实现常用的接口。Action接口不是必须的，任何有execute标识的POJO对象都可以用作Struts2的Action对象。

线程模式:

• Struts1 Action是单例模式并且必须是线程安全的，因为仅有Action的一个实例来处理所有的请求。单例策略限制了Struts1 Action能作的事，并且要在开发时特别小心。Action资源必须是线程安全的或同步的。

• Struts2 Action对象为每一个请求产生一个实例，因此没有线程安全问题。(实际上，servlet容器给每个请求产生许多可丢弃的对象，并且不会导致性能和垃圾回收问题)

Servlet依赖:

• Struts1 Action 依赖于Servlet API ,因为当一个Action被调用时HttpServletRequest和HttpServletResponse被传递给execute方法。

• Struts 2 Action不依赖于容器，允许Action脱离容器单独被测试。如果需要，Struts2 Action仍然可以访问初始的request和response。但是，其他的元素减少或者消除了直接访问HttpServetRequest 和 HttpServletResponse的必要性。

可测性:

•

测试Struts1 Action的一个主要问题是execute方法暴露了servlet API(这使得测试要依赖于容器)。一个第三方扩展－－Struts

TestCase－－提供了一套Struts1的模拟对象(来进行测试)。

• Struts 2 Action可以通过初始化、设置属性、调用方法来测试，“依赖注入”支持也使测试更容易。

捕获输入:

• Struts1 使用ActionForm对象捕获输入。所有的ActionForm必须继承一个基类。因为其他JavaBean不能用作ActionForm，开发者经常创建多余的类捕获输入。动态Bean(DynaBeans)可以作为创建传统ActionForm的选择，但是，开发者可能是在重新描述(创建)已经存在的JavaBean(仍然会导致有冗余的javabean)。

• Struts 2直接使用Action属性作为输入属性，消除了对第二个输入对象的需求。输入属性可能是有自己(子)属性的rich对象类型。Action属性能够通过web页面上的taglibs访问。Struts2也支持ActionForm模式。rich对象类型，包括业务对象，能够用作输入/输出对象。这种ModelDriven 特性简化了taglib对POJO输入对象的引用。

表达式语言：

• Struts1 整合了JSTL，因此使用JSTL EL。这种EL有基本对象图遍历，但是对集合和索引属性的支持很弱。

• Struts2可以使用JSTL，但是也支持一个更强大和灵活的表达式语言－－"Object Graph Notation Language" (OGNL).

绑定值到页面(view):

• Struts 1使用标准JSP机制把对象绑定到页面中来访问。

• Struts 2 使用 "ValueStack"技术，使taglib能够访问值而不需要把你的页面(view)和对象绑定起来。ValueStack策略允许通过一系列名称相同但类型不同的属性重用页面(view)。

类型转换：

• Struts 1 ActionForm 属性通常都是String类型。Struts1使用Commons-Beanutils进行类型转换。每个类一个转换器，对每一个实例来说是不可配置的。

• Struts2 使用OGNL进行类型转换。提供基本和常用对象的转换器。

校验：

• Struts 1支持在ActionForm的validate方法中手动校验，或者通过Commons Validator的扩展来校验。同一个类可以有不同的校验内容，但不能校验子对象。

• Struts2支持通过validate方法和XWork校验框架来进行校验。XWork校验框架使用为属性类类型定义的校验和内容校验，来支持chain校验子属性

Action执行的控制：

• Struts1支持每一个模块有单独的Request Processors(生命周期)，但是模块中的所有Action必须共享相同的生命周期。

• Struts2支持通过拦截器堆栈(Interceptor Stacks)为每一个Action创建不同的生命周期。堆栈能够根据需要和不同的Action一起使用。

注：以上资料从网上搜集，来源：Struts开发组，翻译：tianxinet(胖猴)。

Struts2的环境要求

Apache

Struts2的环境需求如下：

Servlet API 2.4

JSP API 2.0

Java 5

需要提醒的是，在Struts中会用到Annotation，所以请将JDK版本升级到1.5.

Struts2环境搭建

4.1Struts的下载

从游览器输入http://people.apache.org/builds/struts/，即可看到Struts的各个版本列表。从下图中可以发现，现在Struts2.0的最新版是2.1.0,发布于2007年10月29。

(图1)

(图2)

从图2中可以看出，即可以分开下载，又可以一次全部下载。全部下载的大小为83M,

下表注明了各个压缩包的作用。

压缩包名称

作用

struts-2.1.0-docs.zip

文档，包含了Struts2API

struts-2.1.0-lib.zip

构建Struts2工程所需要的包

struts-2.1.0-src.zip

Struts2的所有源代码

struts2-blank-2.1.0.war

空白工程

struts-2.1.0-all.zip

大集成，包括上面所有的内容

4.2开发工具介绍

目前J2EE开发工具主要分为Eclipse和NetBeans两大阵营，Eclipse的最高版本为3.3,NetBeans的最高版本为6.0.今天刚刚从新闻上看到，NetBeans6.0的英文正式版正式发布了，真是可喜可贺。

笔者在开发时以Eclipse为主，但Eclipse并不支持WEB开发，需要安装相应插件。MyEclipse是一个功能强大且框架支持非常广泛的WEB开发插件，该产品是收费项目。目前MyEclipse的最高版本为6.0,即便如此，尚不支持Struts2.0,我们只能手工配置Struts2.0的开发环境。

4.3库文件

从网站上下载的Struts2包含了二三十个库文件，但大多数是可选的，有些库是插件，用于和其他框架的整合。

读者可自行下载struts2-blank-2.1.0.war压缩包，展开后是一个非常简单的项目，从WEB-INF/lib目录中可以看到5个库文件，解释如下：

包名

说明

commons-logging-1.0.4.jar

日志管理

freemarker-2.3.8.jar

表现层框架，定义了struts2的可视组件主题(theme)

ognl-2.6.11.jar

OGNL表达式语言，struts2支持该EL

struts2-core-2.0.10.jar

struts2的核心库

xwork-2.0.4.jar

webwork的核心库，自然需要它的支持

(图3)

4.3使用Eclipse搭建Struts2的开发环境

4.3.1创建用户库

将Struts2所需的包建成用户库，可以更加方便地进行管理和使用，这是一个好的习惯——编程从习惯开始。

1.选择菜单Window->Preferences->Java->Build

Path->User Libraries。如图4：

(图4)

2.点击右侧的New…按钮，创建一个新的用户库，弹出如图5所示对话框：

(图5)

3.输入用户库的名称，如：Struts2，点击OK按钮，该对话框自动关闭。结果如图6所示：

(图6)

此时，右侧的按钮被点亮。

4.点击“Add JARS…”按钮，添加用户库所需的库文件，在Struts2中，至少要包含上文中提到的5个库文件。添加后效果如图7所示：

(图7)

5.点击“OK”完成。

4.3.2开发第一个Struts2应用程序——世界，你好

开发WEB应用程序，本文使用了MyEclipse插件。该插件为收费软件，目前提供英文版和日文版，不同的版本可以运行在Windows、Linux等操作系统上。为了方便用户，MyEclipse有一个Full版，连同Eclipse一起安装，对于初学者而言，可以减少很多麻烦和困扰。

读者可自行去http://www.myeclipseide.com/网站下载该软件的共享版本。建议读者下载MyEclipse5.5(这也是笔者使用的版本)，这个版本相对比较稳定，MyEclipse6.0还处于测试之中。

入门教程总是以HelloWorld作为学习的第一步，自然笔者也不例外。本示例从游览器输入网址，提交请求后在页面中显示“世界，你好”的信息。

1.新建WEB工程，如图8所示：

(图8)

2.点击“Next”，输入工程名，如图9所示：

(图9)

3.点击“Finish”完成。

4.现在将Struts2的库导入到工程中，右击工程名称弹出快捷菜单，选择Build

Path->Add Libraries…，如图10所示。

(图10)

5.从弹出的对话框中选择“User Libraries”，如图11所示。

(图11)

6.单击下一步，我们看到，上文中创建的用户库出现在列表中，在“Struts2”前的复选框上打勾，点击“Finish”完成。如图12。

(图12)

7.将Struts2所带的过滤器org.apache.struts2.dispatcher.FilterDispatcher配置到工程的web.xml文件中，默认情况下，该过滤器拦截请求字符串中以.action结尾的请求，并将该请求委托给指定的Action进行处理。最直观的表现就是调用Action的execute()方法。代码如下：

代码清单1：web.xml

struts2

org.apache.struts2.dispatcher.FilterDispatcher

struts2

/*

注：在Sturts1.X中，该行为由Servlet完成。

8.创建包com.lizanhong.action，并在该包中创建HelloWorldAction类，该类继承自com.opensymphony.xwork2.ActionSupport。理论上，Action可以不继承任何类或实现任何接口，以增强程序的可测试性，这也是和Struts1.X不同的地方。但是，继承自ActionSupport可以减少更多的编码工作。

在ActionSupport中，定义了方法execute()，当用户向该Action发送请求时，会自动调用。程序代码如下：

代码清单2：HelloWorldAction.java

packagecom.lizanhong.action;

importcom.opensymphony.xwork2.ActionSupport;

publicclassHelloWorldActionextendsActionSupport {

@Override

publicString execute()throwsException {

System.out.println("Action执行了。");

returnSUCCESS;

}

}

注：ActionSupport是Struts2提供的类，功能类似于Struts1.x中的Action类，该类封装了几个有用的功能，比如：

getText()：从资源文件中获取国际化消息。

addFieldError()：验证输入未通过时添加错误消息，支持国际化。

execute()：该方法一般会被重写，当客户端向Action发送请求时，会调用此方法。

总结起来，该类主要提供了错误消息的支持和国际化支持。

在工程类路径下创建struts.xml文件，这是Struts2的配置文件，类似于Struts1.x中的struts-config.xml，在struts.xml文件中可以配置Action、Bean、Interceptor等组件。

代码清单3：struts.xml

-//Apache Software Foundation//DTD

Struts Configuration 2.0//EN""http://struts.apache.org/dtds/struts-2.0.dtd">

/result.jsp

注：WEB应用程序的类路径是指WEB-INF/classes目录，在Eclipse中，创建在src目录下的文件最终发布后会自动复制到WEB-INF/classes目录下。

代码清单3中涉及到很多标签，以下是简单的解释：

标签名称

说明

include

包含其他xml文件，在示例中，这意味着struts.xml可以访问定义在struts-default.xml文件中的组件。

该元素可以使得Struts2定义多个配置文件，“分而治之”。

要注意的是，任何一个struts2配置文件都应该和struts.xml有相同的格式，包括doctype，并且可以放在类路径下的任何地方。

package

为Action或截拦器分组。

name：名称，必填项，名称自定义，没特别要求。方便别的package引用。

extends：package能继承其他的package，即通过该属性实现，值为另一个package的name。

在示例中，extends

=”struts-default”是从struts-default.xml中继承的。

action

定义Action，name属性为访问时用到的名称，class属性是Action的类名。

result

根据Action的返回值定义页面导航。

Action的预定义的返回值有：

String SUCCESS = "success";

String NONE    = "none";

String ERROR   = "error";

String INPUT   = "input";

String LOGIN   = "login";

比如，当Action返回SUCCESS时希望转到ok.jsp页面，则可以这样写：

ok.jsp

其中，name的缺省为success。

9.result.jsp是一个非常简单的jsp页面，输出“世界，你好”。

代码清单4：result.jsp

String path =

request.getContextPath();

String basePath =

request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";

%>

-//W3C//DTD

HTML 4.01 Transitional//EN">

">

My JSP

'result.jsp' starting page

page">

世界，你好.

10.在浏览器的结果如下图13：

(图13)

struts.xml的定义文件

代码清单5：struts-2.0.dtd

default-action-ref?,

global-results?,

global-exception-mappings?, action*)>

name CDATA

#REQUIRED

extends CDATA

#IMPLIED

namespace CDATA

#IMPLIED

abstract CDATA

#IMPLIED

externalReferenceResolver NMTOKEN #IMPLIED

>

name CDATA

#REQUIRED

class CDATA

#REQUIRED

default (true|false) "false"

>

name CDATA

#REQUIRED

class CDATA

#REQUIRED

>

name CDATA

#REQUIRED

>

name CDATA

#REQUIRED

>

(param*)>

name CDATA

#REQUIRED

>

name CDATA

#REQUIRED

>

(exception-mapping+)>

name CDATA

#REQUIRED

class CDATA

#IMPLIED

method CDATA

#IMPLIED

converter CDATA

#IMPLIED

>

name CDATA

#REQUIRED

>

name CDATA

#IMPLIED

type CDATA

#IMPLIED

>

name CDATA

#IMPLIED

exception CDATA

#REQUIRED

result CDATA

#REQUIRED

>

file CDATA

#REQUIRED

>

type CDATA

#IMPLIED

name CDATA

#IMPLIED

class CDATA

#REQUIRED

scope CDATA

#IMPLIED

static CDATA

#IMPLIED

optional CDATA

#IMPLIED

>

name CDATA

#REQUIRED

value CDATA

#REQUIRED

>

总结

Struts是一个时下非常流行并被许多企业级应用程序采用的WEB框架，Struts2在Struts1.x的基础上进行了大量改造，和WebWork合二为一，引进了更多的新观念、新思想和新技术，使之更符合J2EE应用程序开发的需要。

“工欲善其事，必先利其器”，掌握一两种开发工具，能够大大提高编程效率，也能增强开发者的信心。学习一门新技术时，第一个应用程序非常重要，如果第一个最简单的程序运行不成功，会使得学习者的积极性大打折扣，这也是笔者不愿意看到的。所以，本章图文并茂地详细介绍了Struts2应用程序的开发过程，并尽可能少的提及陌生的概念和术语。