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() 返回错误的数目(整型数)