您的位置: 首页  >  文章  >  Tapestry 教程（七）在Tapestry中一起使用Hibernate

Tapestry 教程（七）在Tapestry中一起使用Hibernate

分类: 文章 • 2024-05-19 15:22:52

为什么80%的码农都做不了架构师？>>>   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;

 

@Entity

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上由用户输入的所有地址数据。在你输入了一些名字之后，看起来就会像下面这样：

Tapestry 教程（七）在Tapestry中一起使用Hibernate

向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，它提供了几乎是海量的教程哦。


转载于:https://my.oschina.net/xuleo/blog/599879

相关推荐