Structs 學習筆記
一、Web.xml文件的基本配置
第一步:配置ActionServlet
actionorg.appache.structs.ActionServlet
action
*.do
注意:不管應用中包含多少個子應用,都只需配置一個ActionServlet,因為ActionServlet支持多線程,目前的Structs框架只允許在應用中配置一個ActionServlet。
第二步：初始化參數對Servlet的運行環境進行初始化配置
action
org.appache.structs.ActionServlet
config
/WEB-INF/structs-config.xml
Struts1.1中用到的初始化參數如下：
參數名 含義/默認值
config 以相對路徑的方式指明Struts應用程序的配置文件位置。如不設
置，則默認值為/WEB-INF/struts-config.xml。
config/sub1 以相對路徑的方式指明子應用程序的配置文件位置，一般來說，
很少用到子應用程序，在此不多描述。
debug 設置Servlet的debug級別，控制日志記錄的詳細程度。默認為0，
記錄相對最少的日志信息。
detail 設置Digester的debug級別，Digester是Struts框架所使用的用
來解析xml配置文件的一個框架，通過該設置，可以查看不同詳細等級的解析日志。默認為0，記錄相對最少的日志信息。
第三步：配置歡迎清單
當客戶訪問Web應用時，如果僅僅給出Web應用的Root URL，沒用指定具體的文件名，Web容器會自動調用Web應用的歡迎文件。
welcome.jsp
index.jsp
說明：可以包含多個子元素，首先查找第一個文件。
由于元素中不能配置Servlet映射，因此不能直接把Structs的Action作為歡迎文件，可以采用一種變通的方法來實現在歡迎文件中調用Structs Action。首先，在Structs配置文件中為被調用的Action創建一個全局的轉發項，例如：
創建一個welcome.jsp的文件
最后在web.xml文件中把welcome.jsp文件配置為歡迎文件，代碼如下：
welcome.jsp
在welcome.jsp中的代碼如下：
第四步：配置錯誤處理
404
/commom/404.jsp
505
/commom/505.jsp
也可以為Web容器捕獲的Java異常配置,需要設置子元素，它用于指定Java異常類。Web容器可能捕獲如下異常：
RuntimeException或Error ServletException或它的子類 IOException或它的子類
java.io.IOException
/common/system_ioerror.jsp
第五步：配置Structs標簽庫
使用客戶化的標簽庫，要配置它們
/WEB-INF/structs-html.tld
/WEB-INF/structs-html.tld
用于指定標簽庫的相對或者絕對URI地址，Web應用根據這一URI來訪問標簽庫。指定標簽描述文件在文件資源系統中的物理位置。
二、Struts-config.xml配置文件
Struts的核心是struts-config.xml配置文件，在這個文件里描述了所有的Struts組件。
在這里包括配置主要的組件及次要的組件，下面是struts-config.xml包含主要元素的內容：
1. struts-config.xml的主要元素：
注意：以上各元素的順序是非常重要的，你的struts-config.xml配置文件必須按照這個順序進行配置，否則在你的容器啟動的時候就會出錯。
2. 配置JDBC數據源
其配置形式如下：
的屬性及其描述信息如下：
屬 性 描 述 信 息
Key 綁定在ServletContext上的DataSource實例的索引鍵， 若不設定則缺
省為Action.DATA_SOURCE_KEY，如果在應用程序中有多于一個的
DataSource， 則必須設置Key的值。
DriverClass 所用的JDBC驅動類(必須的)如：
com.microsoft.jdbc.sqlserver.SQLServerDriver
url 所用的JDBC的URL(必須的)如：
jdbc:microsoft:sqlserver://xg088:1433
MaxCount 同時打開的最大連結數，缺省值為2(可選的)
MinCount 同時打開的最小連結數，缺省值為1(可選的)
User 連結到數據庫的用戶名(必須的)
Password 連結到數據庫的密碼(必須的)
Description 關于DataSource的描述信息(可選的)
ReadOnly 如果設為true，則表示該連結是只讀的，缺省為false。(可選的)
LoginTimeout 創建連結的最大允許時間，以秒為單位。(可選的)
AutoCommit 如果為true，則每次execute之后會強制回滾。缺省為true。(可選的)
舉例說明：
在代碼中獲取數據庫連接的方法為：
DataSource ds=this.getDataSource(request," WILEY_DATA_SOURCE ");
Connection con = ds.getConnection();
3. 配置FormBean
用來定義將要綁定到Action的FormBean的實例。語法如下：
例：
4. 配置全局轉發
全局轉發可以定義幾個子元素，struts首先會在元素中找對應的，
若找不到，則到全局轉發配置中找。語法如下：
除了name及path屬性之外，還有一個redirect屬性，如果redirect設為true的時候，則用 HttpServletResponse.sendRedirect()方法，否則用RequestDispatcher.forward()方法，缺省為false。
注：如果為true，則用HttpServletResponse.sendRedirect()方法，此時存儲在原來的HttpServletRequest中的值將會丟失。
例子：
5. 配置
它可以定義幾個子元素，它主要是定義Action實例到ActionServlet類中，語法如下：
屬性及其描述信息如下：
屬 性 描 述 信 息
Path 在瀏覽器的URL中輸入的字符(必須的)
Type 連結到本映射的Action的全稱(可選的)
Name 與本操作關聯的Action Bean在中定義name名(可選的)
Scope 指定ActionForm Bean的作用域(session和request)，缺省為session。(可選的)
Input 當Bean發生t誤時返回的控制。(可選的)
ClassName 指定一個調用這個Action類的ActionMapping類的全名。缺省用
org.apache.struts.action.ActionMapping，(可選的)
Forward 指定處理相應請求所對應的JSP頁面。(可選的)
Include 如果沒有forward的時候，它起forward的作用。(可選的)
Validate 若為true，則會調用ActionForm的validate()方法，否則不調用，缺省為true。（可選的）
例子：
6. 配置RequestProcessor
在struts-config.xml文件中用子元素來定義RequestProcessor，其語法格式如下：
元素屬性及其描述信息如下：
屬 性 描 述
processorClass 指定自定義的RequestProcessor類的全名
BufferSize 指定用來下載所用的緩存大小。缺省是4096字節。
contentType 定義response文本類型，缺省是text/html
Debug 定義當前系統的除錯級別，缺省是0
Locale 如果是true，則在用戶的session中存放Locale對象，缺省為true
maxFileSize 指定下載文件最大的大小。缺省是250M
multipartClass 指定去代替org.apache.struts.upload.DiskMultipartRequestHandler類的類的全名。
Nocache 如果是true，則會關閉每個response的緩存功能。缺省是false
TempDir 指定上載文件所用的臨時目錄。缺省值由容器決定
例子：
①
②
7. 配置Message Resources
在struts-config.xml文件中用元素來定義消息資源。其語法如下：
元素屬性及其描述信息如下：
屬 性 描 述
Parameter 給定資源文件全名
ClassName 定義處理消息資源的類名的全名，缺省是org.apache.struts.config.MessageResourcesConfig
Factory 定義MessageResourcesFactory類的全名，缺省是
org.apache.struts.util.property.MessageResourcesFacotry
Key 定義綁定在這個資源包中的ServletContext的屬性主鍵，缺省值是Action.MESSAGES_KEY.
Null 如果為true，則找不到消息key時，則返回null，缺省是true.
例子：
①
②
注意：設定key的目的如下：
這里說明要到StorefrontImageResources.properties資源文件中找主鍵值是”navbar.home.image”所對應的值。
這里StorefrontImageResources.properties的內容如下：
……
navbar.home.image=/images/home.gif
navbar.home.image.alt=Home
……
此處navbar.home.image.alt說明的和![”Home”……/]()
一樣。