在本篇将会通过一个简单却经典的HelloWorld程序手把手的教你如何编写（其实我更愿意称之为创建，因为有了这么强大的框架需要编写的代码已经很少很少）一个WebWork应用程序。即使你从没接触过WebWork甚至你从没用过任何其他框架，在本篇结束的时候你都能够轻松的通过WebWork建立简单的Web应用程序了。不过我们约定你必须懂一定的HTML和JAVA知识:)。Let's Go！
首先自然是下载WebWork的开发包，这个我就不专门做一节了。google一下，到WebWork官方站点下载最新的二进制版本，解压后你会找到范例、文档、一些jar、甚至是框架的源代码。现在先不要被这么多的东西吓倒，先不要管它们（虽然以后你会非常的需要它们），我们现在只要找出构建基本Web应用程序所需的内容，一些jar和配置文件。
一、搭建骨架 在WebWork的开发包中找到下面一些应用程序必须的文件，相信这个难不倒你:)
xwork.jar WebWork构建所依赖的XWork类库
common-logging.jar 通用的日志类库，WebWork用它为Log4J或者JDK提供透明的日志记录
oscore.jar OSCore，一个来自OpenSymphony公司的通用功能类库
velocity-dep.jar 依赖Velocity类库
ognl.jar 对象图导航语言（OGNL），WebWork中使用的表达式语言
xwork.xml WebWork配置文件，为你的Web应用程序定义action、result和interceptor
web.xml J2EE Web应用程序配置文件，为你的Web应用程序定义servlet、JSP标签库等内容 现在创建一个名为HelloWorld项目（用你喜欢和习惯的IDE），在项目下创建一个源代码文件夹如src，一个web文件夹如webApp，把web.xml放在WEB-INF目录下，而xwork.xml应该被放在WEB-INF\classes下，如果是在IDE环境下就放在源代码文件夹下编译后就会出现在WEB-INF\classes了。相关的*.jar自然是放在WEB-INF\lib下了。下面我们对几个配置文件进行基本的修改。
为了让WebWork正常工作，我们必须配置一个在
上一篇笔记中提到的前端控制器（Front Controller），使特定URL模式的请求都被提交给WebWork处理。这和Struts是相似的。来看代码吧(web.xml)：
1 <web-app>
2 
3 <servlet>
4 <servlet-name>webwork</servlet-name>
5 <servlet-class>
6 com.opensymphony.webwork.dispatcher.ServletDispatcher
7 </servlet-class>
8 </servlet>
9
10 <servlet-mapping>
11 <servlet-name>webwork</servlet-name>
12 <url-pattern>*.action</url-pattern>
13 </servlet-mapping>
14
15 </web-app> 为了使用WebWork的标签库，还需要给出一个告诉程序在哪里可以找到标签苦的配置，还是看代码吧(web.xml)：
1 <web-app>
2
3 <taglib>
4 <taglib-uri>webwork</taglib-uri>
5 <taglib-location>
6 /WEB-INF/lib/webwork-2.1.7.jar
7 </taglib-location>
8 </taglib>
9
10 </web-app> 你是不是有点奇怪为什么taglib配置的是一个.jar而不是一个TLD文件，其实根据规范程序会自动到.jar中去找指定位置的TLD，我们暂且不管这个问题吧，先去看看WebWork自己的核心配置文件－xwork.xml吧。
说明一下，因为WebWork是基于XWork这个这个子项目的，所以这个文件叫做xwork，不要被它弄迷糊了。我们先来对xwork.xml做一个最基本的配置，以后熟悉了再往里面加入自己的东西就很轻松了。(xwork.xml)
1 <xwork>
2 <include file="webwork-default.xml">
3
4 <package name="default" extends="webwork-default">
5 <default-interceptor-ref name="completeStack"/>
6 </package>
7 </xwork>
我们暂时只用关注一个问题：xwork.xml中包含了一个名教webwork-default.xml的文件，这个文件已经包含在了webwork的.jar中了，它提供了让WebWork正常运行的标准配置，也提供了一些默认的处理方式。了解到这里已经足够了，我们继续往下走。
下面在xwork.xml同一个目录下创建一个webwork.properties配置文件,它定义了一些告诉webwork如何工作的信息，暂时不用关注它，在里面加入一行内容：(webwork.properties)
1 webwork.tag.altSyntax = true
到此，基本的骨架就搭成了，其实并不复杂。下面我们就开始进入真正与业务相关的内容吧。
二、你的第一个action 我们现在假设HelloWorld的需求是这样的：当用户访问一个URL的时候（如http://localhost/helloworld.action webwork默认的后缀是action，后面的笔记中你会了解到这个是可以修改的，比如换成现在比较流行的jspa），都会有一条HelloWorld问候语显示。从上面提到的webwork前端控制器的知识可以知道，URL请求会被映射到webwork中，所以我们要实现这个需求要做下面3件事情：
(1) 创建一个action类（用来实现业务逻辑，并准备返回）
(2) 创建一个result，这里是用JSP的形式，熟练后你可以灵活运用velocity、FreeMarker等
(3) 配置action与result 第一部创建action类：HelloWorld.java ，还是先看代码吧：
1 package example
2
3 import com.opensymphony.xwork.Action;
4
5 public class HelloWorld implements Action{
6 private String message;
7
8 public String execute(){
9 message = "Hello, World!\n";
10 message += "The time is:\n";
11 message += System.currentTimeMillis();
12 return SUCCESS;
13 }
14
15 public String getMessage(){
16 return message;
17 }
18 }
注意你所编写的action类都必须实现定义了execute()方法的Action接口，而execute()就是在执行这个action的时候被WebWork调用的。
在action中定义了message的getter方法，以便JSP标签取得message的值显示给客户端。
最后execute()方法返回了SUCCESS（其实就是一个值为“success”的字符串常量），并且所有的WebWork的action都必须返回一个result code（一个说明执行结果的字符串）。它告诉WebWork现在的执行结果和下一步应该对应到哪个result，虽然result code不一定必须对应一个result但是通常都是。既然业务已经处理完了，下面就来创建一个JSP页面显示HelloWorld问候语。
1 <%@ taglib prefix="ww" uri="webwork" %>
2 <html>
3 <head>
4 <title>Hello Page</title>
5 </head>
6 <body>
7 The message generated by my first action is:
8 <ww:property value="message"/>
9 </body>
10 </html>
11
用过页面标签的朋友肯定对这种代码很熟悉了，即使你没用过也没关系，下面简单介绍一下。第一行标签库定义将前缀ww和URI webwork（这个webwork就是前面在web.xml中定义的URI）之间建立了映射关系。前缀ww指明了所有WebWork标签在使用的时候以“ww:”开头。property标签包含了一个value属性值，通过设置value值，标签可以从action中获得对应表达式的内容。因为在action中创建一个名为getMessage()的方法，value值为message的property标签就会得到getMessage()方法调用后的值。把上面的代码保存为hello.jsp，放在webApp目录下。
配置你的action与result，已经创建了action类和视图，最后还需要将它们联系起来。你可以通过为action配置一个特别的URL，以及将SUCCESS这个result code映射到你刚才创建的JSP来完成这一步。当你配置一个WebWork action的时候，必须清楚下面3个方面：
(1) action类的全名，包含完整的包名
(2) 你打算将action存放于Web应用程序什么位置，即应用什么URL
(3) action可能返回所有结果码 1 <xwork>
2 <include file="webwork-default.xml">
3
4 <package name="default" extends="webwork-default">
5 <default-interceptor-ref name="completeStack"/>
6
7 <action name="helloWorld" class="example.HelloWorld">
8 <result name="success">hello.jsp</result>
9 </action>
10 </package>
11 </xwork>
到这个时候就已经差不多了，编译程序并发布在你喜欢的web容器中。启动服务器你就可以在浏览器中输入URL看看效果了，如http://localhost/helloWorld.action（如果端口为8080，还需要加上端口），这个时候你就会看到浏览器中显示了HelloWorld的信息。这并不是一个令人兴奋的网页，但是你至少开始使用WebWork了，这难道不令人激动吗？
当然毕竟上这是一个很简单的应用，实际的应用会比这复杂千倍万倍，你将会在后面的笔记中慢慢深入WebWork的殿堂，下一篇将会详细讲述WebWork中三最为重要的概念－action、result、interceptor并告诉你如何最好的使用它们。让我们一起期待吧！
posted on 2007-02-09 12:39
cresposhi 阅读(3260)
评论(17) 编辑 收藏