介绍struts提供的类

struts框架具有组件的模块化，灵活性和重用性的优点，同时简化了基于MVC的web应用程序的开发。
本章详细讨论struts架构。我们将看到struts是如何清晰地区分控制，事务逻辑和外观，从而简化了开发应用程序过程的。我们还将介绍struts提供的类如何使得开发工作更加简单，这些类包括：
1. 控制程序流程的类
2. 实现和执行程序事务逻辑的类
3. 自定义的标记库使得创建和验证HTML表单更加容易
1.1 Struts压缩包内容
文件夹jakarta-struts-1.0.2包含两个目录，lib和webapps。在lib目录中有使用struts创建应用程序是所需的文件：
文件描述jdbc2_0-stdext.jar 包含JDBC2.0 Optional Package API类。如果我们要使用struts提供的数据资源，就需要将这个文件拷贝到WEB-INF/lib下Struts.jar 包含struts中所有的java类。同样也需要拷贝到WEB-INF/lib下*.tld 标记库描述器文件，描述了多个struts标记库中的自定义标记。同样要拷贝到WEB-INF/lib下
在webapps目录下有如下文件：
Web应用程序描述Struts-blank.war 一个简单的web应用程序Struts-documentation.war 包含struts站点上所有struts文档Struts-example.war Struts很多特性的示范Struts-exercisetaglib.war 主要用于对自定义标签库进行增加而使用的测试页，但也可以示范如何使用struts标记Struts-template.war 包含struts模板标记的介绍和范例Struts-upload.war 一个简单的例子，示范如何使用struts框架上传文件
1.2 Struts体系结构
让我们从MVC角度观察struts框架中的组件
框架中三个部分：模型，视窗和控制器。
1.2.1 模型
在struts框架中，模型分为两个部分：
系统的内部状态
可以改变状态的操作（事务逻辑）
内部状态通常由一组ActinForm JavaBean表示。根据设计或应用程序复杂度的不同，这些Bean可以是自包含的并具有持续的状态，或只在需要时才获得数据（从某个数据库）。
大型应用程序通常在方法内部封装事务逻辑（操作），这些方法可以被拥有状态信息的bean调用。比如购物车bean，它拥有用户购买商品的信息，可能还有checkOut()方法用来检查用户的信用卡，并向仓库发定货信息。
小型程序中，操作可能会被内嵌在Action类，它是struts框架中控制器角色的一部分。当逻辑简单时这个方法很适合。
建议用户将事务逻辑（要做什么）与Action类所扮演的角色（决定做什么）分开。
1.2.2 视窗
由JSP建立，struts包含扩展自定义标签库，可以简化创建完全国际化用户界面的过程。
1.2.3 控制器
struts中，基本的控制器组件是ActionServlet类中的实例servelt，实际使用的servlet在配置文件中由一组映射（由ActionMapping类进行描述）进行定义。
2
1.3 Struts框架中的组件
(由于ROSE工具还未能下载，只能找来这幅图，它说明了一定问题，特别是ActionErrors，但它并没有将ActionMapping，JSP和Tag Library包含进来，有时间作完替换)
框架中所使用的组件：
ActionServlet 控制器ActionClass 包含事务逻辑ActionForm 显示模块数据ActionMapping 帮助控制器将请求映射到操作ActionForward 用来指示操作转移的对象ActionError 用来存储和回收错误Struts标记库可以减轻开发显示层次的工作
下面我们看看各自在框架中所扮演的角色和责任。
1.3.1 Struts配置文件
这是将struts组件结合在一起的东东：struts-config.xml。默认值
/WEB-INF/struts-config.xml。配置文件可以定义：
全局转发
ActionMapping类
ActionForm bean
JDBC数据源
配置全局转发
全局转发用来在JSP页之间创建逻辑名称映射。转发都可以通过对调用操作映射的实例来获得，例如：
actionMappingInstace.findForward(“logicalName”);
全局转发的例子：(所有的例子我没有进行解释，一是结合表可以理解，二是例子大部分来自系列四的示例，你应该在作完实验后，再来看一便)
<global-forwards>
3
<forward name="bookCreated" path="/BookView.jsp"/>
</global-forwards>
属性描述Name 全局转发的名字Path 与目标URL的相对路径
配置ActionMapping
ActionMapping对象帮助进行框架内部的流程控制，它们可将请求URI映射到Action类,并且将Action类与ActionForm bean相关联。ActionServlet在内部使用这些映射，并将控制转移到特定Action类的实例。所有Action类使用perform()方法实现特定应用程序代码，返回一个ActionForward对象，其中包括响应转发的目标资源名称。例如：
<action-mappings>
<action path="/createBook"
type="BookAction"
name="bookForm"
scope="request"
input="/CreateBook.jsp">
</action>
<forward name=”failure” path=”/CreateBook.jsp”/>
<forward name=”cancel” path=”/index.jsp”/>
</action-mappings>
属性描述Path Action类的相对路径Name 与本操作关联的Action bean的名称Type 连接到本映射的Action类的全称（可有包名） Scope ActionForm bean的作用域（请求或会话） Prefix 用来匹配请求参数与bean属性的前缀Suffix 用来匹配请求参数与bean属性的后缀attribute 作用域名称。className ActionMapping对象的类的完全限定名默认的类是org.apache.struts.action.ActionMapping input 输入表单的路径，指向bean发生输入错误必须返回的控制unknown 设为true，操作将被作为所有没有定义的ActionMapping的URI的默认操作validate 设置为true，则在调用Action对象上的perform()方法前，ActionServlet将调用ActionForm bean的validate()方法来进行输入检查
通过<forward>元素，可以定义资源的逻辑名称，该资源是Action类的响应要转发的目标。
属性描述Id ID ClassName ActionForward类的完全限定名，默认是org.apache.struts.action.ActionForwardName 操作类访问ActionForward时所用的逻辑名Path 响应转发的目标资源的路径
4
redirect 若设置为true，则ActionServlet使用sendRedirect()方法来转发资源
配置ActionForm Bean
ActionServlet使用ActionForm来保存请求的参数，这些bean的属性名称与HTTP请求参数中的名称相对应，控制器将请求参数传递到ActionForm bean的实例，然后将这个实例传送到Action类。例子：
<form-beans>
<form-bean name="bookForm" type="BookForm"/>
</form-beans>
属性描述Id ID className ActionForm bean的完全限定名，默认值是org.apache.struts.action.ActionFormBean Name 表单bean在相关作用域的名称，这个属性用来将bean与ActionMapping进行关联Type 类的完全限定名
配置JDBC数据源
用<data-sources>元素可以定义多个数据源。
属性描述Id ID Key Action类使用这个名称来寻找连接Type 实现JDBC接口的类的名称
下面属性需要<set-property>元素定义，在框架1.1版本中已不在使用，但你可用<data-source>元素。例子：
<data-sources>
<data-source id=”DS1”
key=”conPool”
type=”org.apache.struts.util.GenericDataSource”
<set-property id=”SP1”
autoCommit="true"
description="Example Data Source Configuration"
driverClass="org.test.mm.mysql.Driver"
maxCount="4"
minCount="2"
url="jdbc:mysql://localhost/test"
user="struts"
password="wrox" />
<data-source/>
</data-sources>
属性描述desciption 数据源的描述autoCommit 数据源创建的连接所使用的默认自动更新数
5
据库模式driverClass 数据源所使用的类，用来显示JDBC驱动程序接口loginTimeout 数据库登陆时间的限制，以秒为单位maxCount 最多能建立的连接数目minCount 要创建的最少连接数目password 数据库访问的密码readOnly 创建只读的连接User 访问数据库的用户名url JDBC的URL
通过指定关键字名称，Action类可以访问数据源，比如：
javax.sql.DataSource ds = servlet.findDataSource(“conPool”);
javax.sql.Connection con = ds.getConnection();
1.4 ActionServlet类
框架中的控制器组件是有org.apache.struts.action.ActionServlet类实现的，这个类是javax.servlet.http.HttpServlet类的扩展。
Struts controller基本功能是： 1. 截获用户的Http请求2. 把这个请求映射到相应的Action类，如果这是此类收到的第一个请求，将初始化实例并
缓寸。3. 创建或发现一个ActionForm bean实例（看配置文件是否定义），然后将请求过程移植到
bean. 4. 调用Action实例的perform（）方法并将ActioForm bean,Action Mapping对象,request
和response对象传给它。如：public ActionForword perform(ActionMapping mapping, ActionForm form, HttpServletRequest request, HttpServletResponse response) 5.perform返回一个ActionForword对象，此对象连接到相应的jsp页面.
1.4.1 ActionServlet配置
我们需要在web.xml中声明ActionServlet，并且将它配置成启动时进行加载。以下可以配置的初始化参数：
参数默认值描述application null 应用程序的资源集合的类bufferSize 4096 文件上传的缓冲区大小
6
config /WEB-INF/struts-config.xml 配置文件的位置和名称content Text/html 默认的内容类型debug 0 程序调试的级别detail 0 程序调试细节的级别factory null 消息资源工厂，用于国际化中解释消息资源formBean org.apache.struts.action.ActionFormBean封装ActionForm bean信息的类的名称forward org.apache.struts.action.ActionForward 封装ActionForward对象信息的类的名称locale true 为true,将在用户会话中存储一个本地对象mapping org.apache.struts.action.ActionForward 封装ActionMapping信息的类的名称maxFileSize 250M 上传文件的最大尺寸multipartClass org.apache.struts.action.ActionForward 处理多部分请求的类的名称noCache False HTTP标头是否要设置为禁止缓寸Null True 设置为true，对于无效的信息关键字将返回null tempDir 作为一个servlet参数提供给程序的工作目录处理下载文件是使用的临时工作目录validate True 是否使用新格式的配置文件vallidating True 是否对配置文件进行有效性分析
大多数情况下，标准的servlet就能够满足用户需要。
第一次收到特定请求的URI时，ActionServlet将适当的Action类进行实例化，然后ActionServlet在Action类实例中以servlet为变量名存储一个引用。当被实例化后，Action类会被暂存以备再用。
ActionServlet也提供一些方法，由Action类用来访问数据源和转发目标之类的资源。
1.4.2 ActionServlet方法
ActinServlet提供了一组能够被Action对象使用的方法。
Struts API的全部信息在struts-documentation.war中可以找到。动态的添加或删除，这些方法只影响应用程序当前的实例：
public void addFormBean(ActionFormBean formBean)
public void removeFormBean(ActionFormBean formBean)
public void addForward(ActionForward actionForward)
public void removeForward(ActionForward actionForward)
public void addMapping(ActionMapping actionMapping)
7
public void removeMapping(ActionMapping actionMapping)
根据名称查找对象：
public ActionFormBean findFormBean(String name)
public ActionForward findForward(String name)
public ActionMapping findMapping(String name)
用来处理数据源：
public void addDataSource(String key , DataSource ds)
public DataSource findDataSource(String key)
我们还可以：
使用destroy()方法结束ActionServlet
使用reload()方法从struts配置文件将信息重新加载。
1.5 ActionMapping类
将特定请求映射到特定Action的相关信息存储在ActionMapping中，ActionServelt将ActionMapping传送到Action类的perform()方法，Action将使用ActionMapping的findForward()方法，此方法返回一个指定名称的ActionForward，这样Action就完成了本地转发。若没有找到具体的ActionForward，就返回一个null.
public ActionForward findForward(String name)
可在映射中动态添加ActionForward:
public void addForward(ActionForward forward)
可返回与映射关联的表单bean:
public String getName()
可返回映射的属性域（会话或请求）
public String getScope()
1.6 Action类
Action类真正实现应用程序的事务逻辑，它们负责处理请求。在收到请求后，ActionServlet会：
为这个请求选择适当的Action
如果需要，创建Action的一个实例
调用Action的perform()方法
如果ActionServlet不能找到有效的映射，它会调用默认的Action类(在配置文件中定义)。如果找到了ActionServlet将适当的ActionMapping类转发给Action，这个Action使用ActionMapping找到本地转发，然后获得并设置ActionMapping属性。根据servlet的环境和被覆盖的perform()方法的签名，ActionServlet也会传送ServletRequest对象或HttpServletRequest对象。
所有Action类都扩展org.apache.struts.action.Action类，并且覆盖类中定义的某一个perform()方法。有两个perform()方法：
处理非HTTP（一般的）请求：
8
public ActionForward perform(ActionMapping action,
AcionForm form,
ServletRequest request,
ServletResponse response)
throws IOException,ServletException
处理HTTP请求：
public ActionForward perform(ActionMapping action,
AcionForm form,
HttpServletRequest request,
HttpServletResponse response)
throws IOException,ServletException
Action类必须以“线程安全”的方式进行编程，因为控制器会令多个同时发生的请求共享同一个实例，相应的，在设计Action类时就需要注意以下几点：
不能使用实例或静态变量存储特定请求的状态信息，它们会在同一个操作中共享跨越请求的全局资源
如果要访问的资源（如JavaBean和会话变量）在并行访问时需要进行保护，那么访问就要进行同步
1.6.1 Action类的方法
除了perform()方法外，还有以下方法：
可以获得或设置与请求相关联的区域：
public Locale getLocale(HttpServletRequest request)
public void setLocale(HttpServletRequest request,Locale locale)
为应用程序获得消息资源：
public MessageResources getResources()
检查用户是否点击表单上的“取消”键，如果是，将返回true:
public Boolean isCancelled(HttpServletRequest request)
当应用程序发生错误时，Action类能够使用下面方法存储错误信息：
public void saveErrors(HttpServletRequest request,ActionErrors errors)
ActionError实例被用来存储错误信息，这个方法在错误关键字下的请求属性列表中存储ActionError对象。通过使用在struts标记库中定义的自定义标记，JSP页能够显示这些错误信息，稍后我们就介绍。
1.7 ActionForm类
框架假设用户在应用程序中为每个表单都创建了一个ActionForm bean，对于每个在struts-config.xml文件中定义的bean，框架在调用Action类的perform()方法之前会进行以下操作：
在相关联的关键字下，它检查用于适当类的bean实例的用户会话，如果在会话中没有可用的bean，它就会自动创建一个新的bean并添加到用户的会话中。
对于请求中每个与bean属性名称对应的参数，Action调用相应的设置方法。
9
当Action perform()被调用时，最新的ActionForm bean传送给它，参数值就可以立即使用了。
ActionForm类扩展org.apache.struts.action.ActionForm类，程序开发人员创建的bean能够包含额外的属性，而且ActionServlet可能使用反射（允许从已加载的对象中回收信息）访问它。
ActionForm类提供了另一种处理错误的手段，提供两个方法：
Public ActionErrors validate(ActionMappin mapping,
ServletRequest request)
Public ActionErrors validate(ActionMappin mapping,
HttpServletRequest request)
你应该在自己的bean里覆盖validate()方法，并在配置文件里设置<action>元素的validate为true。在ActionServlet调用Action类前，它会调用validate()，如果返回的ActionErrors不是null，则ActinForm会根据错误关键字将ActionErrors存储在请求属性列表中。
如果返回的不是null，而且长度大于0，则根据错误关键字将实例存储在请求的属性列表中，然后ActionServlet将响应转发到配置文件<action>元素的input属性所指向的目标。
如果需要执行特定的数据有效性检查，最好在Action类中进行这个操作，而不是在ActionForm类中进行。
方法reset()可将bean的属性恢复到默认值：
public void reset(ActionMapping mapping,HttpServletRequest request)
public void reset(ActionMapping mapping,ServletRequest request)
典型的ActionFrom bean只有属性的设置与读取方法（getXXX）,而没有实现事务逻辑的方法。只有简单的输入检查逻辑，使用的目的是为了存储用户在相关表单中输入的最新数据，以便可以将同一网页进行再生，同时提供一组错误信息，这样就可以让用户修改不正确的输入数据。而真正对数据有效性进行检查的是Action类或适当的事务逻辑bean。
1.8 ActionForward类
目的是控制器将Action类的处理结果转发至目的地。
Action类获得ActionForward实例的句柄，然后可用三种方法返回到ActionServlet，所以我们可以这样使用findForward():
ActionServlet根据名称获取一个全局转发
ActionMappin实例被传送到perform()方法，并根据名称找到一个本地转发
另一种是调用下面的一个构造器来创建它们自己的一个实例：
public ActionForward()
public ActionForward(String path)
public ActionForward(String path,Boolean redirect)
10
1.9 错误处理
struts提供了两个类来处理错误：ActionErrors和ActionError，它们都扩展org.apache.struts.action。ActionErrors保存着ActionError对象的集合，其中每一个代表了独立的错误信息。每个ActionError都包含了关键字，能够映射到资源文件中存储的错误信息，而这个资源文件是在ActionServlet初始化参数中指定的。
1.9.1 ActionError类
ActionError类定义了一组重载的构造器来创建错误信息，第一个构造器方法使用一个字符串作为参数，例如：
ActionError error = new ActionError(“error.Invalid”);
实例error映射到应用程序资源文件中的一个错误消息：
error.invalid=<b>Invalid Number</b>
如果在JSP页使用<html:error>，用户就会看见加粗的Invalid Number。
另一种使用了java.text.MessageFormat类，可在消息中指定替换字符串，例如：
error.invalid=<b>Invalid Number{0}</b>
创建一个错误消息：
ActionError error = new ActionError(‘error.invalid’,new Double(-1));
JSP页显示：Invalild Number ?1
还有获得特定消息的错误关键字：
public String getKey()
还有获得替换字符串数组：
public String[] getValues()
1.9.2 ActionError类
ActionError类从不独立进行错误处理，它们总是被存储在ActionErrors对象中。ActionErrors对象保存ActionError类的集合以及它们特定的属性值，我们可以使用自己定义的属性值，或是使用ActionErrors.GLOBAL_ERROR.
下面是典型Action类的perform()中错误处理情况：
MyForm form = (MyForm) form;
if (number == -1) {
ActionErrors errors = new ActionErrors();
ActionError error = new ActionError(“error.Invalid”,new Double(-1));
errors.add(ActionErrors.GLOBAL_ERROR,error);
saveErrors(req,errors);
String input = mapping.getInput();
Return new ActionForward(input);
}
ActionErrors有如下有用方法：
11
方法描述clear() 清除所有错误信息empty() 如果ActionErrors对象是空的，它返回true get() 返回错误信息。若无参数，所有信息将作为一个Iterator对象返回properties() 返回包含属性名称的Iterator，这些属性至少有一个错误size() 返回错误的数目（整型数）