WebWork教程2 -配置WebWork應用程序

假設你知道如何設置Servlet容器和創建一個Web應用程序。如果你不會，我建議你學習Apache Tomcat，她是一個來自Apache Jakarata項目的免費Servlet容器，或者你可以選擇來自Caucho Technology的Resin，她也是一個非商業使用的自由Servlet容器。
要使用WebWork ，須copy其所需的類庫（wekwork-2.1.x.jar和lib/core/*.jar）到Web應用程序的WEB-INF/lib下。然後配置web.xml，再創建另外兩個XML文件：xwork.xml和validators.xml。這三個文件看起來像下面這樣。

web.xml

<?xml version="1.0"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
    "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
    <display-name>My WebWork Application</display-name>
    <servlet>
        <servlet-name>webwork</servlet-name>
        <servlet-class>com.opensymphony.webwork.dispatcher.ServletDispatcher</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>webwork</servlet-name>
        <url-pattern>*.action</url-pattern>
    </servlet-mapping> 

    <taglib>
        <taglib-uri>webwork</taglib-uri>
        <taglib-location>/WEB-INF/lib/webwork-2.1.1.jar</taglib-location>
    </taglib>
</web-app>

  



    要使用WebWork，你須註冊ServletDispatcher並設其映射爲 *.action （也可爲其他後綴）。在下一教程中的Action部分將解釋爲什麼這些行如此重要。在上面的例子中taglib描述符聲明允許在WebWork中使用WebWork標籤（更多WebWork標籤在教程4.1中）－當然如果從不使用WebWork的標籤，則可把這部分描述放心的去掉。

xwork.xml  


    在類路徑的根目錄（也就是WEB-INF/classes）中創建一個名爲xwork.xml文件。這是用來配置WebWork自身的。現在，在它裏面放置以下內容：

<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-1.0.dtd">
<xwork>
    <!-- Include webwork defaults (from WebWork JAR). -->
    <include file="webwork-default.xml" />

    <!-- Configuration for the default package. -->
    <package name="default" extends="webwork-default" />
</xwork>



這只是配置文件的一個骨架, 隨着教程的深入，將會被增量。現在，它在這隻做二件事:

    1. 告知 WebWork 它應該導入來自webwork-default.xml的配置信息（你可以在webwork-2.1.x.jar的根目錄中找到）－這個文件定義了webwork-default包，其內容爲WebWork應用程序的默認配置。

  2. 定義一個默認包，action,result和interceptor都在此註冊。這個包擴展了webwork-default包，也就是說，這個默認包將繼承在webwork-default包中的定義的所有配置。

validators.xml


    此外，在類路徑的根目錄中，創建一個名爲validators.xml,內容如下：

<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.0//EN"
"http://www.opensymphony.com/xwork/xwork-1.0.dtd">
<validators>
    <validator name="required" calss="com.opensymphony.xwork.validator.validators.RequiredFieldValidator" />
    <validator name="requiredstring" class="com.opensymphony.xwork.validator.validators.RequiredStringValidator"/>
    <validator name="int" class="com.opensymphony.xwork.validator.validators.IntRangeFieldValidator"/>
    <validator name="date" class="com.opensymphony.xwork.validator.validators.DateRangeFieldValidator"/>
    <validator name="expression" class="com.opensymphony.xwork.validator.validators.ExpressionValidator"/>
    <validator name="fieldexpression" class="com.opensymphony.xwork.validator.validators.FieldExpressionValidator"/>
    <validator name="email" class="com.opensymphony.xwork.validator.validators.EmailValidator"/>
    <validator name="url" class="com.opensymphony.xwork.validator.validators.URLValidator"/>
    <validator name="visitor" class="com.opensymphony.xwork.validator.validators.VisitorFieldValidator"/>
    <validator name="conversion" class="com.opensymphony.xwork.validator.validators.ConversionErrorFieldValidator"/>
</validators>

    這個文件定義了可以用來使用的validators。

    現在，WebWork應用程序的骨架已經立起來了。

   下一個教程將講述如何來使用WebWork的action,view和interceptor。