Struts2 配置文件

本章節(jié)將帶你學(xué)習(xí)Struts2 應(yīng)用程序所需的基本配置。在這里可以看到哪些將被配置到一些重要的配置文件中：web.xml、struts.xml、struts-config.xml以及struts.properties。

實(shí)際上，你可以繼續(xù)依賴(lài)于使用web.xml和struts.xml配置文件，并且你已經(jīng)在前面的章節(jié)中了解到，我們的示例是使用這兩個(gè)文件運(yùn)作的，不過(guò)為了讓你了解更多，我們還是再來(lái)說(shuō)明一下其他的文件。

web.xml文件

正如前面所討論的，這個(gè)文件為每個(gè)web應(yīng)用程序提供接入點(diǎn)。在部署描述符（web.xml）中，Struts2 應(yīng)用程序的接入點(diǎn)將會(huì)定義為一個(gè)過(guò)濾器。因此我們將在web.xml里定義一個(gè)FilterDispatcher類(lèi)的接入點(diǎn)，而這個(gè)web.xml文件需要在WebContent/WEB-INF文件夾下創(chuàng)建。

如果你開(kāi)始時(shí)沒(méi)有模板或工具（比如Eclipse或Maven2）的輔助來(lái)生成，那這就是第一個(gè)你需要配置的文件。下面是我們?cè)谏弦粋€(gè)例子中用到的web.xml的內(nèi)容。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns="http://java.sun.com/xml/ns/javaee" 
   xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
   xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
   http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
   id="WebApp_ID" version="3.0">
   
   <display-name>Struts 2</display-name>
   <welcome-file-list>
      <welcome-file>index.jsp</welcome-file>
   </welcome-file-list>
   
   <filter>
      <filter-name>struts2</filter-name>
      <filter-class>
         org.apache.struts2.dispatcher.FilterDispatcher
      </filter-class>
   </filter>

   <filter-mapping>
      <filter-name>struts2</filter-name>
      <url-pattern>/*</url-pattern>
   </filter-mapping>

</web-app>

注意，我們將Struts2 過(guò)濾器映射到 /* ，而不是 /*.action ，這意味著所有的url都會(huì)被Struts過(guò)濾器解析。當(dāng)我們學(xué)到關(guān)于注解的章節(jié)時(shí)會(huì)對(duì)這個(gè)進(jìn)行討論。

注意：自2.1.3版本開(kāi)始，ActionContextCleanUp和FilterDispatcher都由StrutsPrepareAndExecuteFilter代替。

struts.xml文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
   "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
   "http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
   <constant name="struts.devMode" value="true" />
   <package name="helloworld" extends="struts-default">
     
      <action name="hello" 
            class="cn.w3cschool.struts2.HelloWorldAction" 
            method="execute">
            <result name="success">/HelloWorld.jsp</result>
      </action>
      <-- more actions can be listed here -->

   </package>
   <-- more packages can be listed here -->

</struts>

首先要注意的是DOCTYPE（文檔類(lèi)型）。如我們的示例所示，所有的Struts配置文件都需要有正確的doctype。<struts>是根標(biāo)記元素，在其下，我們使用<package>標(biāo)簽聲明不同的包。 這里的<package>標(biāo)簽允許配置的分離和模塊化。這在你進(jìn)行一個(gè)大的項(xiàng)目并且項(xiàng)目分為多個(gè)不同的模塊時(shí)，是非常有用的。

如果您的項(xiàng)目有三個(gè)域：business_applicaiton、customer_application和staff_application的話，你可以創(chuàng)建三個(gè)包，并將相關(guān)的Actions存儲(chǔ)到相應(yīng)的包中。 <package>標(biāo)簽具有以下屬性：

<constant>標(biāo)簽以及name和value屬性將用于覆蓋default.properties中定義的任一屬性，就像我們?cè)O(shè)置的struts.devMode屬性一樣。設(shè)置struts.devMode屬性允許我們?cè)谌罩疚募胁榭锤嗟恼{(diào)試消息。

我們定義<action>標(biāo)簽對(duì)應(yīng)于我們想要訪問(wèn)的每個(gè)URL，并且使用execute()方法定義一個(gè)訪問(wèn)相應(yīng)的URL時(shí)將要訪問(wèn)的類(lèi)。

Results（結(jié)果）確定在執(zhí)行操作后返回到瀏覽器的內(nèi)容，而從操作返回的字符串應(yīng)該是結(jié)果的名稱(chēng)。 Results按上述方式配置，或作為“全局”結(jié)果配置，可用于包中的每個(gè)操作。 Results有

和

屬性可選，默認(rèn)的name值是“success”。

Struts.xml文件可以隨著時(shí)間的推移而增長(zhǎng)，因此通過(guò)包打破它是使它模塊化的一種方式，但struts提供了另一種模塊化struts.xml文件的方法，你可以將文件拆分為多個(gè)xml文件，并用以下方式導(dǎo)入它們。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
     <include file="my-struts1.xml"/>
     <include file="my-struts2.xml"/>
</struts>

我們沒(méi)有覆蓋的另一個(gè)配置文件是struts-default.xml。此文件包含Struts的標(biāo)準(zhǔn)配置設(shè)置，你不必再為99.99％的項(xiàng)目重復(fù)這些設(shè)置。 因此，我們不會(huì)深入了解這個(gè)文件的太多細(xì)節(jié)。如果你有興趣，可以查看在struts2-core-2.2.3.jar文件中可用的default.properties文件。

struts-config.xml文件

struts-config.xml配置文件是Web Client中View和Model組件之間的鏈接，但在你99.99％的項(xiàng)目里你不必使用這些設(shè)置。 struts-config.xml配置文件包含以下主要元素：

下面是struts-config.xml文件的示例：

<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE struts-config PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 1.0//EN"
"http://jakarta.apache.org/struts/dtds/struts-config_1_0.dtd">

<struts-config>

   <!-- ========== Form Bean Definitions ============ -->
   <form-beans>
      <form-bean name="login" type="test.struts.LoginForm" />
   </form-beans>

   <!-- ========== Global Forward Definitions ========= -->
   <global-forwards>
   </global-forwards>

   <!-- ========== Action Mapping Definitions ======== -->
   <action-mappings>
      <action
         path="/login"
         type="test.struts.LoginAction" >

         <forward name="valid" path="/jsp/MainMenu.jsp" />
         <forward name="invalid" path="/jsp/LoginView.jsp" />
      </action>
   </action-mappings>

   <!-- ========== Controller Definitions ======== -->
   <controller 
      contentType="text/html;charset=UTF-8"
      debug="3"
      maxFileSize="1.618M"
      locale="true"
      nocache="true"/>

</struts-config>

有關(guān)struts-config.xml文件的更多詳細(xì)內(nèi)容，可查看Struts Documentation。

struts.properties文件

這個(gè)配置文件提供了一種機(jī)制來(lái)改變框架的默認(rèn)行為。實(shí)際上，struts.properties配置文件中包含的所有屬性也可以在web.xml中配置使用init-param，以及在struts.xml配置文件中使用constant標(biāo)簽。 但如果你想保持事件獨(dú)立以及保留更多struts細(xì)節(jié)，那么你可以在WEB-INF/classes文件夾下創(chuàng)建這個(gè)文件。

文件中配置的值將覆蓋

中配置的默認(rèn)值，這些值包含在struts2-core-x.y.z.jar分布中。有一些屬性，你可以考慮改為使用

文件：

### When set to true, Struts will act much more friendly for developers
struts.devMode = true

### Enables reloading of internationalization files
struts.i18n.reload = true

### Enables reloading of XML configuration files
struts.configuration.xml.reload = true

### Sets the port that the server is run on
struts.url.http.port = 8080

這里任何以＃（hash）開(kāi)頭的行都將被假定為注釋?zhuān)⑶宜鼤?huì)被Struts 2默認(rèn)忽略。