Apache Tapestry - Hibernate 模块

在本章中，我们将讨论BeanEditForm和Grid组件与Hibernate的集成。 Hibernate 通过 Hibernate 模块集成到 Tapestry 中。 要启用 hibernate 模块，请在 pom.xml 文件中添加 Tapestry-hibernate 依赖项和可选的 hsqldb。 现在，通过位于资源文件夹根目录下的 hibernate.cfg.xml 文件配置 hibernate。

pom.xml (partial)

<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>

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/sampleapp;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> 

让我们看看如何使用 BeanEditForm 组件创建员工添加页面和使用 Grid 组件创建员工列表页面。 持久层由 Hibernate 模块处理。

创建一个员工类并使用@Entity注解对其进行修饰。 然后，为相关字段添加验证注解，并为id字段添加hibernate相关注解@Id和@GenerateValue。 另外，将性别创建为枚举类型。

Employee.java

package com.example.MyFirstApplication.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;  

@Entity 
public class Employee {  
   @Id 
   @GeneratedValue(strategy = GenerationType.IDENTITY) 
   @NonVisual 
   public Long id;  

   @Validate("required") 
   public String firstName;  
 
   @Validate("required") 
   public String lastName; 

   @Validate("required") 
   public String userName;  

   @Validate("required") 
   public String password;  

   @Validate("required") 
   public String email;  
   public String phone;  

   @Validate("required") 
   public String Street;  

   @Validate("required") 
   public String city;  

   @Validate("required") 
   public String state;  

   @Validate("required,regexp=^\d{5}(-\d{4})?$") 
   public String zip; 
} 
Gender.java (enum)  
package com.example.MyFirstApplication.data;  

public enum Gender { 
   Male, Female 
}

在pages下新建文件夹employee中创建员工列表页面ListEmployee.java，并在/src/main/resources/pages/employee下创建相应的模板文件ListEmployee.tml> 文件夹。 Tapestry 通过删除重复数据为子文件夹提供短 URL。

例如，ListEmployee 页面可以通过普通 URL（/employee/listtemployee）和短 URL（/employee/list）访问。

使用@Inject注解将Hibernate会话注入列表页面。 在列表页面中定义属性 getEmployees 并使用注入的会话对象将员工填充到其中。 完成employee（员工）类别的代码，如下所示。

ListEmployee.java

package com.example.MyFirstApplication.pages.employee;  

import java.util.List;  
import org.apache.tapestry5.annotations.Import; 
import org.apache.tapestry5.ioc.annotations.Inject;  
import org.hibernate.Session; 
import com.example.MyFirstApplication.entities.Employee; 
import org.apache.tapestry5.annotations.Import;  
@Import(stylesheet="context:mybootstrap/css/bootstrap.css") 

public class ListEmployee { 
   @Inject 
   private Session session; 
   
   public List<Employee> getEmployees() { 
      return session.createCriteria(Employee.class).list(); 
   } 
} 

为 ListEmployee 类创建模板文件。 该模板将有两个主要组件，它们是 −

• PageLink − 创建员工链接页面。

• Grid − 用于呈现员工详细信息。 网格组件具有用于注入员工列表的属性源，并包含用于包含要呈现的字段的属性。

ListEmployee.tml (list all employees)

<html t:type = "simplelayout" title = "List Employee" 
   xmlns:t = "http://tapestry.apache.org/schema/tapestry_5_4.xsd"> 
   <h1>Employees</h1> 
   
   <ul> 
      <li><t:pagelink page = "employee/create">Create new employee</t:pagelink></li> 
   </ul>  
   <t:grid source = "employees" 
      include = "userName,firstName,lastName,gender,dateOfBirth,phone,city,state"/>  
</html>

创建员工创建模板文件并包含 BeanEditForm 组件。 该组件具有以下属性 −

• object − 导入源。

• reorder − 定义要呈现的字段的顺序。

• submitlabel − 表单提交按钮的消息

完整代码如下 −

<html t:type = "simplelayout" title = "Create New Address" 
   xmlns:t = "http://tapestry.apache.org/schema/tapestry_5_4.xsd">  
   <t:beaneditform  
      object = "employee"  
      submitlabel = "message:submit-label" 
      reorder = "userName,password,firstName,lastName,
      dateOfBirth,gender,email,phone,s treet,city,state,zip" />  
</html> 

创建员工创建类并包含会话、员工属性、列表页面（导航链接）并定义组件的 OnSuccess 事件（更新数据的位置）。 会话数据使用 hibernate 会话保存到数据库中。

完整代码如下 −

package com.example.MyFirstApplication.pages.employee;  

import com.example.MyFirstApplication.entities.Employee; 
import com.example.MyFirstApplication.pages.employee.ListEmployee; 
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 CreateEmployee { 
   @Property 
   private Employee employee;  
   @Inject 
   private Session session;  
   @InjectPage 
   private ListEmployee listPage;  
   @CommitAfter 
   Object onSuccess() { 
      session.persist(employee);  
      return listPage; 
   } 
}

添加 CreateEmployee.properties 文件并包含要在表单验证中使用的消息。 完整代码如下 −

zip-regexp=^\d{5}(-\d{4})?$ 
zip-regexp-message = Zip Codes are five or nine digits. Example: 02134 or 901251655. 
submit-label = Create Employee 

员工创建页面和列表页面截图如下 −