Struts2 組態檔案

本章將帶你通過一個Struts2應用程式所需的基本組態。在這裡，我們將看到在一些重要的組態檔案，將組態檔案：web.xml ，struts.xml，struts-config.xml和struts.properties

使用web.xml和struts.xml的組態檔案，並在前面的章節中，已經看到我們的例子中曾使用這兩個檔案，讓我解釋以及其他檔案。

web.xml 檔案:

web.xml組態檔案是一個J2EE的組態檔案，決定如何處理元素的HTTP請求由servlet容器。嚴格來說它不是一個Struts2的組態檔案，但它是Struts2的工作需要進行組態的檔案。

如前所述，這個檔案為任何Web應用程式提供了一個切入點。 Struts2 應用程式的入口點，將是一個部署描述符（web.xml）中定義的過濾器。因此，我們將定義在web.xml中的FilterDispatcher是類的項。需要建立的檔案夾的WebContent/ WEB-INF下web.xml檔案。

這是第一個組態檔案，將需要組態，如果沒有一個模板或工具，可生成（如Eclipse或Maven2的）的幫助下開始。以下是web.xml檔案中的內容，我們用我們的最後一個例子。

<?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>

請注意，我們Struts 2的過濾器對映為/*， /*.action這意味著所有的URL將被解析struts的過濾器。我們將覆蓋時，我們將通過“注釋”一章。

struts.xml 檔案:

struts.xml檔案中包含的組態資訊，將為動作開發被修改。這個檔案可以被用來覆蓋預設設定的應用程式，例如struts.devMode=false 和其他設定中定義的屬性檔案。這個檔案可以被檔案夾WEB-INF/classes下建立 

讓我們來看看在我們struts.xml檔案中建立的Hello World的例子在前面的章節中解釋。

<?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="com.yiibai.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。所有的Struts組態檔案需要有正確的doctype所示，我們的小例子。 <struts>根標籤的元素，我們宣告不同的包使用<package>標籤。 <package>允許分離和模組化的組態。這是非常有用的，當有一個大專案，專案被劃分成不同的模組。

也就是說，如果專案有三個域 - business_applicaiton ，customer_application 和 staff_application，可以建立三個包和儲存相關的動作，在適當的包。包裝標籤具有以下屬性：

隨著name和value屬性恆定的標籤將被用於覆蓋default.properties中定義以下屬性，就像我們剛剛設定struts.devMode屬性。 Settingstruts.devMode屬性可以讓我們看到更多的偵錯訊息，在紀錄檔檔案中。

我們定義動作標記對應的每一個URL，我們要存取，我們定義了一個類的execute()方法，將存取時，我們將存取相應的URL。

結果決定得到執行動作後返回給瀏覽器。從操作返回的字串應該是一個結果的名稱。以上，或者作為一個“global”的結果，可包中的每一個動作，結果被組態每次動作。結果有可選的名稱和型別屬性。預設名稱的值是“success”。

隨著時間的推移，struts.xml檔案可以逐步擴充套件，打破它包是模組化的方式之一，但Struts提供了另一種模組化struts.xml檔案。可以將檔案分割為多個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>
     <include file="my-struts1.xml"/>
     <include file="my-struts2.xml"/>
</struts>

其他的組態檔案，我們還沒有涉及到在struts-default.xml中。這個檔案包含了Struts的標準組態設定，就不必去觸控專案的這些99.99％設定。出於這個原因，我們不打算對這個檔案介紹太多。如果有興趣，不妨看看到struts2的核心2.2.3.jar檔案default.properties檔案。

struts-config.xml 檔案:

在struts-config.xml 組態檔案是在Web用戶端元件的檢視和模型之間的連結，但99.99％不會有觸碰這些設定在專案中。基本組態檔案包含以下主要內容：

下面是範例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>

struts-config.xml檔案的更多詳細資訊，請檢視 Struts 文件。

struts.properties 檔案

此組態檔案提供了一種機制來改變框架的預設行為。 struts.properties組態檔案內包含的屬性其實也可以被組態在web.xml中使用init-param中，以及在struts.xml的組態檔案中使用恆定的標籤。但如果喜歡保持獨立和特定Struts，那麼可以建立這個檔案的檔案夾下的WEB-INF/classes。

在這個檔案中組態的值將覆蓋預設值組態default.properties這是包含在struts2-core-x.y.z.jar 分布。有幾個的屬性，可能會考慮改變使用struts.properties檔案：

### 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

這裡井號（＃）開頭的行會被假定作為註釋，它將被Struts 2忽略。