JPA 2 静态Metamodel与Hibernate Metamodel Generator

        其实本文并不是要讲解Hibernate Metamodel Generator的使用方法，因为大家可以从其参考文献(http://docs.jboss.org/hibernate/jpamodelgen/1.0/reference/en-US/html/ )中获取这些知识。我只是想说说最近我体会到的Metamodel带给开发人员的好处，顺带提一提Hibernate Metamodel Generator带给我们的便利。

 

        java开发人员在开发web程序时可能经常会遇到这样的开发场景：在后台代码中读取前台发送的request中的参数值用于构建一个javabean，例如，下面是一个Person实体类的代码：

 

public class Person implements Serializable { @Id @GeneratedValue(strategy = GenerationType.AUTO) private Long id; @Embedded private PersonName personName; @Temporal(javax.persistence.TemporalType.DATE) private Date birthday; private char gender; public Long getId() { return id; } public Date getBirthday() { return birthday; } public void setBirthday(Date birthday) { this.birthday = birthday; } public char getGender() { return gender; } public void setGender(char gender) { this.gender = gender; } public String getName() { return personName.toString(); } public String getFirstName() { return personName.getFirstName(); } public void setFirstName(String firstName) { personName.setFirstName(firstName); } public String getLastName() { return personName.getLastName(); } public void setLastName(String lastName) { personName.setLastName(lastName); } }

 

        下面的代码就是从request中读取参数值来构建一个 Person对象：

 

Person person = new Person(); person.setFirstName(request.getParameter("firstName")); person.setLastName(request.getParameter("lastName")); ...

 

        上面的代码有几个问题：1、并不是健壮的代码，原因是在代码中使用太多的字符串常量，难免会出现拼写错误，而这种错误并不容易被发现，特别是与javabean的类型和属性对应的字符串会在程序中的各个层出现，增加了犯拼写错误的风险；2、代码的可读性较差，原因是仅凭属性名，我们无法判断该属性对应的类；3、难以维护，当javabean的属性更改时，为了保持代码的一致性 ，相对应的字符串常量也应更改，这给开发人员造成了负担。

 

        我现在推荐两种方式来解决该问题，一种是在javabean中加入这些bean的元数据（Meta data）信息，以Person类为例，加入 元数据（Meta data）信息后代码如下：

 

public class Person implements Serializable { public static final String ENTITY_NAME = "Person"; public static final String ID = "id"; public static final String PERSON_NAME = "personName"; public static final String BIRTHDAY = "birthday"; public static final String GENDER = "gender"; public static final String NAME = "name"; public static final String FIRSTNAME = "firstName"; public static final String LASTNAME = "lastName"; ...

 

        即关于Person的模型信息都通过公共的静态常量字段表示，这样，上诉获取request中的参数值的方法就可以改为：

 

Person person = new Person(); person.setFirstName(request.getParameter(Person.FIRSTNAME)); person.setLastName(request.getParameter(Person.LASTNAME)); ...

 

        这种方法的优点是简单，缺点在于增加开发人员的工作量。开发人员在每编写一个实体类时都必须要增加描述该实体类的元信息。所以该方法适用于规模较小的系统。该方法另一个不足就是并没有给出完整的元数据信息，而只是给出了类名和属性名，没有给出属性的类型等其他信息。

 

        另一种方法就是JPA 2规范提出的静态Metamodel，关于规范在这部分的说明，大家请见(http://docs.jboss.org/hibernate/stable/entitymanager/reference/en/html/metamodel.html )。hibernate提供了一个工具包 Hibernate Metamodel Generator 来帮助开发人员生成反映实体类的静态Metamodel，对于该包的详细说明与使用方法，请参见本文开头给出的链接。对与上文的Person类， Hibernate Metamodel Generator自动生成的静态Metamodel的代码如下：

 

import java.util.Date; import javax.persistence.metamodel.SingularAttribute; import javax.persistence.metamodel.StaticMetamodel; @StaticMetamodel(Person.class) public abstract class Person_ extends com.kingdee.felix.contact.domain.BasicModel_ { public static volatile SingularAttribute<Person, Long> id; public static volatile SingularAttribute<Person, Date> birthday; public static volatile SingularAttribute<Person, Character> gender; public static volatile SingularAttribute<Person, PersonName> personName; }

 

        类Person_就是反映实体类Person的静态元模型，并且Person_的各静态字段分别对应Person的各属性，而且这些静态字段能提供包括属性名在内的各种信息。关于静态Metamodel的使用方式，请参见j2ee6的api文档(http://java.sun.com/javaee/6/docs/api/overview-summary.html )

 

 

         本文只是提出了实体类的元数据的用途，以及两种获取元数据的方法，并未对这两种方法作深入的示例与分析，希望有经验的java开发人员能从本文中获取一些使用元数据的技巧。