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。