你好，Tapestry 3.0
mechiland, Jul 2003
本文主要介绍Tapestry3.0环境下一个简单用例Tapestry的配置方法，旨在帮助开发者熟悉3.0环境。由于Tapestry官方(http://jakarta.apache.org/tapestry/)提供的Tutorial文档很多是基于2.x的，这在极大程度上提高了学习的难度。关于Tapestry2.x的介绍以及Tapestry的框架，请参看第7期《程序员》杂志透明的一篇文章，这里不再多说。
2.x到3.0的变化我没有花太多的时间去研究——毕竟接触的时间有限，刚把概念弄明白，3.0就出来了，package的名字都变了，dtd也变了，一些配置的方法也不太一样了，所以本篇文章主要讨论3.0，对于2.x和3.0中区别的地方，尽量不进行比较；如果在文中比较之处有错，还请多多指教。
1 开发环境
Tomcat5.0, Win2000Server, Tapestry 3.0b2
开发工具：Editplus2.11 :)(项目小，没有必要用航母了)
2 让我们开始吧！
Ok, 让我们开始这个“你好，Tapestry3.0”吧！
首先，建立一个目录用来保存你的工程，假定x:\tapestry\hello(以后以$home代替);并最后建立如下文件结构：
-WEB-INF
--classes
--lib
在$home根目录下放入一个Home.html，代码如下所示：
| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>Hello, Tapestry!</title>
</head>
<body>
你好，<b>Tapestry 3.0!</b>
</body>
</html>
|
代码清单1：Home.html
这就是我们的主页面了。
然后在$home/WEB-INF/下面放入一个web.xml，出人意料的，这个web.xml竟然如此简单，而且与Tapestry2.x的文档中提供的大不一样哦~~
<?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>Tapestry Tutorial</display-name>
<!--Redirect it to the servlet mapping address /h-->
<filter>
<filter-name>redirect</filter-name>
<filter-class>org.apache.tapestry.RedirectFilter</filter-class>
<init-param>
<param-name>redirect-path</param-name>
<param-value>/h</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>redirect</filter-name>
<url-pattern>/</url-pattern>
</filter-mapping>
<servlet>
<servlet-name>hello</servlet-name>
<servlet-class>org.apache.tapestry.ApplicationServlet</servlet-class>
<load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>hello</servlet-name>
<url-pattern>/h</url-pattern>
</servlet-mapping>
<session-config>
<session-timeout>15</session-timeout>
</session-config>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
</welcome-file-list>
</web-app>
|
代码示例2：web.xml
稍微解释一下：名为redirect的filter是用来转向的，注意，那个init-param用来控制转向到哪里去，如果没有或者设置不正确，就会转到默认的地方（/app）。按照我们配置的情况，应该是当访问/时转到/h的servlet去。当然，这个设置是当下面的<welcome-file-list>无效时才起作用。
读过旧版tutorial的人就会奇怪，那个org.apache.tapestry.application-specification到哪里去了？在默认情况下，Tapestry会在/WEB-INF下寻找跟ApplicationServlet名称相同的.application（如本例中hello），另外，application的配置已经非常简单，对于我们Hello, Tapestry这样简单的用例，不用.application也是可以的。不过为了形式的完整，我们将它加上：
将hello.application文件放到$home/WEB-INF下面（与web.xml）放在一起
<?xml version="1.0"?>
<!DOCTYPE application PUBLIC
"-//Apache Software Foundation//Tapestry Specification 3.0//EN"
"http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
<application name="Hello Tapestry 3.0">
</application>
|
代码示例3：hello.application
现在，就是我们的Home.page文件：
<?xml version="1.0"?>
<!DOCTYPE page-specification PUBLIC
"-//Apache Software Foundation//Tapestry Specification 3.0//EN"
"http://jakarta.apache.org/tapestry/dtd/Tapestry_3_0.dtd">
<page-specification class="org.apache.tapestry.html.BasePage"/>
|
代码示例4：Home.page
是不是不知道将这个文件放到哪里了?放到$home/WEB-INF下面就行了！
OK, 最后一步，将Tapestry所带的workbench示例下/WEB-INF/lib中所有的jar复制到$home/WEB-INF/lib。
3 部署
部署方法很简单了，你可以用jar工具将$home目录打成一个war包，或者直接将整个$home目录复制到$Tomcat_Home/webapps下面。不论你采用那种方法，部署成功后，打开浏览器，键入地址：http://localhost:8080/hello, 是不是显示出下面的画面呢？
4 小结
在Tapestry3.0中，部署应用程序更加容易了，本文由于案例较简单，很多步骤都可以忽略（在本例中，hello.application和Home.page都可以忽略不计），但是在复杂的应用中，如Tapestry自带的workbench示例，就不可忽略了。关于Tapestry的其他特性，作者正在研究中。Tapestry是个优秀的开发框架，如果那位有兴趣，或者对这篇文章中有什么不正确的地方，欢迎批评指正，Email: mechiland@163.net
