js 在如今的web開發中，基於java的應用越來越多。在這其中，servlet又扮演著十分重要的角色。本系列文章就是要介紹一些輔助進行servlet開發的工具，讓大家進行開發時，有多種技術可供選擇。
servlet技術無疑是一種優秀的技術，java伺服器端技術大都基於servlet技術。但這種技術也有其自身的不足，例如：展示層（html代碼）與代碼混在一起，可重用性不高。SUN於是提出了jsp技術，jsp也是基於servlet的一種技術，使用它你可以在html中嵌入java代碼。jsp在servlet的基礎上邁進了一大步，但單純的jsp也有上面提到的servlet的缺點。不過利用jsp+javabean+taglib這種開發模式可以解決上面提到的缺點。但jsp本身還有其它一些不足，具體參看The Problems with JSP這篇文章。於是人們便開發了其它一些基於servlet的技術。我們首先介紹一下Tapestry。
簡介
Tapestry是一個開源的基於servlet的應用程式架構，它使用元件物件模型來建立動態，互動的web應用。一個組件就是任意一個帶有jwcid屬性的html標記。其中jwc的意思是Java Web Component。Tapestry使得java代碼與html完全分離，利用這個架構開發大型應用變得輕而易舉。並且開發的應用很容易維護和升級。Tapestry支援本地化，其錯誤報表也很詳細。Tapestry主要利用javabean和xml技術進行開發。
第一個應用程式
在介紹第一個應用之前，先介紹一下Tapestry的安裝。從sourceforge下載其最新版，解壓後，將lib目錄下的jar檔案放到CLASSPATH中，將其中的war檔案放到tomcat的webapp目錄下。然後就可以通過http://localhost:8080/tutorial訪問其tutorial應用。
在Tapestry中一個應用程式有以下幾部分組成，我們以其自身帶的HelloWorld程式為例介紹：
Servlet：
這是一個應用的主體部分：servlet類，這個類必須是ApplicationServlet的子類，並且必須實現getApplicationSpecificationPath()方法。樣本如下：
import com.primix.tapestry.*;
public class HelloWorldServlet extends ApplicationServlet
{
protected String getApplicationSpecificationPath()
{
return "/tutorial/hello/HelloWorld.application";
}
}
/tutorial/hello/HelloWorld.application是一個應用的說明檔案。
Application Specification：
其實就是描述這個應用的一個xml檔案，在這個應用中有許多參數需要設定，engine-class將在下面介紹，page中的name屬性指定html檔案名稱，specification-path指定對這個頁面的說明檔案。在一個應用中可以有很多個page，但必須有一個page的name為"Home"，因為當訪問你的應用時，首先顯示的就是這個page。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE application PUBLIC "-//Howard Ship//Tapestry Specification 1.1//EN" "http://tapestry.sf.net/dtd/Tapestry_1_1.dtd">
<application name="Hello World Tutorial" engine-class="com.primix.tapestry.engine.SimpleEngine">
<page name="Home" specification-path="/tutorial/hello/Home.jwc"/>
</application>
Application Engine：
當客戶串連到Tapestry應用時，Tapestry將會建立一個Engine對象（類似於session）。通常我們程式中的application engine 一般是SimpleEngine類的一個執行個體，當然這個類的子類也可以。
Page Specification：
跟應用說明相似，頁說明也是一個xml描述檔案：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE specification PUBLIC "-//Howard Ship//Tapestry Specification 1.1//EN" "http://tapestry.sf.net/dtd/Tapestry_1_1.dtd">
<specification class="com.primix.tapestry.BasePage"/>
因為這個應用是靜態，所以使用com.primix.tapestry.BasePage即可，如果是動態應用，則需在這個檔案中定義一些component，當然使用BasePage為基類的衍生類別也可以。
html頁面：
這個應用的html頁面非常簡單：
<html>
<head>
<title>Hello World</title>
</head>
<body>
<b>HelloWorld</b>
</body>
</html>
注意上面所講到的各種檔案都要放到放在WAR的WEB-INF/classes目錄下。
一個複雜的應用
在這個應用中我們以一個簡單的學生管理系統為例介紹一下Tapestry的常用功能。我們要實現學生的增加和顯示，因此我們需要兩個html頁面。至於StudentServlet類和Student.application我們就不描述了，在Student.application中定義了兩個page：Home和EditStudent，具體看附件。學生資料存放在資料庫中，我們用Student類表示資料中的一條記錄，用StudentFactory類檢索學生資料，這兩個類用到了一個JDBC封裝器，關於這個JDBC封裝器可以見我的另外一篇文章<<對一個簡單的 JDBC 封裝器的擴充及應用>>。
首先看一下Home.html
<html>
<head>
<title>學生管理</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body bgcolor="#FFFFFF">
<p align="center">學生列表</p>
<table width="100%" border="1">
<tr>
<td >學號</td>
<td >姓名</td>
<td >性別</td>
<td >班級</td>
</tr>
<span jwcid="liststudent">
<tr>
<td><span jwcid="id">20012400</span></td>
<td><span jwcid="sname">宗鋒</span></td>
<td><span jwcid="gender">男</span></td>
<td><span jwcid="department">電腦研一</span></td>
</tr>
</span>
<tr jwcid="$remove$">
<td>20011389</td>
<td>桑一珊</td>
<td>男</td>
<td>電腦研一</td>
</tr>
</table>
<a jwcid="add">新增學生</a>
</body>
</html>
與前面的簡單應用不同，我們在這個頁面中定義了七個組件，下面看一下部分Home.jwc檔案，我們將詳細講述一下怎樣描述這些組件。
<specification class="test.ListStudent">
<component id="liststudent" type="Foreach">
<binding name="source" property-path="student"/>
<binding name="value" property-path="eachstudent"/>
</component>
<component id="id" type="Insert">
<binding name="value" property-path="eachstudent.id"/>
</component>
<component id="add" type="Page">
<static-binding name="page">EditStudent</static-binding>
</component>
</specification>
在這裡，我們的specification的class屬性值不再是BasePage，而是其衍生類別ListStudent。對於每一個組件，id屬性指定唯一的標識符，這個值與html檔案中的jwcid值相對應，type 指定組件名，binding指定組件怎得到資料，property-path是一系列屬性的集合，這些屬性一般定義在javabean中，例如上面的property-path="student"，則在相應的javabean類ListStudent中應該有個函數getStudent。liststudent是一個Foreach組件，這個組件其實是一個for迴圈，它從source中讀入一個數組，將其一個一個的賦值給value參數指定的屬性。id，name，gender，department四個是Insert組件，這個組件用來插入文本資料，參數value指定要插入的值，property-path指定怎樣擷取這些值，eachstudent.id相當於調用javabean的getEachstudent().getId()。add是一個Page組件，page屬性指定頁面名（定義在application檔案中），static-binding表明要繫結資料是不可修改的。$remove$組件沒有在這個檔案中描述，因為Tapestry運行時會自動刪除這種組件。
下面看一下ListStudent類：
package test;
import com.primix.tapestry.*;
import sun.jdbc.odbc.JdbcOdbcDriver ;
/**
* 返回每個學生的資料
*
*/
public class ListStudent extends BasePage
{
private Student eachstudent;
private Student[] student;
public void detach()
{
eachstudent=null;
student=null;
super.detach();
}
public Student getEachstudent()
{
return eachstudent;
}
public void setEachstudent(Student value)
{
eachstudent = value;
}
public Student[] getStudent()
{
try{
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver");
student=StudentFactory.findAllStudents();
}catch(Exception e){
e.printStackTrace();
}
return student;
}
}
這個類有四個函數，其中detach函數是將頁面放入緩衝池時執行的操作，getStudent函數返回所有的學生記錄，這是給jwc檔案中liststudent組件的source參數賦值，getEachstudent給這個組件的value參數賦值，因為source是一個數組，每次迴圈需要從中取出一條記錄賦值給eachstudent,所以還有一個函數為setEachstudent，你會注意到這個函數很簡單，其實是Tapestry幫你做了大部分工作。
至此，顯示學生的部分已經完成，下面看一下EditStudent.html
<html>
<head>
<title>增加學生</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<p><img src=http://www.163design.net/j/f/"student.gif" width="32" height="32"/> 學生管理系統</p>
<form jwcid="form">
<span jwcid="ifError">
<font size=+2 color=red><span jwcid="insertError"/></font>
</span>
<p>學號：
<input jwcid="id"/>
</p>
<p>姓名：
<input jwcid="name"/>
</p>
<span jwcid="gender">
<p>性別：
<input jwcid="male"/>
男
<input jwcid="female"/>
女
</p>
</span>
<p>班級：
<input jwcid="department"/>
</p>
<p>
<input type="submit" value="確定">
</p>
</form>
</body>
</html>
在這個檔案中，用到了另外一些常用的組件，先看一下EditStudent.jwc中的這些組件的描述：
<specification class="test.EditStudent">
<component id="form" type="Form">
<binding name="listener" property-path="listeners.formSubmit"/>
</component>
<component id="gender" type="RadioGroup">
<binding name="selected" property-path="gender"/>
</component>
<component id="ifError" type="Conditional">
<binding name="condition" property-path="error"/>
</component>
<component id="insertError" type="Insert">
<binding name="value" property-path="error"/>
</component>
<component id="id" type="TextField">
<binding name="value" property-path="id"/>
</component>
<component id="male" type="Radio">
<field-binding name="value" field-name="test.EditStudent.MALE"/>
</component>
</specification>
form是一個Form組件，它的參數listener指定submit這個form時有那個函數處理。ifError是一個Conditional組件，這個組件指定當condition滿足時才會顯示，在本例中，如果error不為空白，則condition滿足。在這個組件中，有嵌套了一個Insert類型的組件，用於將錯誤顯示。這是Tapestry中經常用到的處理錯誤的方式。gender是一個RadioGroup組件，它綁定了javabean中的gender屬性，selected參數指定那個radio被選中，在這個組件中，又嵌套了兩個Radio組件，分別用來表示男，女。Radio的value參數指定當使用者選定這個radio時，RadioGroup綁定的屬性值將會等於field-name中指定的值（這個值必須是static的），在本例中，gender=test.EditStudent.MALE。id是一個TextField組件，其參數value綁定到javabean中的id屬性。
下面是相應的EditStudent類：
package test;
import com.primix.tapestry.*;
public class EditStudent extends BasePage
{
public static final int MALE = 1;
public static final int FEMALE = 2;
private int gender;
private String error;
private String id;
private String sname;
private String department;
public void detach()
{
error = null;
id=null;
sname=null;
gender=0;
department=null;
super.detach();
}
public int getGender()
{
return gender;
}
public String getId()
{
return id;
}
public String getSname()
{
return sname;
}
public String getDepartment()
{
return department;
}
public void setGender(int value)
{
gender = value;
fireObservedChange("gender", value);
}
public void setId(String value)
{
id = value;
fireObservedChange("id", value);
}
public String getError()
{
return error;
}
public void setSname(String value)
{
sname = value;
fireObservedChange("sname", value);
}
public void setDepartment(String value)
{
department = value;
fireObservedChange("department", value);
}
public void formSubmit(IRequestCycle cycle)
{
//判斷使用者是否添完了所有資料
if (gender== 0||id==null||id.equals("")||sname==null||sname.equals("")||
department==null||department.equals(""))
{
error = "請填充完所有選項";
return;
}
//將學生儲存
try{
Student student=new Student();
student.setId(id);
student.setName(sname);
if(gender==1)
student.setGender("男");
else
student.setGender("女");
student.setDepartment(department);
student.save(null);
}catch(Exception e){
e.printStackTrace();
}
//清空當前的各個屬性，以免再次進入此頁面時，各屬性仍舊保留原來的值
setSname(null);
setDepartment(null);
setId(null);
setGender(0);
//重新導向到Home頁面
cycle.setPage("Home");
}
}
在本類的一些設定屬性的函數中使用了fireObservedChange這個函數，這個函數激發一個改變事件，通知當前的屬性的值已經改變。
其他應用
Tapestry中內建的例子中的Workbench中的localization例子示範了怎樣使用本地化，你只需要建立不同語言的html模板，還有圖形等其它一些html中用到的資源。例如建立一個法語版的EditStudent.html，則相應的html檔案名稱為EditStudent_fr.html，而jwc中定義的組件的描述不用有多個版本。這裡要介紹一下Tapestry本地化中經常用到的一個概念：assets。assets是一些web應用中用到的資源，如圖象，視頻。assets有三種：external, internal 和private。External類型的assets來源於任意的URL。Internal類型的assets來源於和Tapestry應用在同一個伺服器上的URL。Private 類型的assets允許部署在WAR的WEB-INF/classes目錄下（同上面的html模板，jwc檔案一樣），這個目錄對於web伺服器來說是不可見的。
看一下Workbench中localization例子中的localization.jwc檔案的片斷：
<component id="changeButton" type="ImageSubmit">
<binding name="image" property-path="assets.change-button"/>
</component>
<private-asset name="change-button" resource-path="/tutorial/workbench/localization/Change.gif"/>
在changeButton組件中就使用了private assets，而這些影像檔就放在WAR的WEB-INF/classes下，注意映像跟html一樣也有多個語言的版本。
注意jwc檔案中的inputLocale這個組件，其實localization應用就是通過這個組件來實現本地化。具體參數請看其Developer guide。
<component id="inputLocale" type="PropertySelection">
<binding name="value" property-path="page.engine.locale"/>
<binding name="model" property-path="localeModel"/>
</component>
Tapestry還支援建立自己的可重用組件，其自身帶了一個這樣的例子：Border。同時它還有其它一些例子：Inspector展示了怎樣監視你的應用程式。vlib是一個用tapestry作展示層的j2ee應用程式（用jboss作為應用伺服器）。
Tapestry的功能非常強大，本文只是介紹了其一小部分，還有很多方面沒有涉及到，例如javascript在Tapestry中的應用。具體可以看其文檔，相信如果你用一下這個架構，你就會被它深深吸引。Tapestry的文檔做的不是很全，不過經過不斷的摸索，相信你會很快掌握它。
