好了，你填写了所有的输入域，提交了这个表单(没有任何验证错误)，瞧：你又回到了相同的表单，所有的格子里面都是空的。发生了什么，数据都到哪儿去了？

所发生的就是我们还没有告诉Tapestry在表单成功提交(得是成功的，我们的意思是，没有验证错误)之后接下来要做什么。Tapestry的默认行为是重新显示当前的page，而这是在一个新的请求当中，Address对象已经是一个新的实体了(因为address属性域不是一个持久化的属性域)。

好吧，因为我们已经创建了对象，我们可能也应该将它们在某个地方存储起来……在一个数据库中。我们准备将Hibernate快速集成到Tapestry中，作为其对象/关系映射层，并且最终把数据存储到一个HyperSQL(HSQLDB)数据库中。HSQLDB是一个嵌入式的数据库引擎，无需安装——它将会由Maven作为依赖获取下来。

重新对项目进行配置

我们将吧这个项目从一个简单的Tapestry项目慢慢变成一个使用了Hibernate和HSQLDB的Tapestry项目。

更新依赖

首先，我们必须更新POM文件，添加一些新的依赖，包括Hibernate，Tapestry/Hibernate集成库，以及HSQLDB JDBC驱动：

src/pom.xml(局部)

org.apache.tapestry

tapestry-hibernate

${tapestry-release-version}

org.hsqldb

hsqldb

2.3.2

...

Tapestry-hibernate库包括Hibernate和tapestry-core。这意味着你可以在元素中简单地将“tapestry-core”用“tapestry-hibernate”替换。

修改了POM并保存之后，Maven应该会自动下载新的依赖的JAR包。

Hibernate 配置

Hibernate需要一个主配置文件，hibernate.cfg.xml，用来存储连接和其它数据。在你的src/mian/resources文件夹下面创建它：

src/main/resources/hibernate.cfg.xml

hibernate-configuration PUBLIC

"-//Hibernate/Hibernate Configuration DTD 3.0//EN"

"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">

org.hsqldb.jdbcDriver

jdbc:hsqldb:./target/work/t5_tutorial1;shutdown=true

org.hibernate.dialect.HSQLDialect

sa

update

true

true

配置的大部分内容用来指定JDBC驱动和连接的URL。

注意下连接的URL。我们指示HSQLDB将其数据库文件存储在了项目的目标目录。还指示HSQLDB在停掉应用时将数据刷到这些文件中。这意味着数据在项目的不同时期都会持续存在，但如果目标目录被摧毁了(例如，通过“mvn clean”)，那么所有的数据库内容都会丢失掉。

此外，我们还配置了要Hibernate来更新数据库的schema：当Hibernate初始化时它将会创建甚至于更新数据表，以匹配Java代码中的实体类。最后，我们配置Hibernate输出其执行的任何SQL，这在一开始构建应用程序时非常有用。

然而有哪些实体呢？一般，可用的实体都会列在hibernate.cfg.xml中，不过使用Tapestry的话这就没什么必要了；在其它约定大于配置的示例中，Tapestry会定位所有位于entities包(这里就是“com.example.tutorial1.entities”)中的实体类，并将它们添加到配置中。当前，就只有一个Address实体。

添加Hibernate注解

对于要用上Hibernate的实体，必须向其类中添加一些Hibernate的注解。

下面是更新过后的Address类，带上了Hibernate的注解(还有就是Tapestry的)。

src/main/java/com/example/tutorial/entities/Address.java

package com.example.tutorial1.entities;

import javax.persistence.Entity;

import javax.persistence.GeneratedValue;

import javax.persistence.GenerationType;

import javax.persistence.Id;

import org.apache.tapestry5.beaneditor.NonVisual;

import org.apache.tapestry5.beaneditor.Validate;

import com.example.tutorial1.data.Honorific;

public class Address

{

@Id

@GeneratedValue(strategy = GenerationType.IDENTITY)

@NonVisual

public Long id;

public Honorific honorific;

@Validate("required")

public String firstName;

@Validate("required")

public String lastName;

public String street1;

public String street2;

@Validate("required")

public String city;

@Validate("required")

public String state;

@Validate("required,regexp")

public String zip;

public String email;

public String phone;

}

Tapestry的注解，@NonVisual和@Validate，可能会被放置在setter或者getter或者属性域之上(像我们这里这样做的)。由于使用了Hibernate的注解，将注解放置到了属性域之上就要求属性域的名称对应到属性的名称。

l@NonVisual——表示一个属性域，比如主键，应该不被用户看见。

l@Validate——将验证同属性域关联。

此处你应该停止并重启应用程序。

更新数据库

这样我们就有了一个数据库，并且Hibernate也被配置好了来连接它。让我们利用其来存储我们的Address对象。我们所需要的是提供一些代码在表单被提交时执行。当Tapestry的表单被提交时，有一系列的时间被触发。我们感兴趣的是“success”事件，其在过程中处在比较晚的后期，要等到所有的值都已经从请求中获取到并且设置到page属性上之后，还得是在所有服务器端验证发生之后。

Success事件只会在没有验证错误的时候被触发。

我们的事件处理器必须要做两件事：

l使用Hibernate Session对象将新的Address对象持久化

l将事务提交，强制让数据被写入数据库。

让我们来更新一下CreateAddress.java类：

src/main/java/com/example/tutorial/pages/address/CreateAddress.java

package com.example.tutorial1.pages.address;

import com.example.tutorial1.entities.Address;

import com.example.tutorial1.pages.Index;

import org.apache.tapestry5.annotations.InjectPage;

import org.apache.tapestry5.annotations.Property;

import org.apache.tapestry5.hibernate.annotations.CommitAfter;

import org.apache.tapestry5.ioc.annotations.Inject;

import org.hibernate.Session;

public class CreateAddress

{

@Property

private Address address;

@Inject

private Session session;

@InjectPage

private Index index;

@CommitAfter

Object onSuccess()

{

session.persist(address);

return index;

}

}

Inject注解会告诉Tapestry要将一个服务注入到注解的属性域中；Tapestry包含一个复杂精致的控制反转容器(很多方面都类似于Spring)，非常善于根据类型定位可用的服务，而不是根据string的id。无论何时，Hibernate Session对象都是作为一个Tapestry的IoC服务被暴露出来的，可以被注入(这是一个由tapestry-hibernate模块提供的东西)。

必要时Tapestry会自动开启一个事务；不过该事务默认会在最后被取消。如果我们队持久化对象做了修改，比如添加了一个新的Address对象，那么有必要提交这个事务。

CommitAfter注解可以被应用于任何component的方法；如果方法照常完成，那事务就会被提交(而且一个新的事务会开始替换已经提交的事务)。

将新的地址持久化了之后，我们要返回应用程序的Index page。

注意：在真实的应用程序中，很少会让page和component直接使用Hibernate Sessin。一般更好的方式是定义你自己的数据访问对象(Data Access Object)层来执行通用的更新和查询操作。

展示地址数据

作为接下来的一个小预览，下面所展示的是应用程序的Index page上由用户输入的所有地址数据。在你输入了一些名字之后，看起来就会像下面这样：

向Index page中添加一个表格

好吧，这是如何实现的呢？通常，这是由Gridcomponet实现的。

Grid component基于跟BeanEditForm component同样的概念；它可以将一个bean解析成数据列。数据列是可以排序的，并且当数据量超过了一页所能展示的量，分页导航就会自动被加上。

最轻量的Grid非常容易被添加到模板中。只要把这个添加到Index.tml的底部就行了：

src/main/webapp/Index.tml (partial)

include="honorific,firstName,lastName,street1,city,state,zip,phone"/>

注意Grid component可以接收我们曾在BeanEditForm上使用过的相同的参数。这里我们使用include参数来指定要展示的属性，还有使用哪种顺序。

现再我们所要做的就是在Java代码中提供这个addresses属性。这里展示了Index.java现在应该是什么样子：

src/main/java/com/example/tutorial/pages/Index.java

package com.example.tutorial1.pages;

import java.util.List;

import org.apache.tapestry5.ioc.annotations.Inject;

import org.hibernate.Session;

import com.example.tutorial1.entities.Address;

public class Index

{

@Inject

private Session session;

public List

 getAddresses()

{

return session.createCriteria(Address.class).list();

}

}

这里，我们使用的是Hibernate Session对象找到数据库中所有的Address对象数据。所有的排序都会在内存中完成。这在目前看来还好(只有几个Address对象在数据库中而已)。稍后我们将会看到如何针对极大的结果集进行优化。

接下来是什么？

我们还有更多要聊的：更多的component、更多的自定义、内置的Ajax支持，更多通用的设计和实现模式，甚至还要编写你自己的组件(这很简单！)。

去查看文档页面上众多的Tapestry资源吧，包括入门和FAQ页面，还有Cookbook。请确保要利用好用户指南，它提供了几乎每一个Tapestry主题的非常详细的信息。最后，确保看过(并且收藏了)Tapestry JumpStart，它提供了几乎是海量的教程哦。