Gay Bird

          登高者必自卑,行遠(yuǎn)者必自邇,在這個(gè)世界上,重要的不是你正站在那里,而是你正朝什么方向移動(dòng)......

          struts2筆記 - 配置

          與Struts 1.X不同,Struts2引入了WebWork的配置機(jī)制,在很大程度上提高了配置的靈活度。通過(guò)使用配置可以配置如下內(nèi)容:

          配置類型

          配置文件

          Struts2 參數(shù)配置

          struts.properties

          Struts2 Action 配置

          struts.xml

          Struts2 Result 配置

          struts.xml

          Struts2 Exception Handling 配置

          struts.xml

          Struts2 Intercept 配置

          struts.xml

          Struts2 多配置文件

          struts.xml

           

          struts.properties文件在WEB-INF/classes目錄下存放。

          這個(gè)文件用來(lái)配置Struts2系統(tǒng)的一些基本規(guī)約,所有在struts.properties中配置的內(nèi)容都可以在struts.xml中配置,或者web.xml中在struts2 filter中配置,例如:

          Struts.properties中的如下配置:

          struts.i18n.encoding=UTF-8

          相當(dāng)于struts.xml中的如下配置:

          <constant name=“struts.i18n.encoding” value=“true” />

          相當(dāng)于web.xml中的如下配置:

          <filter>

              <filter-name>struts</filter-name>

              <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>

              <init-param>

                  <param-name>struts.i18n.encoding</param-name>

                  <param-value>true</param-value>

              </init-param>

          </filter>

           

          Package配置

          使用package可以將邏輯上相關(guān)的一組Action,Result,Intercepter等組件分為一組,Package有些想對(duì)象,可以繼承其他的Package,也可以被其他package繼承,甚至可以定義抽象的Package。

          Package的可以使用的屬性:

          屬性

          是否必須

          說(shuō)明

          name

          Package的表示,為了讓其他的package引用

          extends

          從哪個(gè)package集成行為

          namespace

          參考Namespace配置說(shuō)明

          @TODO Namespace配置說(shuō)明

          abstract

          定義這個(gè)package為抽象的,這個(gè)package中不需要定義action

          由于struts.xml文件是自上而下解析的,所以被集成的package要放在集成package的前邊。

          Namespace配置

          Namespace將action分成邏輯上的不同模塊,每一個(gè)模塊有自己獨(dú)立的前綴。使用namespace可以有效的避免action重名的沖突,例如每一個(gè)package都可以有自己獨(dú)立的Menu和Help action,但是事項(xiàng)方式各有不同。Struts2標(biāo)簽帶有namespace選項(xiàng),可以根據(jù)namespace的不同向服務(wù)器提交不同的package的action的請(qǐng)求。

          “/”表示跟namespace,所有直接在應(yīng)用程序上下文環(huán)境下的請(qǐng)求(Context)都在這個(gè)package中查找。

          “”表示默認(rèn)namespace,當(dāng)所有的namespace中都找不到的時(shí)候就在這個(gè)namespace中尋找,例如我們上面的login應(yīng)用程序。

          例如,有如下配置:

          <package name="default">

          <action name="foo" class="mypackage.simpleAction>

                  <result name="success" type="dispatcher">

                     greeting.jsp

                 </result>

              </action>

              <action name="bar" class="mypackage.simpleAction">

                 <result name="success" type="dispatcher">bar1.jsp</result>

              </action>

          </package>

          <package name="mypackage1" namespace="/">

              <action name="moo" class="mypackage.simpleAction">

                  <result name="success" type="dispatcher">moo.jsp</result>

              </action>

          </package>

          <package name="mypackage2" namespace="/barspace">

              <action name="bar" class="mypackage.simpleAction">

                 <result name="success" type="dispatcher">bar2.jsp</result>

              </action>

          </package>

          1 如果請(qǐng)求為/barspace/bar.action

          查找namespace/barspace,如果找到bar則執(zhí)行對(duì)應(yīng)的action,否則將會(huì)查找默認(rèn)的namespace,在上面的例子中,在barspace中存在名字位bar的action,所以這個(gè)action將會(huì)被執(zhí)行,如果返回結(jié)果為success,則畫面將定為到bar2.jsp

          2 如果請(qǐng)求為/ moo.action

          根namespace('/')被查找,如果moo action存在則執(zhí)行否則查詢默認(rèn)的namespace,上面的例子中,根namespace中存在moo action,所以改action被調(diào)用,返回success的情況下畫面將定位到moo.jsp

          Action配置

          在struts2框架中每一個(gè)Action是一個(gè)工作單元。Action負(fù)責(zé)將一個(gè)請(qǐng)求對(duì)應(yīng)到一個(gè)Action處理上去,每當(dāng)一個(gè)Action類匹配一個(gè)請(qǐng)求的時(shí)候,這個(gè)Action類就會(huì)被Struts2框架調(diào)用。

          一個(gè)Action配置示例:

          <action name="Logon" class="tutorial.Logon">

           <result type="redirect-action">Menu</result>

           <result name="input">/tutorial/Logon.jsp</result>

          </action>

          每一個(gè)Action可以配置多個(gè)result,多個(gè)ExceptionHandler,多個(gè)Intercepter,但是只能有一個(gè)name,這個(gè)name和package的namespace來(lái)唯一區(qū)別一個(gè)Action。

          每當(dāng)struts2框架接受到一個(gè)請(qǐng)求的時(shí)候,他會(huì)去掉Host,Application和后綴等信息,得到Action的名字,例如如下的請(qǐng)求將得到Welcome這個(gè)Action。

          http://www.planetstruts.org/struts2-mailreader/Welcome.action

          在一個(gè)Struts2應(yīng)用程序中,一個(gè)指向Action的鏈接通常有Struts Tag產(chǎn)生,這個(gè)Tag只需要指定Action的名字,Struts框架會(huì)自動(dòng)添加諸如后綴等的擴(kuò)展,例如:

          <s:form action="Hello">

              <s:textfield label="Please enter your name" name="name"/>

              <s:submit/>

          </s:form>

          將產(chǎn)生一個(gè)如下的鏈接的請(qǐng)求:

          http://Hostname:post/appname/Hello.action

           

          在定義Action的名字的時(shí)候不要使用.和/來(lái)明明,最好使用英文字母和下劃線。

          Action中的方法

          Action的默認(rèn)入口方法由xwork2的Action接口來(lái)定義,代碼清單為:

          public interface Action {

              public String execute() throws Exception;

          }

          有些時(shí)候我們想指定一個(gè)Action的多個(gè)方法,我們可以做如下兩步:

          <!--[if !supportLists]-->1    <!--[endif]-->建立一些execute簽名相同的方法,例如:

          Public String forward() throws Exception

          <!--[if !supportLists]-->2    <!--[endif]-->在Action配置的時(shí)候使用method屬性,例如:

              <action name="delete" class="example.CrudAction" method="delete">

          Action中的方法通配符

          有些時(shí)候?qū)ction中方法的調(diào)用滿足一定的規(guī)律,例如edit Action對(duì)應(yīng)edit方法,delete Action對(duì)應(yīng) delete方法,這個(gè)時(shí)候我們可以使用方法通配符,例如:

          <action name="*Crud" class="example.Crud" method="{1}">

          這時(shí),editCrud Action的引用將調(diào)用edit方法,同理,deleteCrud Action的引用將調(diào)用delete 方法。

          另外一種比較常用的方式是使用下劃線分割,例如:

          <action name="Crud_*" class="example.Crud" method="{1}">

          這樣當(dāng)遇到如下調(diào)用的時(shí)候可以找到對(duì)應(yīng)的方法。

          "action=Crud_input"  => input方法

          "action=Crud_delete" => delete方法

          通配符和普通的配置具有相同的地位,可以結(jié)合使用框架的所有其他功能。

          默認(rèn)的Action

          當(dāng)我們沒(méi)有指定Action的class屬性的時(shí)候,例如:

          <action name="Hello">

          我們默認(rèn)使用com.opensymphony.xwork.ActionSupport

          ActionSupport有兩個(gè)方法input和execute,每個(gè)方法都是簡(jiǎn)單的返回SUCCESS。

          Post-Back Action

          可以使用如下畫面達(dá)到字畫面刷新的效果

          <s:form>

              <s:textfield label="Please enter your name" name="name"/>

              <s:submit/>

          </s:form>

          默認(rèn)Action

          通常情況下,請(qǐng)求的Action不存在的情況下,Struts2框架會(huì)返回一個(gè)Error畫面:“404 - Page not found”,有些時(shí)候或許我們不想出現(xiàn)一個(gè)控制之外的錯(cuò)誤畫面,我們可以指定一個(gè)默認(rèn)的Action,在請(qǐng)求的Action不存在的情況下,調(diào)用默認(rèn)的Action,通過(guò)如下配置可以達(dá)到要求:

          <package name="Hello" extends="action-default">

          <default-action-ref name="UnderConstruction">

          <action name="UnderConstruction">

           <result>/UnderConstruction.jsp</result>

          </action>"

          默認(rèn)通配符

          <action name="*" >

           <result>/{1}.jsp</result>

          </action>

          每個(gè)Action將會(huì)被映射到以自己名字明明的JSP上。

           Result配置

          Action里提供了五個(gè)默認(rèn)的返回值:

          String SUCCESS = "success";

          String NONE    = "none";

          String ERROR   = "error";

          String INPUT   = "input";

          String LOGIN   = "login";

          默認(rèn)的一些配置

          package下有如下配置

          <result-types>

          <result-type name="dispatcher"

          class="org.apache.struts2.dispatcher.ServletDispatcherResult"

              default="true" />

          </result-types>

          如果一個(gè)Result的type沒(méi)有設(shè)定的話,默認(rèn)為dispthcher。Dispatcher的意思是轉(zhuǎn)向一個(gè)JSP等的資源。

          另外如果Result的name沒(méi)有設(shè)定的話,默認(rèn)為SUCCESS。

          一個(gè)完整的Result的聲明如下:

          <result name="success" type="dispatcher">

              <param name="location">/ThankYou.jsp</param>

          </result>

          考慮到默認(rèn)值可以寫成:

          <result>

              <param name="location">/ThankYou.jsp</param>

          </result>

          另外也可以簡(jiǎn)寫為:

          <result>/ThankYou.jsp</result>

          另外為了方便,可以在package中設(shè)置一些全局的result,例如:

          <global-results>

           <result name="error">/Error.jsp</result>

           <result name="invalid.token">/Error.jsp</result>

           <result name="login" type="redirect-action">Logon_input</result>

          </global-results>

          動(dòng)態(tài)結(jié)果

          有些時(shí)候,在Action執(zhí)行完畢之后才知道Result的指向,可以使用如下的方法:

          Action

          private String nextAction;

          public String getNextAction() {

              return nextAction;

          }

          public String execute() throws Exception {

           return “next”;

          }

          struts.xml

          <action name="fragment" class="FragmentAction">

           <result name="next" type="redirect-action">${nextAction}</result>

          </action>

          3.4節(jié) ActionSupport

          Action類不一定非要實(shí)現(xiàn)Action接口或者集成ActionSupport類,也就是說(shuō)Action可以是一個(gè)POJO對(duì)象,只不過(guò)提供一個(gè)返回String的方法。如果Action類不實(shí)現(xiàn)Action接口,也不從ActionSupport集成,則Struts框架通過(guò)Java的反射機(jī)制(Reflection)來(lái)調(diào)用Action類中的處理方法。

          Action類的處理方法需要滿足以下要求

          1 public

          2 返回String,框架根據(jù)返回值決定遷移的目的

          3 (可選)拋出Exception,讓Struts框架統(tǒng)一處理異常

          3.5節(jié) Exception Handling

          Struts可以以聲明的方式處理Action類拋出的異常。以聲明的方式處理是指:所有的Action類的處理方法拋出的Exception會(huì)被框架統(tǒng)一處理,之后定向到預(yù)先定義的Result。處理這些異常的Action,Result等可以動(dòng)態(tài)的配置。

          Struts2自帶一個(gè)默認(rèn)的配置:struts-default.xml,在這個(gè)文件中預(yù)先定義了一些基本的操作,其中Exception Handling也在其中,參看下述代碼:

          ...

          <interceptors>

              ...

              <interceptor name="exception"

                    class="com.opensymphony.xwork.interceptor.ExceptionMappingInterceptor"/>

              ...

          </interceptors>

          <interceptor-stack name="defaultStack">

              <interceptor-ref name="exception"/>

              <interceptor-ref name="alias"/>

              <interceptor-ref name="servlet-config"/>

              <interceptor-ref name="prepare"/>

              <interceptor-ref name="i18n"/>

              <interceptor-ref name="chain"/>

              <interceptor-ref name="debugging"/>

              <interceptor-ref name="profiling"/>

              <interceptor-ref name="scoped-model-driven"/>

              <interceptor-ref name="model-driven"/>

              <interceptor-ref name="fileUpload"/>

              <interceptor-ref name="checkbox"/>

              <interceptor-ref name="static-params"/>

              <interceptor-ref name="params"/>

              <interceptor-ref name="conversionError"/>

              <interceptor-ref name="validation">

                  <param name="excludeMethods">input,back,cancel,browse</param>

              </interceptor-ref>

              <interceptor-ref name="workflow">

                  <param name="excludeMethods">input,back,cancel,browse</param>

              </interceptor-ref>

          </interceptor-stack>

          ...

          要使用Struts2聲明式異常處理,只需要將異常映射到result就可以了,可以用兩種方法配置,一種方法是全局配置,針對(duì)所有的Action有效,另一種是針對(duì)具體的Action做配置,只針對(duì)具體的Action有效。

          參看如下struts.xml 配置文件片段:

          <package name="default">

                ...

                <global-results>

                    <result name="login" type="redirect">/Login.action</result>

                    <result name="Exception">/Exception.jsp</result>

                </global-results>

                <global-exception-mappings>

                    <exception-mapping

          exception="java.sql.SQLException" result="SQLException"/>

                    <exception-mapping

          exception="java.lang.Exception" result="Exception"/>

                </global-exception-mappings>

                ...

                <action name="DataAccess" class="com.company.DataAccess">

                    <exception-mapping

          exception="com.company.SecurityException" result="login"/>

                    <result name="SQLException" type="chain">SQLExceptionAction</result>

                    <result>/DataAccess.jsp</result>

                </action>

                ...

          </package>

          上述配置有如下結(jié)果

          1 一個(gè)java.sql.SQLException異常將鏈接到SQLExceptionAction (上述文件中沒(méi)有說(shuō)明)

          2 一個(gè)com.company.SecurityException將重新定位到login.action

          3 其他從java.lang.Exception繼承而來(lái)的Exception將會(huì)被定為到/Exception.jsp頁(yè)面

          3.6節(jié) Intercepter攔截器

          攔截器的運(yùn)行時(shí)機(jī)在Action類運(yùn)行之前和之后。攔截器使用Filter模式,將你需要執(zhí)行的代碼放在Action類處理方法之前或者之后執(zhí)行。攔截器在開(kāi)發(fā)程序的時(shí)候功能非常強(qiáng)大,通過(guò)使用攔截器可以完成校驗(yàn),屬性設(shè)置,安全,日志,程序剖析等功能。

          攔截器可以彼此鏈接構(gòu)成一個(gè)攔截器的棧,每一個(gè)攔截器本質(zhì)上是一個(gè)Java類,都有一個(gè)常常的類名,為了方便使用,可以在Struts2框架中注冊(cè)這些攔截器,例如:

          <interceptor name="security" class="com.jpleasure.security.SecurityInterceptor"/>

           <interceptor-stack name="secureStack">

              <interceptor-ref name="security"/>

              <interceptor-ref name="defaultStack"/>

           </interceptor-stack>

          </interceptors>

          攔截器和攔截器棧可以混合使用來(lái)定義新的攔截器棧,在調(diào)用過(guò)程中,框架按照在攔截器棧中的順序逐個(gè)調(diào)用這些攔截器。

          可以在Package中定義默認(rèn)的攔截器棧,例如:

          <default-interceptor-ref name="secureStack"/>

          當(dāng)然每一個(gè)Action類也可以定義自己的攔截器棧,例如:

          <action name="VelocityCounter"

                                   class="org.apache.struts2.example.counter.SimpleCounter">

              <result name="success">...</result>

              <interceptor-ref name="defaultComponentStack"/>

          </action>

          3.7節(jié) 分離配置文件

          可以在struts.xml中使用include標(biāo)記將配置文件分離成不同的部分。

          例如:

          <!DOCTYPE struts PUBLIC

           "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"

           "http://struts.apache.org/dtds/struts-2.0.dtd">

          <struts>

              <include file="Home.xml"/>

              <include file="Hello.xml"/>

              <include file="Simple.xml"/>

              <include file="/util/POJO.xml"/>

          </struts>

           

          posted on 2008-10-08 14:36 Sky Yi 閱讀(712) 評(píng)論(0)  編輯  收藏


          只有注冊(cè)用戶登錄后才能發(fā)表評(píng)論。


          網(wǎng)站導(dǎo)航:
           
          主站蜘蛛池模板: 门源| 太谷县| 乐至县| 平南县| 湖南省| 永宁县| 甘肃省| 乳源| 灵石县| 莱芜市| 广东省| 文登市| 教育| 台州市| 巴彦县| 资溪县| 开阳县| 曲松县| 思南县| 城口县| 丹棱县| 萨嘎县| 江永县| 聊城市| 乌兰浩特市| 安吉县| 正镶白旗| 泰来县| 皋兰县| 新沂市| 九台市| 海丰县| 苏尼特左旗| 海门市| 宁明县| 奈曼旗| 濮阳县| 衡阳县| 曲靖市| 陈巴尔虎旗| 栖霞市|