WebWork 2 : TutorialLesson02
This page last changed on Sep 16, 2004 by vitorsouza.

第二课: 设置Web应用

这里假定你已经设置好Servlet容器并知道如何创建web应用. 如果没有, 建议你了解一下Apache Tomcat, 这是一个由Apache Jakarta项目开发的免费的Servlet容器, 也可以使用Caucho Technology的Resin, 它可以免费用于非商业用途.

要使用WebWork, 需要将上一课中介绍的必要的类库(webwork-2.1.1.jar和lib/core/*.jar)复制到Web应用的WEB-INF/lib目录中. 然后, 配置web.xml病床建起它的两个XML文件: xwork.xml和validators.xml. 这三个文件将在下文介绍.

web.xml:

修改web应用的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. 这些行为何如此重要将在下一课中关于活动的章节进行解释. 在这一例子中同时声明了WebWork标签库描述文件以便使用WebWork标签(关于WebWork标签的更多信息请参阅4.1) – 如果你不使用WebWork标签, 可以安全的删掉它.

进一步阅读: web.xml

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">
	</package>
</xwork>

这只是配置文件的一个骨架, 在我们遍历整个指南的过程中, 它将不断的增长. 目前为止, 它只做两件事情:

  • 通知WebWork需要从webwork-default.xml(位于webwork-2.1.1.jar的根目录中并一直可用)中导入配置信息 – 该文件定义了包webwork-default, 它包含了WebWork应用所需的缺省配置;
  • 定义了一个default包, 活动(actions), 结果(results)和截取器(interceptors)将注册在其中. 这个包还扩展(extends)了webwork-default, 也就是说, default包将继承(inherit)定义在webwork-default中的全部配置.

进一步阅读: xwork.xml

validators.xml:

再次在根类路径中创建文件validators.xml, 并下列内容包含:
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator
1.0//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.dtd"> 

<validators> 
	<validator name="required"
		class="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>

该文件定义可用的校验器.

进一步阅读: 校验

全部设置完成!

现在一个WebWork应用的骨架已经配置完成. 下一课将学习如何使用WenWork的活动, 视图和截取器.

上一课 | 下一课
Document generated by Confluence on Dec 14, 2004 16:36