Struts配置文件详解(2)

关于 Struts中 struts-config.xml文件的攻略(简)

这里我们将开始讨论Jakarta Struts中的核心文件struts-config.xml文件。在使用Struts组件的时候我们都需要用到这个文件。

我们可以通过配置文件来配置各种组件，例如数据源DataSource,表单类FormBean,全局异常GlobalException,全局转向GlobalForwars,行为映射ActionMappings,控制器Controller,消息资源MessageResources,以及插件Plugins。

首先大略看一下一个struts-config.xml配置文件。下文中介绍了最高层级top-level的元素项。

<?xml version="1.0" encoding="ISO-8859-1" ?>

<!DOCTYPE struts-config PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 1.1//EN"
"http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd">

<struts-config>

  <data-sources>   <!--数据源的配置-->
    <data-source
      type="org.apache.commons.dbcp.BasicDataSource">
      <set-property property="driverClassName"
        value="com.mysql.jdbc.Driver" />
      <set-property property="url"
        value="jdbc:mysql://localhost/stocks" />
      <set-property property="username"
        value="YOUR USERNAME" />
      <set-property property="password"
        value="YOUR PASSWORD" />
    </data-source>
  </data-sources>
  <form-beans> <!--表单类的配置-->
    <form-bean name="registrationForm"
      type="com.wrox.RegistrationForm"/>
  </form-beans>

  <global-exceptions>  <!--全局异常的配置-->
    <exception
      key="com.wrox.error"
      type="java.io.Exception"
      handler="com.wrox.ExceptionHandler">
  </global-exceptions>

  <global-forwards>  <!--全局转向的配置-->
    <forward name="registration" path="/registration.jsp"/>
  </global-forwards>

  <action-mappings> <!--行为映射的配置-->
    <action path="/saveRegistration"
      type="com.wrox.SaveRegistrationAction"
      name="registrationForm"
      scope="request"
      input="registration"/>
  </action-mappings>


  <controller> <!--控制器的配置-->
    <set-property property="inputForward" value="true"/>
  </controller>

  <!--消息资源的配置-->
  <message-resources
    parameter="com.wrox.ApplicationResources"/>

  <!--插件的配置-->
  <plug-in className="com.wrox.plugins.ModuleConfigVerifier"/>

</struts-config>

在这个配置文件中，每一组元素的先后排列次序是很重要的。换句话说就是在struts-config.xml文件中这些元素都须依照如此的先后次序进行排列。如果排列的次序打乱的话，Struts会在启动时抛出异常。

添加数据原 Adding a DataSource

首先我们需要进行配置的就是数据源。配置数据源有2中方式，一种采用自己开发的组件直接操作数据源实例。另一种方法就是我们将在这里进行演示的方法，通过修改struts配置文件来完成数据源的配置工作。

当我们开始描述数据源实例的时候，我们必须使用<data-sources>的元素项。这个元素项中可以包括多个<data-source>的子元素项，这样可以用来描述每一个数据源实例。在下面的代码中描述了<data-sources>的子元素项中包含了一个单独的<data-source>的子元素项。

<data-sources> 
  <data-source
    type="org.apache.commons.dbcp.BasicDataSource">
    <set-property property="driverClassName"
      value="com.mysql.jdbc.Driver" />
    <set-property property="url"
      value="jdbc:mysql://localhost/stocks" />
    <set-property property="username"
      value="YOUR USERNAME" />
    <set-property property="password"
      value="YOUR PASSWORD" />
  </data-source>
</data-sources>

<data-source>条目的属性

type 这是用来定义含有完整命名控件的DataSource对象。这个类必须是扩展javax.sql.DataSource,并且能进行<set-property>的子元素项的设置操作。关于DB的pool的设置将安排另外的文档进行编写

className 用于设定配置类所用。详细描述这里省略。

key 这是用来定义多数据源的时候来使用。
例如采用多数据源设定的时候代码如下：
<data-sources>
   <data-source key="A" type="org.apache.commons.dbcp.BasicDataSource">
      ... properties as before ...
   </data-source>
   <data-source key="B" type="org.apache.commons.dbcp.BasicDataSource">
      ... properties as before ...
   </data-source>
   ...
</data-sources>

而我们在代码中使用的时候可以如下：
   ...
   try {
      dataSourceA = getDataSource(request, "A");
      dataSourceB = getDataSource(request, "B");
   ...

添加表单类的定义 Adding FormBean Definitions

<form-bean> 子元素项通常用户描述一个表单类的实例。它的构造语法如下：

<form-beans>
  <form-bean name="name used to uniquely identify a FormBean"
    type="fully qualified class name of FormBean" />
</form-beans>

首先这里注意的是<form-bean>必须嵌套在<form-beans>之中，

name 是表示唯一的能识别的bean名称。这个值通常用于行为映射并绑定一个表单类到一个行为上。

type 则是类文件的完整命空间及文件名称。

例如
<form-beans>
  <form-bean name="lookupForm"
    type="wrox.LookupForm" />
</form-beans>


添加全局异常处理 Adding Global Exceptions

全局异常处理子元素项通常可以定义多个异常处理的子元素项。语法结构如下：

<global-exceptions>
  <exception key="Key" type="Exception Type"
    handler="Exception Handler">
</global-exceptions>

实例如下：
<global-exceptions>
  <exception
    key="wrox"
    type="ch15.WroxException"
    handler="ch15.WroxExceptionHandler">
</global-exceptions>


添加全局转向 Adding Global Forwards

在<global-forwards>中可以定义多个<forward>子元素项，语法构造如下：
<global-forwards>
  <forward name="unique target identifier"
    path="context-relative path to targetted resource "/>
</global-forwards>

实例如下：
<global-forwards>
  <forward name="success" path="/welcome.jsp"/>
  <forward name="failure" path="/index.jsp"/>
</global-forwards>

添加行为 Adding Actions
<Action-mappings>子元素项可以定义多个<action>子元素项。它就好比是<action>的一个容器，因此我们将着重讨论每一个<action>的子元素项。

<action>子元素项通常用来描述一个正对ActionServlet的行为的实例。它的语法构造如下：

<action-mappings>

  <action
    path="context-relative path mapping action to a request"
    type="fully qualified class name of the Action class"
    name="the name of the form bean bound to this Action">
    <forward name="forwardname1" path="context-relative path"/>
    <forward name="forwardname2" path="context-relative path"/>
  </action>

</action-mappings>

注意在上面的部分代码中，包含有2个<forward>子元素项，而这些<forward>仅能被当前的<action>所引用。

实例代码如下：
<action-mappings>

  <action path="/lookupAction"
    type="wrox.LookupAction"
    name="LookupForm"
    scope="request"
    validate="true"
    input="/index.jsp">
    <forward name="success" path="/quote.jsp"/>
    <forward name="faliue" path="/index.jsp"/>
  </action>

</action-mappings>

添加控制器 Adding Controller Elements

控制器元素项用于定义一个控制配置类，通常用于应用服务运行模块进行配置所用。实例如下：

<controller
  processorClass="ch04.WroxRequestProcessor"
  nocache="true" />

添加消息资源 Adding Message Resources

添加插件 Adding Plugins
<plug-in>元素项通常用于添加插件至struts控制器中。struts的插件用于分配资源或者数据库预备连接资源或者是JNDI资源。语法结构如下：
<plug-in className="Fully qualified Plugin class name"/>

实例如下

<plug-in className="ch04.WroxPlugin"/>


消息资源对象用来描述MessageResource对象，语法结构如下：
<message-resources
  parameter="configuration parameter"
  key="main" />

是列代码如下：
<message-resources
  parameter="ch15.MainResources"
  key="main" />