Struts1 的配置文件总结

一、在web.xml中安装Struts

要想使用Struts,我们接触到的第一个配置文件就是web.xml。实际上,Struts的入口点是一个名为ActionServlet的Servlet。在第一次访问Struts时,建立这个ActionServlet类的对象实例,并调用ActionServlet类中的init方法来进行初始化(其实是读取struts-config.xml文件中的内容,并根据struts-config.xml中的内容来初始化相关的资源)。因此,就要在web.xml文件中安装这个ActionServlet,并在ActionServlet的初始化参数中指定struts-config.xml的位置。

二、struts-config.xml文件的结构

struts-config.xml是Struts的核心配置文件。也就是说,只要是使用Struts,就必须配置struts-config.xml文件。struts-config.xml文件的所有配置项都要放到顶层元素<struts-config>中,主要配置项有如下七个:

1.FormBean:在<form-beans>元素中配置。

2.Action映射:在<action-mappings>元素中配置。

3.全局Forwards:在<global-forwards>元素中配置。

4.全局异常(Exception):在<global-exceptions>元素中的配置。

5.控制器(Controller):在<controller>元素中配置。

6.信息资源:在<message-resources>元素中的配置。

7.插件:在<plug-in>元素中配置。

下面我们就分别来看一下这七部分的具体配置方法。

三、配置Formbean和Action映射

这两个配置项是Struts配置的核心,也就是说我,一个完整的Struts应用程序都会拥有这两项配置。

每一个Formbean要在<form-beans>元素中定义一个<form-bean>子元素。下面的代码给出了一个标准的Formbean的配置方法:

<form-beans>
    <form-bean name="myForm" type="actionform.MyActionForm" />
</form-beans>

其中name属性表示Formbean名,type属性表示Formbean类的全名(包名+类名),一般type属性值需要指定一个org.apache.struts.action.ActionForm类或其子类。type属性值还可以指定一个动态form,如org.apache.struts.action.DynaActionForm,或这个类的子类。

在<form-beans>元素中定义的Formbean一般用于将客户端浏览器提交的数据映射为Java Bean的形式,最终开发人员可以直接使用Java Bean来操作客户端提交的数据。Formbean同时还有验证数据的功能(在validate方法中验证)。Formbean有时还会作为其他用途使用,如使用动态form和LocaleAction类配合使用来进行本地化操作。

每一个Action映射要在<action-mappings>元素中定义一个<action>子元素。Action映射的主要功能是将Struts动作的访问路径(一般以.do结尾)和Struts动作类相对应。同时可以指定一个Formbean来接收和验证客户端提交的数据。下面的代码给出了一个标准的配置Action动作的方法:

<action-mappings>
    <action name="myForm" path="/myaction"  scope="request"  validate="true" type="action.MyAction" input="/mystruts/error.jsp">
         <forward name="success" path=" /mystruts/success.jsp" />
    </action>
</action-mappings>

四、配置全局Forwards

每一个全局的Forwards需要在<global-forwards>元素中定义一个<forward>子元素。全局 Forwards可以被所有的Action、异常处理以及一些Struts标签(如<html:link>)访问。下面的代码给出了一个标准的全局Forward的配置方法:

<global-forwards>
     <forward name="myforward" path="/mystruts/newProduct.jsp" />
</global-forwards>

五、配置局部和全局异常(Exception)

在Struts中处理异常的方法非常多,然后,为了使处理异常的方式更灵活。Struts框架允许以配置的方式来处理异常。

Struts中的异常配置可分为局部和全局异常。这两种异常配置的方法完全一样,只是配置代码的位置不同。配置局部异常的<exception>元素在<action>元素中,而全局异常的<exception>元素在<global-exceptions >元素中。局部异常的优先级大于全局异常的优先级。

下面的代码给出了一个标准的全局异常的配置方法:

<global-exceptions >
    <exception key="error.name.blank" type="java.lang.Exception" path="/error.jsp"/>
</global-exceptions>

其中key属性表示在属性文件中的key,一但Struts Action的execute方法抛出异常,Struts首先会在局部和全局异常中匹配type属性所指定的异常类型。如果匹配成功,就会跳转到path属性所指的Web资源(在本例中是"/error.jsp")。如果在error.jsp页面中使用<html:errors/>标签显示错误信息,就会输出key属性所对应的值。

<exception>元素除了可以使用path属性指定要跳转的Web资源外,也可以使用handler属性指定用于处理异常的类。如下面的代码所示:   

<global-exceptions>
    <exception key="error.email.invalid"  type="java.lang.Exception" handler="exceptions.EmailException"/>
</global-exceptions>

其中exceptions.EmailException类必须继承org.apache.struts.action.ExceptionHandler类,而且我们必须覆盖execute方法。

ExceptionHandler类的execute方法的定义如下:

public ActionForward execute( Exception ex,ExceptionConfig ae,ActionMapping mapping,
                            ActionForm formInstance,HttpServletRequest request,
                            HttpServletResponse response) throws ServletException;

六、配置控制器(Controller)

控制器可能是这七个配置项上使用最少的一项。它主要用来覆盖一些默认的Struts设置。下面是几个常用的Struts设置:

1.maxFileSize:指定在文件上传时的最大文件尺寸。可以使用K、M和G作为单位。如maxFileSize="2M"。maxFileSize的值只能是整数,不能是小数,如maxFileSize=1.2M是不合法的。

2.nocache:告诉Struts是否应该缓冲内容。指定为nocache="true",Struts将不会缓冲内容。默认值为true。

3.contentType:指定默认的ContentType字段值,如果要发送的内容的默认格式是HTML,我们可以指定contentType的值为"text/html"。

下面的代码是一个完成的控制器的配置:

<controller maxFileSize="2M" contentType="text/html" nocache="false" />
七、配置信息资源

信息资源使用<message-resources>元素进行配置。下面是一个配置信息资源的例子:

<message-resources parameter="struts.application" key="global" />

其中parameter属性表示保存信息资源的属性文件的位置,对于上面的代码来说,属性文件的位置是<Web根目录>"WEB-INF"classes"struts"application.properties。key属性表示application.properties文件的标识。如果没有key属性,这个属性文件就是默认的属性文件。当指定key属性时,在使用这个属性文件时,需要使用相关标签的bundle属性指定这个key值。

属性文件中的值可以使用Struts标签来获取,如属性文件中的一个key是key.msg.submit。那么使用<bean:message>标签获取这个属性文件中的key值的代码如下:

<bean:message key="key.msg.submit" bundle="global"/>

属性文件也可以用在获得错误信息上,如在validate方法中使用如下的代码来指定错误提示信息:

errors.add("name",new ActionMessage("error.name.blank"));

而在JSP页面中可以使用如下的代码来显示这个错误信息:

<html:errors property="name" bundle="global"/>

八、配置Struts插件

Struts之所以强大,在很大程度上取决于它支持通过插件的方式进行扩展,如前面讲的Validator和Tiles,都是以Struts插件形式发布的。Struts插件使用<plug-in>元素进行配置,如下面的代码所示:

<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
     <set-property property="pathnames" value="/WEB-INF/validator-rules.xml,/WEB-INF/validator.xml" />
</plug-in>

其中className属性指定了Struts要调用的插件类名。property属性指定了插件需要的属性名,而value属性指定了相应的属性值。

原文地址:https://www.cnblogs.com/zhangzonghua/p/Struts1.html

时间: 2024-10-22 17:53:08

Struts1 的配置文件总结的相关文章

struts1的一些基本用法和操作

入职两周了,项目是用struts1+ibatis框架搭建的,数据库是oracle,其他还行,关键是struts1之前没用用过,所以只好在网上狂查文档,最后大致整理了一些struts1的基本使用方法. 首先struts1需要引入的jar包: 因为我的IED是Myeclipse8.5直接引入的,实在是不想在struts的网站找jar了 struts1和2的第一个区别就是xml配置的位置不一样,struts1的配置文件是放在webRoot/WRB-INF/ib下,叫做struts-config.xml

Struts框架:ActionForward详细介绍

首先,什么是"ActionForward"? ActionForward是 Struts1的核心类之一,其基类仅有4个属性:name / path / redirect / classname.在基于Struts1的Web应用程序开发过程中,Action操作完毕后程序会通过Struts1的配置文件struts-config.xml链接到指定的ActionForward,传到Struts1的核心类ActionServlet,ActionServlet使用 ActionForward提供的

struts1配置文件之input

<action path="/*Person" type="cn.itcast.PersonAction" scope="request" input="/{1}.jsp" parameter="method"> <forward name="list" path="/WEB-INF/pages/list.jsp"/> </action&

详解Struts1中的struts-config.xml配置文件【一】

搞清楚struts-config.xml中各项元素的作用,对于我们构建web项目有莫大的好处.<struts-config>是struts的根元素,它主要有8个子元素,DTD定义如下: <!ELEMENT struts-config (data-sources?,form-beans?,global-exceptions?,global-forwards?, action-mappings?,controller?,message-resources*,plug-in*)> 以上8

struts1,struts2在web.xml里的配置文件

1.struts1是采用servlet的分发方式,在web.xml里可以配置多个servlet,不同的servlet可以针对不同servlet处理类,在写action的时候可以继承不同的servlet类,在web.xml里配置的时候,如果servlet里没有设置初始化参数来配置这个servlet配置文件的路径的话,struts1会自动去web-inf下的classes下的”servletname“-servlet.xml加载,如果设置了这个初始化参数的话,则加载参数里的配置文件 <servlet

Struts1 多个配置文件的实现

在Struts 1.0中,我们只能在web.xml中为ActionServlet指定一个配置文件,这对于我们这些网上的教学例子来说当然没什么问题,但是在实际的应用开发过程中,可能会有些麻烦.因为许多开发人员都可能同时需要修改配置文件,但是配置文件只能同时被一个人修改,这样肯定会造成一定程度上的资源争夺,势必会影响开发效率和引起开发人员的抱怨. 在Struts 1.1中,为了解决这个并行开发的问题,提出了两种解决方案: 多个配置文件的支持 模块的支持 支持多个配置文件,是指你能够为ActionSe

Struts1.x教程:配置文件总结

要想使用Struts,至少要依靠两个配置文件:web.xml和struts-config.xml.其中web.xml用来安装Struts框架.而struts-config.xml用来配置在Struts框架中要使用的资源.如Formbean.Action.插件等.如果使用了某些插件,如Validator.Tiles等.还可能需要其他的配置文件.虽然在前面的文章中已多次使用了这两个配置文件,但都是分散介绍的.因此,在本文将对这些配置进行一下总结和回顾,以使读者对Struts的配置有一个更清醒的认识.

Struts1的实现原理

一 开文背景 -- 废话讲一段~ 本文借助动力节点-王勇老师的视频教程中的引例来了解struts1的实现原理,虽然现在已经很少使用struts1了,但是了解了其原理之后,对了解其他mvc框架还是有较大的帮助的. 二 简介 -- 切入主题 struts1主要实现从请求到servlet的映射. e.g. 现有的一个业务为实现用户的添加删除修改,按照原有的model2的原理可以实现上述功能. 2.1没有struts1之前的基于model2 mvc的实现. 直接在servlet中实现如下代码: Stri

struts2中struts.xml配置文件详解

struts.xml的常用配置 <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd"> <struts