Struts-config.xml配置文件讲解

Struts-config.xml配置文件讲解

１．<struts-config>元素：struts配置文件的根元素。（和它对应的配置类为org.apache.struts.config.MouleConfig类）

      8个子元素：（先后顺序不能变）

              <data-sources>，

              <form-beans>，

              <global-exceptions>，

              <global-forwards>，

              <action-mappings>，

              <controller / >，
               <message-resources / >，
               <plug-in />。

２．<data-sources>元素：用来配置应用所需要的数据源。

    包含0，1或者多个<data-source>元素，该元素用于配置特定的数据源。<data-source>元素包含多个<set-property>元素，<set-property>元素用于设置数据源的各种属性。

 Example：

    <data-sources>

        <data-source type=”org.apache.commons.dbcp.BasicDataSource”>

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

            <set-property property=”description” value=”MYSQL Data Source”/>

            <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/数据库名称”/>

        </data-source>

    </data-sources>

配置了数据源后，就可在Action类中访问数据源了

Javax.sql.DataSource dataSource = getDataSource(request);

Javax.sql.Connection myConnection = dataSource.getConnection();

配置多个数据源：

  <data-source key=”A” type=”org.apache.commons.dbcp.BasicDataSource”>

       …property as before…

  </data-source>

<data-source key=”B” type=”org.apache.commons.dbcp.BasicDataSource”>

         …property as before…

    </data-source>

在Action中去得数据源：

    dataSourceA = getDataSource(request,”A”);

dataSourceB = getDataSource(request,”B”);

３．<form-beans>元素：用来配置多个ActionForm Bean。

    包含<form-bean>元素，该元素的属性有：

    1.className:指定和<form-bean>元素对应的配置类，默认值为org.apache.struts.config.FormBeanConfig。如果在这里设置自定义类，则该类必须扩展FormBeanConfig类。

    2.name:指定该ActionForm的唯一标识符，整个struts框架利用该标识符来引用这个bean。（必需的）

    3.type:指定ActionForm类的完整实现类名（包括路径）。（必需的）

    Example1:

          <form-bean name="UserLoginForm"

                        type="com.free.web.struts.form.UserLoginForm">

           </form-bean>

Example2（动态ActionForm）:

<!-- sample form bean descriptor for a DynaActionForm

        <form-bean

            name="logonForm"

            type="org.apache.struts.action.DynaActionForm">

            <form-property

                name="username"

                type="java.lang.String"/>

            <form-property

                name="password"

                type="java.lang.String"/>

       </form-bean>

4.<global-exceptions>元素：用于配置异常处理类。

  包含多个<exception>元素:用来设置java异常和异常处理类org.apache.struts.action.ExceptionHandler之间的映射。

   属性：className:指定和<exception>元素对应的配置类。默认值为org.apache.struts.config.ExceptionConfig。

            Handler:指定异常处理类。默认值为org.apache.struts.action.ExceptionHandler。

            Key:指定在Resource Bundle中描述该异常的消息key。

            Path:指定当一场发生时的转发路径。

            Scope:指定ActionMessages实例的存放范围，可选值包括request和session。默认值为request。

            Type:指定所需处理的异常类的名称。（必需的）

            Bundle:指定Resources Bundle。

         Example:

            <global-exceptions>

                 <exception

                      key="expired.password"

                      type="app.ExpiredPasswordException"

                      path="/changePassword.jsp"/>

            </global-exceptions>

5.<global-forwards>元素：用来声明全局的转发关系。

  包含多个<forward>元素，<forward>元素用于把一个逻辑名映射到特定的URL。

  属性：className:指定和<forward>元素对应的配置类。默认值为org.apache.struts.action.ActionForward。

           contextRelative:如果此项为true,表示当path属性以”/”开头时，给出的是相对于当前上下文的URL。默认值为false。

           Name:转发路径的逻辑名。（必需的）

           Path:指定转发或重定向的URL。（必需的）而且必须以”/”开头。contextRelative为true时，表示URL路径相对于当前上下文（context-ralative）; contextRelative为false时，表示URL路径相对于当前应用（application-ralative）;

            Redirect:此项为true,执行重定向操作；为false,执行请求转发操作。

   Example：

           <global-forwards>

           <!-- Default forward to "Welcome" action -->

           <!-- Demonstrates using index.jsp to forward -->

           <forward

                name="welcome"

                path="/Welcome.do"/>

           </global-forwards>

   如果.jsp文件把请求转发给Action,可以使用一下代码：

         <html:link forward=”forward1”>

   如果Action把请求转发给.jsp文件,可以使用一下代码：

           Return （mapping.findForward(“forward2”)）;

6.<action-mappings>元素：包含<action>元素，描述了从特定的请求路径到相应的Action类的映射。

在<action>元素中可以包含多个<exception>和<forward>元素，它们分别配置局部的异常

处理及请求转发仅被当前的Action所访问。

属性：

（1）      attribute： 设置和Action关联的ActionForm Bean在request或session范围内的属性key。例如，假定Form Bean存在于request范围内，并且此项设置为”myBean”，那么request.getAttribute(“myBean”)就可以返回该Bean的实例。

（2）      className：和<Action>元素对应的配置元素。默认值为org.apache.struts.action.ActionMapping。

（3）      forward：指定转发的URL路径。

（4）      includes：指定包含的URL路径。

（5）      input：指定包含输入表单的URL路径。当表单验证失败时，将把请求转发到该URL。

（6）      name：指定和该Action关联的ActionForm Bean的名字。该名字必须在<form-bean>元素中一定过。

（7）      path：指定访问Action的路径，它以”/”开头，没有扩展名。

（8）      parameter：指定Action的配置参数。在Action类的execute（）方法中，可以调用ActionMapping对象的getParamter（）方法来读取该配置参数。

（9）      roles:指定允许调用该Action的安全角色。多个角色之间以逗号隔开。在处理请求时，RequestProcessor会根据该配置项来决定用户是否有调用Action的权限。

（10）  scope：指定ActionForm的存在范围。可选值为request和session。默认为session

（11）  type：指定实现该Action类的真实类的路径和名称。（完整类名）

（12）  unknown：如果此项为true，表示可以处理用户发出的所有无效的ActionURL。默认值为false。

（13）  validate：指定是否要先调用ActionForm Bean的validate（）方法。默认为true

<Action>元素的forward，includes，type属性相互排斥（即只能设置其中一项）。

Example：

         <Action   path=”/search”

                   type=”addressbook.actions.SearchAction”

                   name=”searchForm”

                   scope=”request”

                   validate=”true”

                   input=”/search.jsp”>

                   <forward name=”success” path=”/display.jsp”/>

          </action>

注意：局部<forward>元素和<exception>元素的优先级大于全局的。

7.<controller>元素：用于配置ActionServlet。

  属性：

（1）      bufferSize：指定上载文件的输入缓冲的大小。默认值：4096

（2）      calssName：指定和<controller>元素对应的配置类。默认值为org.apache.struts.config.ControllerConfig。

（3）      contentType：指定响应结果的内容类型和字符编码。默认值为text/html。如果在Action或jsp网页中也设置了内容类型和字符编码，将会覆盖该设置。

（4）      locale：指定是否把Locale对象保存到当前用户的session中。默认值false

（5）      processorClass：指定负责处理请求的Java类的完整类名。默认值为org.apache.struts.action.RequestProcessor。或者扩展了该类的自定义类。

（6）      tempDir：指定处理文件上载的临时文件目录。如果没有设置此项，将采用Servlet容器为Web应用分配的临时工作目录。

（7）      nochache：如果为true，在响应结果中将加入特定的头参数：pragma，cache-control和Expires，防止页面被存储在客户浏览器的缓存中。默认值为false。

Example：

       <controller  

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

locale=”true”

processorClass=”CustomRequestProcessor”/>

8.<message-resources>元素：用来配置resource bundle，resource bundle用于存放本地化消息文本。

  属性：

（1）      className：和.<message-resources>元素对应的配置类。默认值为org.apache.struts.config.MessageResourcesConfig

（2）      factory：指定消息资源的工厂类。默认值为org.apache.struts.util.property.MessageResourcesFacotry

（3）      key：绑定在这个资源包中的ServletContext的属性主键，缺省值是Action.MESSAGES_KEY.

（4）      Null：指定MessageResources类如何处理未知的消息key。如果此项为true，将返回空字符串。如果为false，将返回类似”???global.label.missing???”的字符串，默认值为true

（5）      Parameter：指定recourse bundle的消息资源文件名。该路径相对于WEB-INF/classes而言。

Example:

         <message-resources parameter="MessageResources" />

9.<plug-in>元素：用于配置struts插件。

  属性：className：指定struts插件类。该插件类必须实现org.apache.struts.action.PlugIn接口。

  Example：

   （1）<plug-in className="org.apache.struts.tiles.TilesPlugin" >

      <!-- Path to XML definition file -->

      <set-property property="definitions-config"

                       value="/WEB-INF/tiles-defs.xml" />

      <!-- Set Module-awareness to true -->

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

    </plug-in>

   

   （2）<plug-in className="org.apache.struts.validator.ValidatorPlugIn">

    <set-property

        property="pathnames"

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

  </plug-in>