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