Tapestry 教程（七）在Tapestry中一起使用Hibernate
Tapestry 教程（七）在Tapestry中一起使用Hibernate
好了，你填写了所有的输入域，提交了这个表单（没有任何验证错误），瞧：你又回到了相同的表单，所有的格子里面都是空的。发生了什么，数据都到哪儿去了？
所发生的就是我们还没有告诉Tapestry在表单成功提交（得是成功的，我们的意思是，没有验证错误）之后接下来要做什么。Tapestry的默认行为是重新显示当前的page，而这是在一个新的请求当中，Address对象已经是一个新的实体了（因为address属性域不是一个持久化的属性域）。
好吧，因为我们已经创建了对象，我们可能也应该将它们在某个地方存储起来……在一个数据库中。我们准备将Hibernate快速集成到Tapestry中，作为其对象/关系映射层，并且最终把数据存储到一个HyperSQL（HSQLDB）数据库中。HSQLDB是一个嵌入式的数据库引擎，无需安装——它将会由Maven作为依赖获取下来。
重新对项目进行配置
我们将吧这个项目从一个简单的Tapestry项目慢慢变成一个使用了Hibernate和HSQLDB的Tapestry项目。
更新依赖
首先，我们必须更新POM文件，添加一些新的依赖，包括Hibernate，Tapestry/Hibernate集成库，以及HSQLDB JDBC驱动：
src/pom.xml（局部）
<dependencies>
<dependency>
<groupId>org.apache.tapestry</groupId>
<artifactId>tapestry-hibernate</artifactId>
<version>${tapestry-release-version}</version>
</dependency>
<dependency>
<groupId>org.hsqldb</groupId>
<artifactId>hsqldb</artifactId>
<version>2.3.2</version>
</dependency>
...
</dependencies>
Tapestry-hibernate库包括Hibernate和tapestry-core。这意味着你可以在<artifact>元素中简单地将“tapestry-core”用“tapestry-hibernate”替换。
修改了POM并保存之后，Maven应该会自动下载新的依赖的JAR包。
Hibernate 配置
Hibernate需要一个主配置文件，hibernate.cfg.xml，用来存储连接和其它数据。在你的src/mian/resources 文件夹下面创建它：
src/main/resources/hibernate.cfg.xml
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<property name="hibernate.connection.driver_class">org.hsqldb.jdbcDriver</property>
<property name="hibernate.connection.url">jdbc:hsqldb:./target/work/t5_tutorial1;shutdown=true</property>
<property name="hibernate.dialect">org.hibernate.dialect.HSQLDialect</property>
<property name="hibernate.connection.username">sa</property>
<property name="hibernate.connection.password"></property>
<property name="hbm2ddl.auto">update</property>
<property name="hibernate.show_sql">true</property>
<property name="hibernate.format_sql">true</property>
</session-factory>
</hibernate-configuration>
配置的大部分内容用来指定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中添加一个表格
好吧，这是如何实现的呢？通常，这是由Grid componet实现的。
Grid component基于跟BeanEditForm component同样的概念；它可以将一个bean解析成数据列。数据列是可以排序的，并且当数据量超过了一页所能展示的量，分页导航就会自动被加上。
最轻量的Grid非常容易被添加到模板中。只要把这个添加到Index.tml的底部就行了：
src/main/webapp/Index.tml (partial)
<t:grid source="addresses"
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<Address> getAddresses()
{
return session.createCriteria(Address.class).list();
}
}
这里，我们使用的是Hibernate Session对象找到数据库中所有的Address对象数据。所有的排序都会在内存中完成。这在目前看来还好（只有几个Address对象在数据库中而已）。稍后我们将会看到如何针对极大的结果集进行优化。
接下来是什么？
我们还有更多要聊的：更多的component、更多的自定义、内置的Ajax支持，更多通用的设计和实现模式，甚至还要编写你自己的组件（这很简单！）。
去查看文档页面上众多的Tapestry资源吧，包括入门和FAQ页面，还有Cookbook。请确保要利用好用户指南，它提供了几乎每一个Tapestry主题的非常详细的信息。最后，确保看过（并且收藏了）Tapestry JumpStart，它提供了几乎是海量的教程哦。