最简单的Struts程序

[目标]

实现一个最简单的Struts程序。程序包括一个输入页和输出页，输入页。

对于学习程序设计，我们已习惯于从Hello程序开始，实践证明，这是一个最有效的入门方法。下面就着手设计我们的第一个Struts程序----Hello程序。Hello程序的目标是实现从一个输入JSP页面中的输入框输入一个“Hello”单词，在另一个输出JSP页面中显示“Hello”一词。根据Struts框架的要求，这个Hello程序将包含输入JSP文件、输出JSP文件、Action文件、FormAction文件及配置文件。也就是说，这个Hello程序是一个完整的Struts程序，它可直接在Tomact、Resin等服务器上运行。

[效果]

输入页面：

输出页面：

[背景知识]

以前使用servlet开发应用系统的人深深感受到在java代码中嵌入大量html代码是一件非常痛苦的事，于是sun推出了JSP，解决了java代码中嵌入html代码的问题。但是很快程序员们就知道，用JSP“在html代码中嵌入大量java代码”跟“在java代码中嵌入大量html代码”是一样的非常痛。JSP是这样，ASP也是这样。于是，Craig R. McClanahan借用MVC的思想，把Java web应用程序的java和html分离开放在不同的文件中，分成了三部分，也就是struts；后来，微软也学会了这种分离方法，但微软懒一些，只分成了两部分，也就是ASP.NET。

Struts (org.apache.struts)是一个开放源代码的Web应用框架，基于MVC设计模式，使用servlet和JSP API建立，可以用来构建复杂的Web应用。它允许我们分解一个应用程序的商业逻辑、控制逻辑和表现逻辑的代码，使它的重用性和维护性更好。Struts框架是Jakarta工程的一部分，由Apache软件基金会管理。Struts可以从http://jakarta.apache.org/ struts站点下载。

Struts框架提供以下服务。

作为MVC结构中的controller的servlet.

JSP里用于bean管理、HTML和JavaScript生成、模板处理和流程控制的JSP标签库。

用于国际化消息的框架。国际化你的Web应用，意味着你的Web应用在使用时可以让用户以喜爱的语言显示。这意味着你需要创建一个应用资源文件，包含每种语言的信息。

一个JDBC的实现来定义数据源和数据库连接池。

一个通用的的错误和异常处理机制，包括从一个应用程序资源文件读取错误信息。

XML语法分析。

文件上载工具。

注册机制。

一个基于Struts的应用程序的表示层(view)使用Struts标签库(taglibs)构建。来自客户的请求被传递给叫ActionServlet的servlet，它作为controller.使用了Struts的应用程序，所有需要通过框架的请求都通过ActionServlet传递。这个ActionServlet把数据从请求传递到ActionForm JavaBean。

ActionForm是代表从一个表单View组件输入数据的JavaBean。这些表单由JSP用Struts html标签库产生。这个beam由 ActionServlet生成，带request参数，它还请求ActionForm来验证用户提交数据的合法性。

ActionServlet通过定义一组ActionMapping来配置。一个ActionMapping是一个对象，它将请求中的URL映射到由应用程序开发者提供的处理请求的组件。ActionServlet和ActionMapping的配置在XML配置文件中完成。

专用的应用程序用于处理请求的组件叫Action类。在MVC结构中，它们代表模型。它们可能用于验证用户输入的合法性，假如在信息处理过程中出现了应用程序错误，Action类可以创建一个error对象的实例，然后保存庆HTTP request对象中。如果在Action类中的逻辑成功地被招待类给Controller传递一个ActionForward对象，代表所需的描绘响应的JSP。ActionForward有两种：专门转发给特定的Action类或全局转发(任何一个Action类可以把这些ActionForwards转给Controller)。

[步骤]

1、打开Visual Struts开发环境：

（1）把文件拷贝到本地硬盘的一个目录下，例如

F:\JavaWebStudio

(2) 运行BIN目录下的JavaWebStudio.exe文件(同时自动在桌面建立一个快捷方式，第二次启动时，只需点击桌面的快捷方式即可),出现如下启动界面：

另外，第一次运行JavaWebStudio，会提示是否要自动配置环境变量，建议选择自动配置。

2、建立一个“空的Struts普通模板”应用程序：

选择菜单“文件”—“新建”—“新建项目”，弹出新建项目对话框，如图3-1所示：

在对话框中选择“空的Struts普通用模板”，在项目名称中输入“Simple”，package (包名)和位置（项目的路径）采用默认的值就行，当然也可以根据需要改变。最后点击“确定”按钮完成新项目的建立。

从文件管理器中可看出Simple项目的文件结构如下：

Simple

+------config

+------lib

+------src

+------web

-------build.xml

-------hello.prj

在Simple项目根目录下包含四个子目录和两个文件，这是JSPStudio项目的标准结构，最好不要改变它们默认的名称，否则会出现问题。

3、利用Struts文件向导建立新的应用：

在JSPStudio文件管理器内点击鼠标右键，在弹出的菜单中选择“Struts文件向导”进入Struts文件向导对话框，也可以选择菜单“文件”—“新建”—“ Struts文件向导”进入Struts文件向导对话框。如图3-3所示：

在Struts文件向导对话框JSP文件标签下的文件名输入栏中输入“HellWord”文件名，其它文件采用默认的设置，点击“确定”按钮完成在Struts文件向导。

刷新JSPStudio文件管理器，这时发现web目录下自动生成了两个文件，分别是HellWord.jsp和HellWord.jsp，前者是输入JSP文件，后者是输出JSP文件；src\emptyprj目录下自动生成了两个文件，分别是HellWord Action.java和HellWord Form.java，前者是Action文件，后者FormAction文件。

4、编译、启动服务器：

点击工具条上的编译按钮或选择菜单“生成”—“编译”开始项目的编译。编译过程和结果在输出栏中显示出来，内容如下：

C:\Documents and Settings\Administrator\桌面>F:

F:\>cd F:\JavaWebStudio\JavaWebStudioWorkDir\Simple

F:\JavaWebStudio\JavaWebStudioWorkDir\Simple>ant -buildfile build.xml

Buildfile: build.xml

prepare:

[mkdir] Created dir: F:\JavaWebStudio\jakarta-tomcat-5.0.24\webapps\Simple

[copy] Copying 2 files to F:\JavaWebStudio\jakarta-tomcat-5.0.24\webapps\Simple

[mkdir] Created dir: F:\JavaWebStudio\jakarta-tomcat-5.0.24\webapps\Simple\WEB-INF

[copy] Copying 6 files to F:\JavaWebStudio\jakarta-tomcat-5.0.24\webapps\Simple\WEB-INF

[mkdir] Created dir: F:\JavaWebStudio\jakarta-tomcat-5.0.24\webapps\Simple\WEB-INF\classes

[copy] Copying 5 files to F:\JavaWebStudio\jakarta-tomcat-5.0.24\webapps\Simple\WEB-INF\classes

[mkdir] Created dir: F:\JavaWebStudio\jakarta-tomcat-5.0.24\webapps\Simple\WEB-INF\lib

[copy] Copying 18 files to F:\JavaWebStudio\jakarta-tomcat-5.0.24\webapps\Simple\WEB-INF\lib

[mkdir] Created dir: F:\JavaWebStudio\JavaWebStudioWorkDir\wars

compile:

[javac] Compiling 3 source files to

F:\JavaWebStudio\jakarta-tomcat-5.0.24\webapps\Simple\WEB-INF\classes

dist:

[jar] Building jar: F:\JavaWebStudio\JavaWebStudioWorkDir\wars\Simple.war

BUILD SUCCESSFUL

Total time: 5 seconds

上述输出表明利用ant 编译build.xml所设置的项目已成功。把编译结果拷贝到tomcat服务器webapps目录下，并生成打包文件Simple.war。

5、启动服务器：

点击工具条上的启动服务器按钮或选择菜单“运行”—“ 启动服务器”启动服务器jakarta-tomcat服务器。内容如下：

6、运行：

展开文件管理器Simple项目下web目录，可见到HelloWord.jap和HelloWordOut.jsp文件，通过双击打开HelloWord.jap文件，如图所示。编辑窗口分上下两部分，上部分是源程序编辑，下部分是可视化编辑，与Dreamweaver MX编辑窗口相似。

点击工具条上的运行按钮或选择菜单“运行”—“ 运行（web浏览）”这时打开显示出HelloWord.jsp的运行结果。在运行结果页面中的输入框中输入“Hello Word”，点击“提交”按钮，这时转发到HelloWordOut.jsp文件，HelloWordOut.jsp页面中输出“Hello Word”一词。

生成的源代码如下：

</head>

</form>

</body>

</html>

生成的源代码如下：

</head>

Hello Word

</body>

</html>

[项目文件结构]

config目录下包含了所有的配置文件和Struts标签的描述文件，例如web.xml、struts-config.xml、struts-bean.tld、struts-html.tld、struts-logic.tld和struts-template.tld等文件。

lib包含了Struts库文件和带用其它库文件，例如struts.jar、struts-legacy.jar、commons-lang.jar和xerces.jar等文件。

src目录下包含了java原文件和资源文件，例如ApplicationResources.properties和ApplicationResources_ch.properties资源文件，前者是英语资源文件，后者是中文资源文件。新建时这个目录里还有一个子目录“emptyprj”，这个名称与建立项目时输入的package名称是一至的。Emptyprj目录下有“filters”、“jdbc”两个子目录，前者是过滤器目录，是中文解决方案，详细分析请看后面的有关滤器程序设计、中文解决方案章节，后者是数据库连接池文件，详细分析请看后面的Struts数据库应用程序设计章节。

web目录下包含了JSP、Html等web文件和Web文件用到的图片文件。新建时这个目录是空的。

build.xml文件是编译是所需的配置文件，由于JSPStudio采用的是ANT编译器，所以这个文件是JSPStudio项目中必不可少的，它是ANT标准的配置文件，所有的项目目录结构也符合ANT编译器的要求，可见JSPStudio项目与ANT具有非常好的兼容性，这也是JSPStudio的优点之一。

hello.prj文件是项目文件，XML结构，内容如下：

<projectname>Simple</projectname>

<projecttype>struts</projecttype>

<title>这是一个建立空的Struts普通模板</title>

<package>emptyprj</package>

<typepath>\Jave Web 项目\空的Struts普通模板</typepath>

<projectpath>F:\JavaWebStudio\JavaWebStudioWorkDir\Simple</projectpath>

<projectname>标签内是项目名称；<projecttype>标签内是项目的类型，这个标签的内容最好不要改变；<title>标签内是项目的简单说明，可根据需要填写；<package>标签内是默认的package名称；<typepath>标签内是项目模板的相对路径；<projectpath>标签内是项目保存的绝对路径。

[关键技术]

Struts使用MVC结构；图2.1所示的逻辑图描述了框架的高层结构。

我们现在讨论图中的每个元素。

ActionMapping

ActionForm (模型的数据)

Action (模型的业逻辑)

发送

ActionServlet (controller)

JSP (view)

taglib (view)

使用

实例化

调用

使用

图2.1

本例主要文件之间的关系：

输入页面：

HelloWord.jsp

ActionForm (模型的数据)

HelloWordForm.java

ActionServlet (controller)

通过struts-config.xml配置实现

ActionMapping

输入页面：

HelloWordOut.jsp

Action (模型的业逻辑)

HelloWordAction.java

[关键源代码分析]

4.3.1 输入JSP页面文件

输入JSP页面文件名是hello.jsp，主要实现一个带有文本框的表单，文件代码如下：

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

<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>

<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>

<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>

<%@ taglib uri="/WEB-INF/struts-template.tld" prefix="template" %>

<html:html>

<head>

<html:base/>

</head>

<html:form action="/helloAction.do" method="post">

<html:text property="mybeanvariable1" />

<html:submit value="提交" />

<html:reset value="重写" />

</html:form>

</body>

</html:html>

首先是把本页定义为支持中文显示，中文编码采用GB2312格式，程序语言为Java：

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

接着定义支持四种Struts标签bean、html、logic和template，在该文件中没用到的标签可以去掉相应的定义，如果在文件中还需要用到自定义标签，也需要在这里加入相应的定义：

<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>

<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>

<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>

<%@ taglib uri="/WEB-INF/struts-template.tld" prefix="template" %>

<html:html>就不用说了。<html:base/>标签对应HTML的<BASE>标签，用来设定测览器中文件的绝对路径，然后在文件中只需写下文件的相对位置，在测览器中测览的时候这些位置会自动附在绝对路径后面，成为完整的路径。在文档中所有相对地址形式的URL是相对于这里定义的UTRL而言的。一篇文档中的<BASE>标记不能多于一个，必须放于<head>标签内，并且应该在任何包含URL地址的语句之前定义。<html:form>这里用了黑体字，表示是要重点讲解的地方。

<html:form action="/helloAction.do" method="post">

<html:text property="mybeanvariable1" />

<html:submit value="提交" />

<html:reset value="重写" />

</html:form>

<html:form>标签定义了一个表单，提交时的目标URL是“/helloAction.do”，方法是“post”，Post方法是将用户在表单中填写的数据包含在表单的主体中，一起传送到服务器上的处理程序中，该万法没有字符的限制，它包含了ISO10646的字符集，是一种邮寄的万式，在测览器的地址栏不显示提交的信息，这种万式传送的数据是没有限制。当然也可以选择Get方法，Get方法是将表单内容附加在URL地址后面，所以对提交信息的长度进行了限制，最多不可以超过8192个字符，如果信息大长，将被截去，从而导致意想不到的结果，而且不能传送非ASCII码的字符。表单内包含一个文本输入框<html:text>，它的值与Bean中属性为"mybeanvariable1"的变量相对应，如果结mybeanvariable1付了初值，则在启动这个页面时文本框中就显示默认的mybeanvariable1初值。另外表单内还包含了两个最常见的提交按钮<html:submit value="提交" />和重写按钮<html:reset value="重写" />。

4.3.2 输出JSP页面文件

输出JSP页面文件名是helloOut.jsp，主要实现输入文件提交的文本框的值，文件代码如下：

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

<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>

<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>

<%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %>

<html:html>

<head>

<html:base/>

</head>

<html:html>

<head>

<html:base/>

</head>

<bean:write name="helloForm" property="mybeanvariable1" />

</body>

</html:html>

</body>

</html:html>

输出文件与前面输入文件唯一不同的是把<html:form>标签变成了<bean:write>标签：

<bean:write name="helloForm" property="mybeanvariable1" />

<bean:write>标签实现Bean属性值的输出，其中name保存Bean名，这里是“helloForm”，从后面的配置文件可以看出，它对应的类是helloForm类；property保存属性名，这里是“mybeanvariable1”，与输入文件的文本框取的属性名一至。

4.3.3 ActionForm Bean文件

Hello程序的ActionForm Bean文件实现只包含一个变量的Bean，文件名是helloForm.java，文件代码如下：

package emptyprj;

import javax.servlet.http.HttpServletRequest;

import org.apache.struts.action.ActionError;

import org.apache.struts.action.ActionErrors;

import org.apache.struts.action.ActionForm;

import org.apache.struts.action.ActionMapping;

public final class HelloWordForm extends ActionForm

{

private String mybeanvariable1;

public String getMybeanvariable1()

{

return (this.mybeanvariable1);

}

public void setMybeanvariable1(String mybeanvariable1)

{

this.mybeanvariable1=mybeanvariable1;

}

首先是定义package名：

package emptyprj;

这是选用了JSPStudio默认的package名emptyprj，需注意的是package名要与目录名对应。接着引入了ActionForm Bean设计中常用的五个类HttpServletRequest、ActionError、ActionErrors、ActionForm和ActionMapping，这是JSPStudio自动加入的，实际上helloForm类只用于ActionForm类，其它部分可以删除，但这里保留它以方便以后扩展程序时用。

import javax.servlet.http.HttpServletRequest;

import org.apache.struts.action.ActionError;

import org.apache.struts.action.ActionErrors;

import org.apache.struts.action.ActionForm;

import org.apache.struts.action.ActionMapping;

接下来就是定义了helloForm、一个参数mybeanvariable1和它对应的get()、set()函数，这与普通Bean定义的方法一模一样。

4.3.4 Action文件

Hello程序的Action文件实现对输入文件提交的表单的处理，文件名是helloAction.java，文件代码如下：

package emptyprj;

import java.lang.reflect.InvocationTargetException;

import java.util.Locale;

import javax.servlet.ServletException;

import javax.servlet.http.HttpSession;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import org.apache.commons.beanutils.PropertyUtils;

import org.apache.commons.logging.Log;

import org.apache.commons.logging.LogFactory;

import org.apache.struts.action.Action;

import org.apache.struts.action.ActionError;

import org.apache.struts.action.ActionErrors;

import org.apache.struts.action.ActionForm;

import org.apache.struts.action.ActionForward;

import org.apache.struts.action.ActionMapping;

import org.apache.struts.action.ActionServlet;

import org.apache.struts.util.ModuleException;

import org.apache.struts.util.MessageResources;

public final class HelloWordAction extends Action

{

// 变量定义：

private Log log = LogFactory.getLog("org.apache.struts.webapp.Example");

//函数定义：

public ActionForward execute(ActionMapping mapping,

ActionForm form,

HttpServletRequest request,

HttpServletResponse response)

throws Exception

{

// Extract attributes and parameters we will need

Locale locale = getLocale(request);

MessageResources messages = getResources(request);

HttpSession session = request.getSession();

HelloWordForm myform = (HelloWordForm) form;

String variable1= myform.getMybeanvariable1();

try

{

if(variable1.trim().equals(""))

{

return new ActionForward(mapping.getInput());

}

//其它代码

return (mapping.findForward("success"));

}

catch (Exception e)

{

//log.error("出错", e);

//log.trace("出错");

throw new RuntimeException(e.getMessage());

}

首先定义处理函数execute（），可以理解为当Hello输入文件表单提交到服务器的ActionServlet，由ActionServlet调用Action的execute（）函数实现商业逻辑处理，处理完成后把结果转发到输出文件中。execute（）函数定义一个helloForm实例“myform”，并从提交的输入ActionForm对象实例form中读取数据，把mybeanvariable1变量的值赋给新的字符串变量variable1：

helloForm myform = (helloForm) form;

String variable1= myform.getMybeanvariable1();

接下来是出错处理，try语句用于组合一个引起异常的代码块,它使我们告诉Java要注意有可能出现异常的代码段；catch:一旦掷出一个异常，需要捕获住这个异常,catch语句使程序员定义一个捕获；finally:在try/catch块结尾，程序可能需要确保一个代码块不管是否掷出了异常，总是被执行,例如不管发生什么，我们可能都需要确保关闭特定的文件; Exceptlon:一种用于存放在代码中发现的关于一个"exception"或"error"的信息的类；throws:当某些事需要关注时，我们"掷出"一个异常。这个异常被我们创建的一段处理异常的特殊代码"抓住"。涣句话说，通过掷出一个异常，我们告诉代码:出错啦，需要调用一些特殊的逻辑去处理问题。下面完它的完整结束：

try

{

//正常代码

}

catch (Exception e)

{

//出错处理代码

throw new RuntimeException(e.getMessage());

}

finally

{

//最后都必需进行的处理代码

}

在try块中我们进行的变量variable1是否为空的判断，如果为空就转发到输入页，否则转发到定义为success的输出页：

if(variable1.trim().equals(""))

{

return new ActionForward(mapping.getInput());

}

//其它代码

return (mapping.findForward("success"));

mapping.getInput()函数用于获取输入页的URL值，这个值与配置文件struts-config.xml中<action>项的input属性值相对应。

4.3.5 Struts程序配置

<?xml version="1.0" encoding="ISO-8859-1" ?>

<!DOCTYPE struts-config PUBLIC

"-//Apache Software Foundation//DTD Struts Configuration 1.0//EN"

"http://jakarta.apache.org/struts/dtds/struts-config_1_0.dtd">

<struts-config>

<form-beans>

<form-bean name="HelloWordForm"

type="emptyprj.HelloWordForm" />

</form-beans>

<action-mappings>

<action path="/HelloWordAction"

type="emptyprj.HelloWordAction"

name="HelloWordForm"

scope="session"

input="/HelloWord.jsp">

</action>

</action-mappings>

</struts-config>