struts-config1.1.xml

 

<?xml version="1.0" encoding="UTF-8"?>

 

<!DOCTYPE struts-config PUBLIC

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

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

<!-- struts-config.xml中的元素必须按照上述doc指令中的dtd文档定义顺序书写，本例即遵从了dtd定义顺序 -->
<!-- struts-config是整个xml的根元素，其他元素必须被包含其内 -->
<struts-config>

     <data-sources> 

      <!--

        名称:data-sources

        描述：data-sources元素定义了web App所需要使用的数据源

        数量：最多一个

        子元素:data-source

        属性：

                @key：当需要配置多个数据源时，相当于数据源的名称，用来数据源彼此间进行区别

                @type：可以使用的数据源实现的类，一般来自如下四个库

                            Poolman，开放源代码软件

                            Expresso，Jcorporate

                            JDBC Pool，开放源代码软件

                            DBCP，Jakarta

    -->

        <data-source key="firstOne" type="org.apache.commons.dbcp.BasicDataSource">

            <!--

                名称：set-property

                描述：用来设定数据源的属性

                属性：

                   @autoCommit:是否自动提交 可选值：true/false

                   @description:数据源描述

                   @driverClass:数据源使用的类

                   @maxCount:最大数据源连接数

                   @minCount:最小数据源连接数

                   @user:数据库用户

                   @password:数据库密码

                   @url:数据库url

            -->

            <set-property property="autoCommit" value="true"/>

            <set-property property="description" value="Hello!"/>

            <set-property property="driverClass" value="com.mysql.jdbc.Driver"/>

            <set-property property="maxCount" value="10"/>

            <set-property property="minCount" value="2"/>

            <set-property property="user" value="root"/>

            <set-property property="password" value=""/>

            <set-property property="url" value="jdbc:mysql://localhost:3306/helloAdmin"/>

        </data-source>

    </data-sources>

    <!--

        名称：form-beans

        描述：用来配置多个ActionForm Bean

        数量：最多一个

        子元素：form-bean

    -->

    <form-beans>

        <!--
            名称：form-bean
            描述：用来配置ActionForm Bean

            数量：任意多个

            子元素：form-property

            属性：

                  @className:指定与form-bean元素相对应的配置类，一般默认使用org.apaceh.struts.config.FormBeanConfig，如果自定义，则必须继承 FormBeanConfig

                  @name：必备属性！为当前form-bean制定一个全局唯一的标识符，使得在整个Struts框架内，可以通过该标识符来引用这个ActionForm Bean。

                  @type：必备属性！指明实现当前ActionForm Bean的完整类名。

         -->
         <form-bean name="Hello" type="myPack.Hello">

             <!--

                  名称：form-property

                  描述：用来设定ActionForm Bean的属性

                  数量：根据实际需求而定，例如，ActionForm Bean对应的一个登陆Form中有两个文本框，

                                                              name和password，ActionForm Bean中也有这两个字段，则此处编写两个form-property来设定属性

                  属性：

                         @className：指定与form-property相对应的配置类，默认是org.apache.struts.config.FormPropertyConfig，如果自定义，则必须继承FormPropertyConfig类
                         @name：所要设定的ActionForm Bean的属性名称

                         @type：所要设定的ActionForm Bean的属性值的类

                         @initial：当前属性的初值
                     -->
                     <form-property name="name" type="java.lang.String"/>
                     <form-property name="number" type="java.lang.Iteger" initial="18"/>

                 </form-bean>

           </form-beans>

           <!--
                名称：global-exceptions

                描述：处理异常

                数量：最多一个

                子元素：exception

           -->
          <global-exceptions>

               <!--
                    名称：exception
                    描述：具体定义一个异常及其处理
                    数量：任意多个
                    属性：
                            @className:指定对应exception的配置类，默认为org.apache.struts.config.ExceptionConfig

                            @handler:指定异常处理类，默认为org.apache.struts.action.ExceptionHandler

                            @key:指定在Resource Bundle种描述该异常的消息key

                            @path:指定当发生异常时，进行转发的路径
                            @scope:指定ActionMessage实例存放的范围，默认为request，另外一个可选值是session

                            @type:必须要有！指定所需要处理异常类的名字

                            @bundle:指定资源绑定

                         -->

                         <exception

                                 key=""hello.error

                                 path="/error.jsp"

                                 scope="session"

                                 type="hello.HandleError"/>

          </global-exceptions>

          <!--

               名称：global-forwards               

               描述：定义全局转发

               数量：最多一个

               子元素：forward

        -->

        <global-forwards>

            <!--
                 名称：forward

                 描述：定义一个具体的转发

                 数量：任意多个

                 属性：

                       @className:指定和forward元素对应的配置类，默认为org.apache.struts.action.ActionForward
                       @contextRelative:如果为true，则指明使用当前上下文，路径以“/”开头，默认为false

                       @name:必须配有！指明转发路径的唯一标识符

                       @path:必须配有！指明转发或者重定向的URI。必须以"/"开头。具体配置要与contextRelative相应。

                       @redirect:为true时，执行重定向操作，否则执行请求转发。默认为false

                -->

                <forward name="A" path="/a.jsp"/>

                <forward name="B" path="/hello/b.do"/>

            </global-forwards>

            <!--

                 名称：action-mappings

                 描述：定义action集合

                 数量：最多一个

                 子元素：action

              -->

             <action-mappings>

                 <!--

                     名称：action

                     描述：定义了从特定的请求路径到相应的Action类的映射

                     数量：任意多个

                     子元素：exception,forward（二者均为局部量）

                     属性：

                            @attribute:制定与当前Action相关联的ActionForm Bean在request和session范围内的名称（key）

                            @className:与Action元素对应的配置类。默认为org.apache.struts.action.ActionMapping

                            @forward:指名转发的URL路径
                            @include:指名包含的URL路径

                            @input:指名包含输入表单的URL路径，表单验证失败时，请求会被转发到该URL中
                            @name:指定和当前Acion关联的ActionForm Bean的名字。该名称必须在form-bean元素中定义过。

                            @path:指定访问Action的路径，以"/"开头，没有扩展名

                            @parameter:为当前的Action配置参数，可以在Action的execute()方法中，通过调用ActionMapping的getParameter()方法来获取参数
                            @roles:指定允许调用该Aciton的安全角色。多个角色之间用逗号分割。处理请求时，RequestProcessor会根据该配置项来决定用户是否有调用该Action的权限
                            @scope:指定ActionForm Bean的存在范围，可选值为request和session。默认为session

                            @type:指定Action类的完整类名

                            @unknown:值为true时，表示可以处理用户发出的所有无效的Action URL。默认为false

                            @validate:指定是否要先调用ActionForm Bean的validate()方法。默认为true

                         注意：如上属性中，forward/include/type三者相斥，即三者在同一Action配置中只能存在一个。

                    -->

                   <action path="/search"
                               type="addressbook.actions.SearchAction"

                               name="searchForm"

                               scope="request"
                               validate="true"
                               input="/search.jsp">
                              <forward name="success" path="/display.jsp"/>
                     </action>
               </action-mappings>
               <!--

                   名称：controller

                   描述：用于配置ActionServlet

                   数量：最多一个
                   属性：

                         @bufferSize:指定上传文件的输入缓冲的大小.默认为4096

                         @className:指定当前控制器的配置类.默认为org.apache.struts.config.ControllerConfig

                         @contentType:指定相应结果的内容类型和字符编码

                         @locale:指定是否把Locale对象保存到当前用户的session中,默认为false
                         @processorClass:指定负责处理请求的Java类的完整类名默认org.apache.struts.action.RequestProcessor
                         @tempDir:指定文件上传时的临时工作目录.如果没有设置,将才用Servlet容器为web应用分配的临时工作目录.
                         @nochache:true时,在相应结果中加入特定的头参数:Pragma ,Cache-Control,Expires防止页面被存储在可数浏览器的缓存中,默认为false
                -->
                <controller

                       contentType="text/html;charset=UTF-8"

                       locale="true"

                       processorClass="CustomRequestProcessor">

                </controller>

                <!--

                     名称:message-resources

                     描述:配置Resource Bundle

                     数量:任意多个
                     属性:
                           @className:指定和message-resources对应的配置类.默认为org.apache.struts.config.MessageResourcesConfig
                           @factory:指定资源的工厂类,默认为org.apache.struts.util.PropertyMessageResourcesFactory
               -->.

               <message-resources

                   null="false"
                   parameter="defaultResource"/>
               <!--

                   名称:plug-in

                   描述:用于配置Struts的插件

                   数量:任意多个

                   子元素:set-property

                   属性:

                         @className:指定Struts插件类.此类必须实现org.apache.struts.action.PlugIn接口

               -->

              <plug-in

                          className="org.apache.struts.validator.ValidatorPlugIn">

                    <!--
                         名称:set-property

                         描述:配置插件的属性

                         数量:任意多个
                         属性:

                                 @property:插件的属性名称

                                 @value:该名称所配置的值

                       -->

                      <set-property

                                 property="pathnames"

                                 value="/WEB-INF/validator-rules.xml,/WEB-INF/vlaidation.xml"/>

                    </plug-in>

</struts-config>