第 2 章 实体Bean
     

现在EJB3实体Bean是纯粹的POJO.实际上这表达了和Hibernate持久化实体对象同样的概念. 它们的映射都通过JDK5.0注解来定义(EJB3规范中的XML描述语法至今还没有最终定下来). 注解分为两个部分,分别是逻辑映射注解和物理映射注解, 通过逻辑映射注解可以描述对象模型,类之间的关系等等, 而物理映射注解则描述了物理的schema,表,列,索引等等. 下面我们在代码中将混合使用这两种类型的注解.

EJB3注解的API定义在javax.persistence.*包里面. 大部分和JDK5兼容的IDE(象Eclipse, IntelliJ IDEA 和Netbeans等等)都提供了注解接口和属性的自动完成功能. (这些不需要IDE提供特别的EJB3支持模块,因为EJB3注解是标准的JDK5注解)

请阅读JBoss EJB 3.0指南或者直接阅读Hibernate Annotations测试代码以获取更多的可运行实例.Hibernate Annotations提供的大部分单元测试代码都演示了实际的例子,是一个获取灵感的好地方.

每一个持久化POJO类都是一个实体bean,这可以通过在类的定义中使用@Entity注解来进行声明:

@Entity
public class Flight implements Serializable {Long id;@Idpublic Long getId() { return id; }public void setId(Long id) { this.id = id; }
}

通过@Entity注解将一个类声明为一个实体bean(即一个持久化POJO类), @Id注解则声明了该实体bean的标识属性. 其他的映射定义是隐式的.这种以隐式映射为主体,以显式映射为例外的配置方式在新的EJ3规范中处于非常重要的位置, 和以前的版本相比有了质的飞跃. 在上面这段代码中:Flight类映射到Flight表,并使用id列作为主键列.

在对一个类进行注解时,你可以选择对它的的属性或者方法进行注解,根据你的选择,Hibernate的访问类型分别为 fieldproperty. EJ3规范要求在需要访问的元素上进行注解声明,例如,如果访问类型为property就要在getter方法上进行注解声明, 如果访问类型为field就要在字段上进行注解声明.应该尽量避免混合使用这两种访问类型. Hibernate根据@Id@EmbeddedId的位置来判断访问类型.

Every non static non transient property (field or method) of an entity bean is considered persistent, unless you annotate it as@Transient. Not having an annotation for your property is equivalent to the appropriate@Basic annotation. The @Basic annotation allows you to declare the fetching strategy for a property:

实体bean中所有的非static非transient的属性都可以被持久化, 除非你将其注解为@Transient.所有没有定义注解的属性等价于在其上面添加了@Basic注解. 通过@Basic注解可以声明属性的获取策略(fetch strategy):

public transient int counter; //transient propertyprivate String firstname; //persistent property@Transient
String getLengthInMeter() { ... } //transient propertyString getName() {... } // persistent property@Basic
int getLength() { ... } // persistent property@Basic(fetch = FetchType.LAZY)
String getDetailedComment() { ... } // persistent property@Temporal(TemporalType.TIME)
java.util.Date getDepartureTime() { ... } // persistent property           @Enumerated(EnumType.STRING)
Starred getNote() { ... } //enum persisted as String in database

上面这个例子中,counter是一个transient的字段, lengthInMeter的getter方法被注解为@Transient, entity manager将忽略这些字段和属性. 而name,length,firstname 这几个属性则是被定义为可持久化和可获取的.对于简单属性来说,默认的获取方式是即时获取(early fetch). 当一个实体Bean的实例被创建时,Hibernate会将这些属性的值从数据库中提取出来,保存到Bean的属性里. 与即时获取相对应的是延迟获取(lazy fetch).如果一个属性的获取方式是延迟获取 (比如上面例子中的detailedComment属性), Hibernate在创建一个实体Bean的实例时,不会即时将这个属性的值从数据库中读出. 只有在该实体Bean的这个属性第一次被调用时,Hibernate才会去获取对应的值. 通常你不需要对简单属性设置延迟获取(lazy simple property),千万不要和延迟关联获取(lazy association fetch)混淆了 (译注:这里指不要把lazy simple property和lazy association fetch混淆了).

注意

为了启用属性级的延迟获取,你的类必须经过特殊处理(instrumented): 字节码将被织入原始类中来实现延迟获取功能, 详情参考Hibernate参考文档.如果不对类文件进行字节码特殊处理, 那么属性级的延迟获取将被忽略.

推荐的替代方案是使用EJB-QL或者Criteria查询的投影(projection)功能.

Hibernate和EJB3都支持所有基本类型的属性映射. 这些基本类型包括所有的Java基本类型,及其各自的wrapper类和serializable类. Hibernate Annotations还支持将内置的枚举类型映射到一个顺序列(保存了相应的序列值) 或一个字符串类型的列(保存相应的字符串).默认是保存枚举的序列值, 但是你可以通过@Enumerated注解来进行调整(见上面例子中的note属性).

在核心的Java API中并没有定义时间精度(temporal precision). 因此处理时间类型数据时,你还需要定义将其存储在数据库中所预期的精度. 在数据库中,表示时间类型的数据有DATE,TIME, 和TIMESTAMP三种精度(即单纯的日期,时间,或者两者兼备). 可使用@Temporal注解来调整精度.

@Lob注解表示属性将被持久化为Blob或者Clob类型, 具体取决于属性的类型, java.sql.Clob, Character[], char[]java.lang.String这些类型的属性都被持久化为Clob类型, 而java.sql.Blob,Byte[],byte[] 和 serializable类型则被持久化为Blob类型.

@Lob
public String getFullText() {return fullText;
}@Lob
public byte[] getFullCode() {return fullCode;
}

如果某个属性实现了java.io.Serializable同时也不是基本类型, 并且没有在该属性上使用@Lob注解, 那么Hibernate将使用自带的serializable类型.

使用 @Column 注解可将属性映射到列. 使用该注解来覆盖默认值(关于默认值请参考EJB3规范). 在属性级使用该注解的方式如下:

  • 不进行注解

  • @Basic一起使用

  • @Version一起使用

  • @Lob一起使用

  • @Temporal一起使用

  • @org.hibernate.annotations.CollectionOfElements一起使用 (只针对Hibernate )

@Entity
public class Flight implements Serializable {
...
@Column(updatable = false, name = "flight_name", nullable = false, length=50)
public String getName() { ... }

在上面这个例子中,name属性映射到flight_name列. 该字段不允许为空,长度为50,并且是不可更新的(也就是属性值是不变的).

上面这些注解可以被应用到正规属性上例如@Id@Version属性.

@Column(name="columnName";                                (1)boolean unique() default false;                   (2)boolean nullable() default true;                  (3)boolean insertable() default true;                (4)boolean updatable() default true;                 (5)String columnDefinition() default "";             (6)String table() default "";                        (7)int length() default 255;                         (8)int precision() default 0; // decimal precision   (9)int scale() default 0; // decimal scale
(1)

name 可选,列名(默认值是属性名)

(2)

unique 可选,是否在该列上设置唯一约束(默认值false)

(3)

nullable 可选,是否设置该列的值可以为空(默认值false)

(4)

insertable 可选,该列是否作为生成的insert语句中的一个列(默认值true)

(5)

updatable 可选,该列是否作为生成的update语句中的一个列(默认值true)

(6)

columnDefinition 可选: 为这个特定列覆盖SQL DDL片段 (这可能导致无法在不同数据库间移植)

(7)

table 可选,定义对应的表(默认为主表)

(8)

length 可选,列长度(默认值255)

(8)

precision 可选,列十进制精度(decimal precision)(默认值0)

(10)

scale 可选,如果列十进制数值范围(decimal scale)可用,在此设置(默认值0)

在实体中可以定义一个嵌入式组件(embedded component), 甚至覆盖该实体中原有的列映射. 组件类必须在类一级定义@Embeddable注解. 在特定的实体的关联属性上使用@Embedded@AttributeOverride注解可以覆盖该属性对应的嵌入式对象的列映射:

@Entity
public class Person implements Serializable {// Persistent component using defaultsAddress homeAddress;@Embedded@AttributeOverrides( {@AttributeOverride(name="iso2", column = @Column(name="bornIso2") ),@AttributeOverride(name="name", column = @Column(name="bornCountryName") )} )Country bornIn;...
}
@Embeddable
public class Address implements Serializable {String city;Country nationality; //no overriding here
}
@Embeddable
public class Country implements Serializable {private String iso2;@Column(name="countryName") private String name;public String getIso2() { return iso2; }public void setIso2(String iso2) { this.iso2 = iso2; }public String getName() { return name; }public void setName(String name) { this.name = name; }...
}

嵌入式对象继承其所属实体中定义的访问类型 (注意:这可以通过使用Hibernate提供的@AccessType注解来覆盖原有值)(请参考Hibernate Annotation Extensions).

在上面的例子中,实体bean Person 有两个组件属性, 分别是homeAddressbornIn. 我们可以看到homeAddress 属性并没有注解. 但是Hibernate自动检测其对应的Address类中的@Embeddable注解, 并将其看作一个持久化组件.对于Country中已映射的属性, 则使用@Embedded@AttributeOverride 注解来覆盖原来映射的列名. 正如你所看到的, Address对象中还内嵌了Country对象, 这里和homeAddress一样使用了Hibernate和EJB3自动检测机制. 目前EJB3规范还不支持覆盖多层嵌套(即嵌入式对象中还包括其他嵌入式对象)的列映射. 不过Hibernate通过在表达式中使用"."符号表达式提供了对此特征的支持.

@Embedded@AttributeOverrides( {@AttributeOverride(name="city", column = @Column(name="fld_city") ),@AttributeOverride(name="nationality.iso2", column = @Column(name="nat_Iso2") ),@AttributeOverride(name="nationality.name", column = @Column(name="nat_CountryName") )//nationality columns in homeAddress are overridden} )Address homeAddress;

Hibernate注解支持很多EJB3规范中没有明确定义的特性. 例如,可以在嵌入式对象上添加 @MappedSuperclass注解, 这样可以将其父类的属性持久(详情请查阅@MappedSuperclass).

Hibernate现在支持在嵌入式对象中使用关联注解(如@*ToOne@*ToMany). 而EJB3规范尚不支持这样的用法。你可以使用@AssociationOverride注解来覆写关联列.

在同一个实体中使用两个同类型的嵌入对象, 其默认列名是无效的:至少要对其中一个进行明确声明. Hibernate在这方面走在了EJB3规范的前面, Hibernate提供了NamingStrategy, 在使用Hibernate时, 通过NamingStrategy你可以对默认的机制进行扩展.DefaultComponentSafeNamingStrategy 在默认的EJB3NamingStrategy上进行了小小的提升, 允许在同一实体中使用两个同类型的嵌入对象而无须额外的声明.

如果某属性没有注解,该属性将遵守下面的规则:

  • 如果属性为单一类型,则映射为@Basic
  • 否则,如果属性对应的类型定义了@Embeddable注解,则映射为@Embedded
  • 否则,如果属性对应的类型实现了Serializable, 则属性被映射为@Basic并在一个列中保存该对象的serialized版本
  • 否则,如果该属性的类型为java.sql.Clob 或 java.sql.Blob,则作为@Lob并映射到适当的LobType.

使用@Id注解可以将实体bean中的某个属性定义为标识符(identifier). 该属性的值可以通过应用自身进行设置, 也可以通过Hiberante生成(推荐). 使用@GeneratedValue注解可以定义该标识符的生成策略:

  • AUTO - 可以是identity column类型,或者sequence类型或者table类型,取决于不同的底层数据库.
  • TABLE - 使用表保存id值
  • IDENTITY - identity column
  • SEQUENCE - sequence

和EJB3规范相比,Hibernate提供了更多的id生成器.详情请查阅 Hibernate Annotation Extensions .

下面的例子展示了使用SEQ_STORE配置的sequence生成器

@Id @GeneratedValue(strategy=GenerationType.SEQUENCE, generator="SEQ_STORE")
public Integer getId() { ... }

下面这个例子使用的是identity生成器

@Id @GeneratedValue(strategy=GenerationType.IDENTITY)
public Long getId() { ... }

AUTO生成器适用于可移植的应用(在多个DB间切换). 多个@Id可以共享同一个identifier生成器,只要把generator属性设成相同的值就可以了. 通过@SequenceGenerator@TableGenerator,你可以配置不同的identifier生成器. 每一个identifier生成器都有自己的适用范围,可以是应用级(application level)和类一级(class level). 类一级的生成器在外部是不可见的, 而且类一级的生成器可以覆盖应用级的生成器. 应用级的生成器则定义在包一级(package level)(如package-info.java):

@javax.persistence.TableGenerator(name="EMP_GEN",table="GENERATOR_TABLE",pkColumnName = "key",valueColumnName = "hi"pkColumnValue="EMP",allocationSize=20
)
@javax.persistence.SequenceGenerator(name="SEQ_GEN",sequenceName="my_sequence"
)
package org.hibernate.test.metadata;

如果在org.hibernate.test.metadata包下面的 package-info.java文件用于初始化EJB配置, 那么该文件中定义的 EMP_GENSEQ_GEN都是应用级的生成器.EMP_GEN定义了一个使用hilo算法 (max_lo为20)的id生成器(该生成器将id的信息存在数据库的某个表中.). id的hi值保存在GENERATOR_TABLE中. 在该表中pkColumnName"key"等价于 pkColumnValue "EMP", 而valueColumnName "hi"中存储的是下一个要使用的最大值.

SEQ_GEN则定义了一个sequence 生成器, 其对应的sequence名为 my_sequence. 注意目前Hibernate Annotations还不支持sequence 生成器中的 initialValueallocationSize参数.

下面这个例子展示了定义在类范围(class scope)的sequence生成器:

@Entity
@javax.persistence.SequenceGenerator(name="SEQ_STORE",sequenceName="my_sequence"
)
public class Store implements Serializable {private Long id;@Id @GeneratedValue(strategy=GenerationType.SEQUENCE, generator="SEQ_STORE")public Long getId() { return id; }
}

在这个例子中,Store类使用名为my_sequence的sequence,并且SEQ_STORE 生成器对于其他类是不可见的. 注意在org.hibernate.test.metadata.id包下的测试代码有更多演示Hibernate Annotations用法的例子..

下面是定义组合主键的几种语法:

  • 将组件类注解为@Embeddable,并将组件的属性注解为@Id
  • 将组件的属性注解为@EmbeddedId
  • 将类注解为@IdClass,并将该实体中所有属于主键的属性都注解为@Id

对于EJB2的开发人员来说 @IdClass是很常见的, 但是对于Hibernate的用户来说就是一个崭新的用法. 组合主键类对应了一个实体类中的多个字段或属性, 而且主键类中用于定义主键的字段或属性和 实体类中对应的字段或属性在类型上必须一致.下面我们看一个例子:

@Entity
@IdClass(FootballerPk.class)
public class Footballer {//part of the id key@Id public String getFirstname() {return firstname;}public void setFirstname(String firstname) {this.firstname = firstname;}//part of the id key@Id public String getLastname() {return lastname;}public void setLastname(String lastname) {this.lastname = lastname;}public String getClub() {return club;}public void setClub(String club) {this.club = club;}//appropriate equals() and hashCode() implementation
}@Embeddable
public class FootballerPk implements Serializable {//same name and type as in Footballerpublic String getFirstname() {return firstname;}public void setFirstname(String firstname) {this.firstname = firstname;}//same name and type as in Footballerpublic String getLastname() {return lastname;}public void setLastname(String lastname) {this.lastname = lastname;}//appropriate equals() and hashCode() implementation
}

如上, @IdClass指向对应的主键类.

Hibernate支持在组合标识符中定义关联(就像使用普通的注解一样),而EJB3规范并不支持此类用法.

@Entity
@AssociationOverride( name="id.channel", joinColumns = @JoinColumn(name="chan_id") )
public class TvMagazin {@EmbeddedId public TvMagazinPk id;@Temporal(TemporalType.TIME) Date time;
}@Embeddable
public class TvMagazinPk implements Serializable {@ManyToOnepublic Channel channel;public String name;@ManyToOnepublic Presenter presenter;
}

EJB3支持三种类型的继承映射:

  • 每个类一张表(Table per class)策略: 在Hibernate中对应<union-class>元素:
  • 每个类层次结构一张表(Single table per class hierarchy)策略:在Hibernate中对应<subclass>元素
  • 连接的子类(Joined subclasses)策略:在Hibernate中对应 <joined-subclass>元素

你可以用 @Inheritance注解来定义所选择的策略. 这个注解需要在每个类层次结构(class hierarchy) 最顶端的实体类上使用.

注意

目前还不支持在接口上进行注解.

有时候通过一个(技术上或业务上)父类共享一些公共属性是很有用的, 同时还不用将该父类作为映射的实体(也就是该实体没有对应的表). 这个时候你需要使用@MappedSuperclass注解来进行映射.

@MappedSuperclass
public class BaseEntity {@Basic@Temporal(TemporalType.TIMESTAMP)public Date getLastUpdate() { ... }public String getLastUpdater() { ... }...
}@Entity class Order extends BaseEntity {@Id public Integer getId() { ... }...
}

在数据库中,上面这个例子中的继承的层次结构最终以Order表的形式出现, 该表拥有id,lastUpdatelastUpdater三个列.父类中的属性映射将复制到其子类实体. 注意这种情况下的父类不再处在继承层次结构的顶端.

注意

注意,没有注解为@MappedSuperclass的父类中的属性将被忽略.

注意

除非显式使用Hibernate annotation中的@AccessType注解, 否则将从继承层次结构的根实体中继承访问类型(包括字段或方法)

注意

这对于@Embeddable对象的父类中的属性持久化同样有效. 只需要使用@MappedSuperclass注解即可 (虽然这种方式不会纳入EJB3标准)

注意

可以将处在在映射继承层次结构的中间位置的类注解为@MappedSuperclass.

注意

在继承层次结构中任何没有被注解为@MappedSuperclass@Entity的类都将被忽略.

你可以通过 @AttributeOverride注解覆盖实体父类中的定义的列. 这个注解只能在继承层次结构的顶端使用.

@MappedSuperclass
public class FlyingObject implements Serializable {public int getAltitude() {return altitude;}@Transientpublic int getMetricAltitude() {return metricAltitude;}@ManyToOnepublic PropulsionType getPropulsion() {return metricAltitude;}...
}@Entity
@AttributeOverride( name="altitude", column = @Column(name="fld_altitude") )
@AssociationOverride( name="propulsion", joinColumns = @JoinColumn(name="fld_propulsion_fk") )
public class Plane extends FlyingObject {...
}

在上面这个例子中,altitude属性的值最终将持久化到Plane 表的fld_altitude列.而名为propulsion的关联则保存在fld_propulsion_fk外间列.

你可以为@Entity@MappedSuperclass注解的类 以及那些对象为@Embeddable的属性定义@AttributeOverride@AssociationOverride.

使用@OneToOne注解可以建立实体bean之间的一对一的关联. 一对一关联有三种情况: 一是关联的实体都共享同样的主键, 二是其中一个实体通过外键关联到另一个实体的主键 (注意要模拟一对一关联必须在外键列上添加唯一约束). 三是通过关联表来保存两个实体之间的连接关系 (注意要模拟一对一关联必须在每一个外键上添加唯一约束).

首先,我们通过共享主键来进行一对一关联映射:

@Entity
public class Body {@Idpublic Long getId() { return id; }@OneToOne(cascade = CascadeType.ALL)@PrimaryKeyJoinColumnpublic Heart getHeart() {return heart;}...
}
@Entity
public class Heart {@Idpublic Long getId() { ...}
}

上面的例子通过使用注解@PrimaryKeyJoinColumn定义了一对一关联.

下面这个例子使用外键列进行实体的关联.

@Entity
public class Customer implements Serializable {@OneToOne(cascade = CascadeType.ALL)@JoinColumn(name="passport_fk")public Passport getPassport() {...}@Entity
public class Passport implements Serializable {@OneToOne(mappedBy = "passport")public Customer getOwner() {...
}

上面这个例子中,Customer 通过Customer 表中名为的passport_fk 外键列和Passport关联.@JoinColumn注解定义了联接列(join column). 该注解和@Column注解有点类似, 但是多了一个名为referencedColumnName的参数. 该参数定义了所关联目标实体中的联接列. 注意,当referencedColumnName关联到非主键列的时候, 关联的目标类必须实现Serializable, 还要注意的是所映射的属性对应单个列(否则映射无效).

一对一关联可能是双向的.在双向关联中, 有且仅有一端是作为主体(owner)端存在的:主体端负责维护联接列(即更新). 对于不需要维护这种关系的从表则通过mappedBy属性进行声明.mappedBy的值指向主体的关联属性. 在上面这个例子中,mappedBy的值为passport. 最后,不必也不能再在被关联端(owned side)定义联接列了,因为已经在主体端进行了声明.

如果在主体没有声明@JoinColumn,系统自动进行处理: 在主表(owner table)中将创建联接列, 列名为:主体的关联属性名+下划线+被关联端的主键列名. 在上面这个例子中是passport_id, 因为Customer中关联属性名为passport,Passport的主键是id.

The third possibility (using an association table) is very exotic.

第三种方式也许是最另类的(通过关联表).

@Entity
public class Customer implements Serializable {@OneToOne(cascade = CascadeType.ALL)@JoinTable(name = "CustomerPassports",joinColumns = @JoinColumn(name="customer_fk"),inverseJoinColumns = @JoinColumn(name="passport_fk"))public Passport getPassport() {...}@Entity
public class Passport implements Serializable {@OneToOne(mappedBy = "passport")public Customer getOwner() {...
}

Customer通过名为 CustomerPassports的关联表和Passport关联; 该关联表拥有名为passport_fk的外键列,该 外键指向Passport表,该信息定义为inverseJoinColumn的属性值, 而customer_fk外键列指向Customer表, 该信息定义为joinColumns的属性值.

这种关联可能是双向的.在双向关联中, 有且仅有一端是作为主体端存在的:主体端负责维护联接列(即更新). 对于不需要维护这种关系的从表则通过mappedBy属性进行声明.mappedBy的值指向主体的关联属性. 在上面这个例子中,mappedBy的值为passport. 最后,不必也不能再在被关联端(owned side)定义联接列了,因为已经在主体端进行了声明.

你必须明确定义关联表名和关联列名.

在实体属性一级使用@ManyToOne注解来定义多对一关联:

@Entity()
public class Flight implements Serializable {@ManyToOne( cascade = {CascadeType.PERSIST, CascadeType.MERGE} )@JoinColumn(name="COMP_ID")public Company getCompany() {return company;}...
}

其中@JoinColumn是可选的,关联字段默认值和一对一 (one to one)关联的情况相似, 列名为:主体的关联属性名+下划线+被关联端的主键列名. 在这个例子中是company_id, 因为关联的属性是company,Company的主键是id.

@ManyToOne注解有一个名为targetEntity的参数, 该参数定义了目标实体名.通常不需要定义该参数, 因为在大部分情况下默认值(表示关联关系的属性类型)就可以很好的满足要求了. 不过下面这种情况下这个参数就显得有意义了:使用接口作为返回值而不是常见的实体.

@Entity()
public class Flight implements Serializable {@ManyToOne( cascade = {CascadeType.PERSIST, CascadeType.MERGE}, targetEntity=CompanyImpl.class )@JoinColumn(name="COMP_ID")public Company getCompany() {return company;}...
}public interface Company {...

对于多对一也可以通过关联表的方式来映射。 通过@JoinTable注解可定义关联表, 该关联表包含了指回实体表的外键(通过@JoinTable.joinColumns) 以及指向目标实体表的外键(通过@JoinTable.inverseJoinColumns).

@Entity()
public class Flight implements Serializable {@ManyToOne( cascade = {CascadeType.PERSIST, CascadeType.MERGE} )@JoinTable(name="Flight_Company",joinColumns = @JoinColumn(name="FLIGHT_ID"),inverseJoinColumns = @JoinColumn(name="COMP_ID"))public Company getCompany() {return company;}...
}

你可以对 Collection ,List (指有序列表, 而不是索引列表),MapSet这几种类型进行映射. EJB3规范定义了怎么样使用@javax.persistence.OrderBy 注解来对有序列表进行映射: 该注解接受的参数格式:用逗号隔开的(目标实体)属性名及排序指令, 如firstname asc, age desc,如果该参数为空,则默认以id对该集合进行排序. 如果某个集合在数据库中对应一个关联表(association table)的话,你不能在这个集合属性上面使用@OrderBy注解. 对于这种情况的处理方法,请参考Hibernate Annotation Extensions. EJB3 允许你利用目标实体的一个属性作为Map的key, 这个属性可以用@MapKey(name="myProperty")来声明. 如果使用@MapKey注解的时候不提供属性名, 系统默认使用目标实体的主键. map的key使用和属性相同的列:不需要为map key定义专用的列,因为map key实际上就表达了一个目标属性。 注意一旦加载,key不再和属性保持同步, 也就是说,如果你改变了该属性的值,在你的Java模型中的key不会自动更新 (请参考Hibernate Annotation Extensions). 很多人被<map>@MapKey弄糊涂了。 其他它们有两点区别.@MapKey目前还有一些限制,详情请查看论坛或者 我们的JIRA缺陷系统。 注意一旦加载,key不再和属性保持同步, 也就是说,如果你改变了该属性的值,在你的Java模型中的key不会自动更新. (Hibernate 3中Map支持的方式在当前的发布版中还未得到支持).

Hibernate将集合分以下几类.

表 2.1. 集合语义

语义 Java实现类 注解
Bag 语义 java.util.List, java.util.Collection @org.hibernate.annotations.CollectionOfElements 或 @OneToMany 或 @ManyToMany
List 语义 java.util.List (@org.hibernate.annotations.CollectionOfElements 或 @OneToMany 或 @ManyToMany) 以及 @org.hibernate.annotations.IndexColumn
Set 语义 java.util.Set @org.hibernate.annotations.CollectionOfElements 或 @OneToMany 或 @ManyToMany
Map 语义 java.util.Map (@org.hibernate.annotations.CollectionOfElements 或 @OneToMany 或 @ManyToMany) 以及 (空 或 @org.hibernate.annotations.MapKey/MapKeyManyToMany(支持真正的map), 或 @javax.persistence.MapKey

从上面可以明确地看到,没有@org.hibernate.annotations.IndexColumn 注解的java.util.List集合将被看作bag类.

EJB3规范不支持原始类型,核心类型,嵌入式对象的集合.但是Hibernate对此提供了支持 (详情参考 Hibernate Annotation Extensions).

@Entity public class City {@OneToMany(mappedBy="city")@OrderBy("streetName")public List<Street> getStreets() {return streets;}
...
}@Entity public class Street {public String getStreetName() {return streetName;}@ManyToOnepublic City getCity() {return city;}...
}@Entity
public class Software {@OneToMany(mappedBy="software")@MapKey(name="codeName")public Map<String, Version> getVersions() {return versions;}
...
}@Entity
@Table(name="tbl_version")
public class Version {public String getCodeName() {...}@ManyToOnepublic Software getSoftware() { ... }
...
}

上面这个例子中,City 中包括了以streetName排序的Street的集合. 而Software中包括了以codeName作为 key和以Version作为值的Map.

除非集合为generic类型,否则你需要指定targetEntity. 这个注解属性接受的参数为目标实体的class.

在属性级使用 @OneToMany注解可定义一对多关联.一对多关联可以是双向关联.

和其他许多注解一样,在多对多关联中很多值是自动生成. 当双向多对多关联中没有定义任何物理映射时,Hibernate根据以下规则生成相应的值. 关联表名:主表表名+_下划线+从表表名, 关联到主表的外键名:主表名+_下划线+主表中的主键列名. 关联到从表的外键名:主表中用于关联的属性名+_下划线+从表的主键列名. 以上规则对于双向一对多关联同样有效.

@Entity
public class Store {@ManyToMany(cascade = CascadeType.PERSIST)public Set<City> getImplantedIn() {...}
}@Entity
public class City {... //no bidirectional relationship
}

上面这个例子中,Store_Table作为联接表. Store_id列是联接到Store表的外键. 而implantedIn_id列则联接到City表.

当双向多对多关联中没有定义任何物理映射时, Hibernate根据以下规则生成相应的值 关联表名: :主表表名+_下划线+从表表名, 关联到主表的外键名:从表用于关联的属性名+_下划线+主表中的主键列名. 关联到从表的外键名:主表用于关联的属性名+_下划线+从表的主键列名. 以上规则对于双向一对多关联同样有效.

@Entity
public class Store {@ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})public Set<Customer> getCustomers() {...}
}@Entity
public class Customer {@ManyToMany(mappedBy="customers")public Set<Store> getStores() {...}
}

在上面这个例子中,Store_Customer作为联接表. stores_id列是联接到Store表的外键, 而customers_id列联接到City表.

也许你已经注意到了cascade属性接受的值为CascadeType数组. 在EJB3中的cascade的概念和Hibernate中的传播性持久化以及cascade操作非常类似, 但是在语义上有细微的区别,支持的cascade类型也有点区别:

  • CascadeType.PERSIST: 如果一个实体是受管状态, 或者当persist()函数被调用时, 触发级联创建(create)操作
  • CascadeType.MERGE: 如果一个实体是受管状态, 或者当merge()函数被调用时, 触发级联合并(merge)操作
  • CascadeType.REMOVE: 当delete()函数被调用时, 触发级联删除(remove)操作
  • CascadeType.REFRESH: 当refresh()函数被调用时, 触发级联更新(refresh)操作
  • CascadeType.ALL: 以上全部

关于cascading, create/merge的语义请参考EJB3规范的6.3章节.

组合主键使用一个可嵌入的类作为主键表示,因此你需要使用@Id@Embeddable两个注解. 还有一种方式是使用@EmbeddedId注解.注意所依赖的类必须实现 serializable以及实现equals()/hashCode()方法. 你也可以如Mapping identifier properties一章中描述的办法使用@IdClass注解.

@Entity
public class RegionalArticle implements Serializable {@Idpublic RegionalArticlePk getPk() { ... }
}@Embeddable
public class RegionalArticlePk implements Serializable { ... }

或者

@Entity
public class RegionalArticle implements Serializable {@EmbeddedIdpublic RegionalArticlePk getPk() { ... }
}public class RegionalArticlePk implements Serializable { ... }

@Embeddable 注解默认继承了其所属实体的访问类型, 除非显式使用了Hibernate的@AccessType注解(这个注解不是EJB3标准的一部分). 而@JoinColumns,即@JoinColumn数组, 定义了关联的组合外键(如果不使用缺省值的话). 显式指明referencedColumnNames是一个好的实践方式, 否则,Hibernate认为你使用的列顺序和主键声明的顺序一致.

@Entity
public class Parent implements Serializable {@Idpublic ParentPk id;public int age;@OneToMany(cascade=CascadeType.ALL)@JoinColumns ({@JoinColumn(name="parentCivility", referencedColumnName = "isMale"),@JoinColumn(name="parentLastName", referencedColumnName = "lastName"),@JoinColumn(name="parentFirstName", referencedColumnName = "firstName")})public Set<Child> children; //unidirectional...
}
@Entity
public class Child implements Serializable {@Id @GeneratedValuepublic Integer id;@ManyToOne@JoinColumns ({@JoinColumn(name="parentCivility", referencedColumnName = "isMale"),@JoinColumn(name="parentLastName", referencedColumnName = "lastName"),@JoinColumn(name="parentFirstName", referencedColumnName = "firstName")})public Parent parent; //unidirectional
}
@Embeddable
public class ParentPk implements Serializable {String firstName;String lastName;...
}

注意上面的 referencedColumnName显式使用方式.

你还可以映射本地化查询(也就是普通SQL查询). 不过这需要你使用@SqlResultSetMapping注解来描述SQL的resultset的结构 (如果你打算定义多个结果集映射,可是使用@SqlResultSetMappings).@SqlResultSetMapping@NamedQuery,@SqlResultSetMapping一样,可以定义在类和包一级. 但是@SqlResultSetMapping的作用域为应用级. 下面我们会看到,@NamedNativeQuery 注解中resultSetMapping参数值为@SqlResultSetMapping的名字. 结果集映射定义了通过本地化查询返回值和实体的映射. 该实体中的每一个字段都绑定到SQL结果集中的某个列上. 该实体的所有字段包括子类的所有字段以及 关联实体的外键列都必须在SQL查询中有对应的定义. 如果实体中的属性和SQL查询中的列名相同,这种情况下可以不进行定义字段映射.

@NamedNativeQuery(name="night&area", query="select night.id nid, night.night_duration, "+ " night.night_date, area.id aid, night.area_id, area.name "+ "from Night night, Area area where night.area_id = area.id", resultSetMapping="joinMapping")
@SqlResultSetMapping(name="joinMapping", entities={@EntityResult(entityClass=org.hibernate.test.annotations.query.Night.class, fields = {@FieldResult(name="id", column="nid"),@FieldResult(name="duration", column="night_duration"),@FieldResult(name="date", column="night_date"),@FieldResult(name="area", column="area_id"),discriminatorColumn="disc"}),@EntityResult(entityClass=org.hibernate.test.annotations.query.Area.class, fields = {@FieldResult(name="id", column="aid"),@FieldResult(name="name", column="name")})}
)

在上面这个例子中,名为night&area的查询 和joinMapping结果集映射对应. 该映射返回两个实体,分别为NightArea,其中每个属性都和一个列关联, 列名通过查询获取.下面我们看一个隐式声明属性和列映射关系的例子.

@Entity
@SqlResultSetMapping(name="implicit", entities=@EntityResult(entityClass=org.hibernate.test.annotations.query.SpaceShip.class))
@NamedNativeQuery(name="implicitSample", query="select * from SpaceShip", resultSetMapping="implicit")
public class SpaceShip {private String name;private String model;private double speed;@Idpublic String getName() {return name;}public void setName(String name) {this.name = name;}@Column(name="model_txt")public String getModel() {return model;}public void setModel(String model) {this.model = model;}public double getSpeed() {return speed;}public void setSpeed(double speed) {this.speed = speed;}
}

在这个例子中,我们只需要定义结果集映射中的实体成员. 属性和列名之间的映射借助实体中包含映射信息来完成. 在这个例子中,model属性绑定到model_txt列. 如果和相关实体的关联设计到组合主键, 那么应该使用@FieldResult注解来定义每个外键列.@FieldResult的名字由以下几部分组成: 定义这种关系的属性名字+"."+主键名或主键列或主键属性.

@Entity
@SqlResultSetMapping(name="compositekey",entities=@EntityResult(entityClass=org.hibernate.test.annotations.query.SpaceShip.class,fields = {@FieldResult(name="name", column = "name"),@FieldResult(name="model", column = "model"),@FieldResult(name="speed", column = "speed"),
                    @FieldResult(name="captain.firstname", column = "firstn"),@FieldResult(name="captain.lastname", column = "lastn"),@FieldResult(name="dimensions.length", column = "length"),@FieldResult(name="dimensions.width", column = "width")}),columns = { @ColumnResult(name = "surface"),@ColumnResult(name = "volume") } )@NamedNativeQuery(name="compositekey",query="select name, model, speed, lname as lastn, fname as firstn, length, width, length * width as surface from SpaceShip", resultSetMapping="compositekey")
} )
public class SpaceShip {private String name;private String model;private double speed;private Captain captain;private Dimensions dimensions;@Idpublic String getName() {return name;}public void setName(String name) {this.name = name;}@ManyToOne(fetch= FetchType.LAZY)@JoinColumns( {@JoinColumn(name="fname", referencedColumnName = "firstname"),@JoinColumn(name="lname", referencedColumnName = "lastname")} )public Captain getCaptain() {return captain;}public void setCaptain(Captain captain) {this.captain = captain;}public String getModel() {return model;}public void setModel(String model) {this.model = model;}public double getSpeed() {return speed;}public void setSpeed(double speed) {this.speed = speed;}public Dimensions getDimensions() {return dimensions;}public void setDimensions(Dimensions dimensions) {this.dimensions = dimensions;}
}@Entity
@IdClass(Identity.class)
public class Captain implements Serializable {private String firstname;private String lastname;@Idpublic String getFirstname() {return firstname;}public void setFirstname(String firstname) {this.firstname = firstname;}@Idpublic String getLastname() {return lastname;}public void setLastname(String lastname) {this.lastname = lastname;}
}

注意

观察dimension属性你会发现Hibernate支持用"."符号来表示嵌入式对象. EJB3实现不必支持这个特征,但是我们做到了:-)

如果查询返回的是单个实体,或者你打算使用系统默认的映射, 这种情况下可以不使用resultSetMapping 而是使用resultClass属性:

@NamedNativeQuery(name="implicitSample", query="select * from SpaceShip", resultClass=SpaceShip.class)
public class SpaceShip {

某些本地查询返回的是scalar值,例如报表查询. 你可以通过@ColumnResult将其映射到 @SqlResultsetMapping上. 甚至还可以在同一个本地查询的结果中混合实体和scalar类型(不过这种情况比较少见).

@SqlResultSetMapping(name="scalar", columns=@ColumnResult(name="dimension"))
@NamedNativeQuery(name="scalar", query="select length*width as dimension from SpaceShip", resultSetMapping="scalar")

本地查询中还有另外一个hint属性: org.hibernate.callable. 这个属性的布尔变量值表明这个查询是否是一个存储过程.

Hibernate 3.1 提供了多种附加的注解,这些注解可以与EJB3的实体混合/匹配使用. 他们被设计成EJB3注解的自然扩展.

为了强化EJB3的能力,Hibernate提供了与其自身特性相吻合的特殊注解. org.hibernate.annotations包已包含了所有的这些注解扩展.

你可以在EJB3规范所能提供的能力之外,就Hibernate对实体所做的一些操作进行优化.

@org.hibernate.annotations.Entity 追加了可能需要的额外的元数据, 而这些元数据超出了标准@Entity 中所定义的元数据.

  • mutable: 此实体是否为可变的
  • dynamicInsert: 用动态SQL新增
  • dynamicUpdate: 用动态SQL更新
  • selectBeforeUpdate: 指明Hibernate从不运行SQL UPDATE除非能确定对象的确已被修改
  • polymorphism: (指出)实体多态是PolymorphismType.IMPLICIT(默认)还是PolymorphismType.EXPLICIT
  • persister:允许对默认持久实现(persister implementation)的覆盖
  • optimisticLock: 乐观锁策略(OptimisticLockType.VERSION, OptimisticLockType.NONE, OptimisticLockType.DIRTY或OptimisticLockType.ALL)

注意

@javax.persistence.Entity仍是必选的(mandatory), @org.hibernate.annotations.Entity不是取代品.

以下是一些附加的Hibernate注解扩展:

@org.hibernate.annotations.BatchSize 允许你定义批量获取该实体的实例数量(如:@BatchSize(size=4)). 当加载一特定的实体时,Hibernate将加载在持久上下文中未经初始化的同类型实体,直至批量数量(上限).

@org.hibernate.annotations.Proxy 定义了实体的延迟属性.Lazy(默认为true)定义了类是否为延迟(加载). proxyClassName是用来生成代理的接口(默认为该类本身).

@org.hibernate.annotations.Where 定义了当获取类实例时所用的SQL WHERE子句(该SQL WHERE子句为可选).

@org.hibernate.annotations.Check 定义了在DDL语句中定义的合法性检查约束(该约束为可选).

@OnDelete(action=OnDeleteAction.CASCADE) 定义于被连接的子类(joined subclass):在删除时使用SQL级连删除,而非通常的Hibernate删除机制.

@Table(name="tableName", indexes = { @Index(name="index1", columnNames={"column1", "column2"} ) } )tableName表的列上创建定义好的索引. 该注解可以被应用于关键表或者是其他次要的表.@Tables 注解允许你在不同的表上应用索引. 此注解预期在使用@javax.persistence.Table@javax.persistence.SecondaryTable的地方中出现.

注意

@org.hibernate.annotations.Table 是对 @javax.persistence.Table的补充而不是它的替代品. 特别是当你打算改变表名的默认值的时候,你必须使用@javax.persistence.Table, 而不是@org.hibernate.annotations.Table.

@Entity
@BatchSize(size=5)
@org.hibernate.annotations.Entity(selectBeforeUpdate = true,dynamicInsert = true, dynamicUpdate = true,optimisticLock = OptimisticLockType.ALL,polymorphism = PolymorphismType.EXPLICIT)
@Where(clause="1=1")
@org.hibernate.annotations.Table(name="Forest", indexes = { @Index(name="idx", columnNames = { "name", "length" } ) } )
public class Forest { ... }
@Entity
@Inheritance(strategy=InheritanceType.JOINED
)
public class Vegetable { ... }@Entity
@OnDelete(action=OnDeleteAction.CASCADE)
public class Carrot extends Vegetable { ... }

@org.hibernate.annotations.GenericGenerator 允许你定义一个Hibernate特定的id生成器.

@Id @GeneratedValue(generator="system-uuid")
@GenericGenerator(name="system-uuid", strategy = "uuid")
public String getId() {@Id @GeneratedValue(generator="hibseq")
@GenericGenerator(name="hibseq", strategy = "seqhilo",parameters = {@Parameter(name="max_lo", value = "5"),@Parameter(name="sequence", value="heybabyhey")}
)
public Integer getId() {

strategy可以是Hibernate3生成器策略的简称, 或者是一个IdentifierGenerator实现的(带包路径的)全限定类名. 你可以通过parameters属性增加一些参数.

访问类型是根据@Id@EmbeddedId 在实体继承层次中所处的位置推演而得的.子实体(Sub-entities), 内嵌对象和被映射的父类均继承了根实体(root entity)的访问类型.

在Hibernate中,你可以把访问类型覆盖成:

  • 使用定制的访问类型策略

  • 优化类级或属性级的访问类型

为支持这种行为,Hibernate引入了@AccessType注解.你可以对以下元素定义访问类型:

  • 实体

  • 父类

  • 可内嵌的对象

  • 属性

被注解元素的访问类型会被覆盖,若覆盖是在类一级上,则所有的属性继承访问类型. 对于根实体,其访问类型会被认为是整个继承层次中的缺省设置(可在类或属性一级覆盖).

若访问类型被标以"property",则Hibernate会扫描getter方法的注解,若访问类型被标以"field", 则扫描字段的注解.否则,扫描标为@Id或@embeddedId的元素.

你可以覆盖某个属性(property)的访问类型,但是受注解的元素将不受影响: 例如一个具有field访问类型的实体,(我们)可以将某个字段标注为 @AccessType("property"), 则该字段的访问类型随之将成为property,但是其他字段上依然需要携带注解.

若父类或可内嵌的对象没有被注解,则使用根实体的访问类型(即使已经在非直系父类或可内嵌对象上定义了访问类型). 此时俄罗斯套娃(Russian doll)原理就不再适用.(译注:俄罗斯套娃(матрёшка或 матрешка)是俄罗斯特产木制玩具, 一般由多个一样图案的空心木娃娃一个套一个组成,最多可达十多个,通常为圆柱形,底部平坦可以直立.)

@Entity
public class Person implements Serializable {@Id  @GeneratedValue //access type fieldInteger id;@Embedded@AttributeOverrides({@AttributeOverride(name = "iso2", column = @Column(name = "bornIso2")),@AttributeOverride(name = "name", column = @Column(name = "bornCountryName"))})Country bornIn;
}@Embeddable
@AccessType("property") //override access type for all properties in Country
public class Country implements Serializable {private String iso2;private String name;public String getIso2() {return iso2;}public void setIso2(String iso2) {this.iso2 = iso2;}@Column(name = "countryName")public String getName() {return name;}public void setName(String name) {this.name = name;}
}

某些属性可以在对数据库做插入或更新操作的时候生成. Hibernate能够处理这样的属性,并触发一个后续的查询来读取这些属性.

@Entity
public class Antenna {@Id public Integer id;@Generated(GenerationTime.ALWAYS) @Column(insertable = false, updatable = false)public String longitude;@Generated(GenerationTime.INSERT) @Column(insertable = false)public String latitude;
}

你可以将属性注解为@Generated. 但是你要注意insertability和updatability不要和你选择的生成策略冲突. 如果选择了GenerationTime.INSERT,该属性不能包含insertable列, 如果选择了GenerationTime.ALWAYS,该属性不能包含insertable和updatable列.

@Version属性不可以为 @Generated(INSERT)(设计时), 只能是NEVERALWAYS.

默认情况下,当预期的被关联元素不在数据库中(关乎关联列的错误id),致使Hiberante无法解决关联性问题时,Hibernate就会抛出异常. 这对遗留schema和历经拙劣维护的schema而言,这或有许多不便. 此时,你可用@NotFound注解让Hibernate略过这样的元素而不是抛出异常. 该注解可用于 @OneToOne (有外键)、@ManyToOne@OneToMany@ManyToMany 关联.

@Entity
public class Child {...@ManyToOne@NotFound(action=NotFoundAction.IGNORE)public Parent getParent() { ... }...
}

有时候删除某实体的时候需要触发数据库的级联删除.

@Entity
public class Child {...@ManyToOne@OnDelete(action=OnDeleteAction.CASCADE)public Parent getParent() { ... }...
}

上面这个例子中,Hibernate将生成一个数据库级的级联删除约束.

EJB3为延迟加载和获取模式提供了fetch选项,而Hibernate 这方面提供了更丰富的选项集.为了更好的调整延迟加载和获取策略,Hibernate引入了 一些附加的注解:

  • @LazyToOne: 定义了 @ManyToOne@OneToOne 关联的延迟选项.LazyToOneOption 可以是PROXY (例如:基于代理的延迟加载),NO_PROXY (例如:基于字节码增强的延迟加载 - 注意需要在构建期处理字节码) 和FALSE (非延迟加载的关联)

  • @LazyCollection: 定义了 @ManyToMany@OneToMany 关联的延迟选项. LazyCollectionOption 可以是TRUE (集合具有延迟性,只有在访问的时候才加载),EXTRA (集合具有延迟性,并且所有的操作都会尽量避免加载集合, 对于一个巨大的集合特别有用,因为这样的集合中的元素没有必要全部加载)和 FALSE (非延迟加载的关联)

  • @Fetch: 定义了加载关联关系的获取策略. FetchMode 可以是SELECT (在需要加载关联的时候触发select操作),SUBSELECT (只对集合有效,使用了子查询策略,详情参考Hibernate参考文档) orJOIN (在加载主实体(owner entity)的时候使用SQL JOIN来加载关联关系).JOIN 将覆写任何延迟属性 (通过JOIN策略加载的关联将不再具有延迟性).

The Hibernate annotations overrides the EJB3 fetching options.

Hibernate注解覆写了EJB3提供的获取(fetch)选项.

表 2.3. 延迟和获取选项的等效注解

Annotations Lazy Fetch
@[One|Many]ToOne](fetch=FetchType.LAZY) @LazyToOne(PROXY) @Fetch(SELECT)
@[One|Many]ToOne](fetch=FetchType.EAGER) @LazyToOne(FALSE) @Fetch(JOIN)
@ManyTo[One|Many](fetch=FetchType.LAZY) @LazyCollection(TRUE) @Fetch(SELECT)
@ManyTo[One|Many](fetch=FetchType.EAGER) @LazyCollection(FALSE) @Fetch(JOIN)

以下是可能的设置方式

  • 用@BatchSizebatch设置集合的batch大小
  • 用@Where注解设置Where子句
  • 用注解@Check来设置check子句
  • 用注解@OrderBy来设置SQL的order by子句
  • 利用@OnDelete(action=OnDeleteAction.CASCADE) 注解设置级连删除策略

你也可以利用@Sort注解定义一个排序比较器(sort comparator), 表明希望的比较器类型,无序、自然顺序或自定义排序,三者择一.若你想用你自己实现的comparator, 你还需要利用comparator属性(attribute)指明实现类.

    @OneToMany(cascade=CascadeType.ALL, fetch=FetchType.EAGER)@JoinColumn(name="CUST_ID")@Sort(type = SortType.COMPARATOR, comparator = TicketComparator.class)@Where(clause="1=1")@OnDelete(action=OnDeleteAction.CASCADE)public SortedSet<Ticket> getTickets() {return tickets;}

关于这些注解更详细的信息,请参阅此前的描述.

比EJB3更胜一筹的是,Hibernate Annotations支持真正的 ListArray. 映射集合的方式和以前完全一样,只不过要新增@IndexColumn注解. 该注解允许你指明存放索引值的字段.你还可以定义代表数据库中首个元素的索引值(亦称为索引基数). 常见取值为01.

@OneToMany(cascade = CascadeType.ALL)
@IndexColumn(name = "drawer_position", base=1)
public List<Drawer> getDrawers() {return drawers;
}

注意

假如你忘了设置@IndexColumn, Hibernate会采用包(bag)语义(译注:即允许重复元素的无序集合).

Hibernate注解支持true Map映射, 如果没有设置@javax.persistence.MapKey, hibernate将key元素或嵌入式对象直接映射到他们所属的列. 要覆写默认的列,可以使用以下注解:@org.hibernate.annotations.MapKey适用的key为基本类型或者嵌入式对象,@org.hibernate.annotations.MapKey适用的key为实体.

Hibernate Annotations还支持核心类型集合(Integer, String, Enums, ......)、 可内嵌对象的集合,甚至基本类型数组.这就是所谓的元素集合.

元素集合可用@CollectionOfElements来注解(作为@OneToMany的替代). 为了定义集合表(译注:即存放集合元素的表,与下面提到的主表对应),要在关联属性上使用@JoinTable注解, joinColumns定义了介乎实体主表与集合表之间的连接字段(inverseJoincolumn是无效的且其值应为空). 对于核心类型的集合或基本类型数组,你可以在关联属性上用@Column来覆盖存放元素值的字段的定义. 你还可以用@AttributeOverride来覆盖存放可内嵌对象的字段的定义. 要访问集合元素,需要将该注解的name属性值设置为"element"("element"用于核心类型,而"element.serial" 用于嵌入式对象的serial属性).要访问集合的index/key,则将该注解的name属性值设置为"key".

@Entity
public class Boy {private Integer id;private Set<String> nickNames = new HashSet<String>();private int[] favoriteNumbers;private Set<Toy> favoriteToys = new HashSet<Toy>();private Set<Character> characters = new HashSet<Character>();@Id @GeneratedValuepublic Integer getId() {return id;}@CollectionOfElementspublic Set<String> getNickNames() {return nickNames;}@CollectionOfElements@JoinTable(table=@Table(name="BoyFavoriteNumbers"),joinColumns = @JoinColumn(name="BoyId"))@Column(name="favoriteNumber", nullable=false)@IndexColumn(name="nbr_index")public int[] getFavoriteNumbers() {return favoriteNumbers;}@CollectionOfElements@AttributeOverride( name="element.serial", column=@Column(name="serial_nbr") )public Set<Toy> getFavoriteToys() {return favoriteToys;}@CollectionOfElementspublic Set<Character> getCharacters() {return characters;}...
}public enum Character {GENTLE,NORMAL,AGGRESSIVE,ATTENTIVE,VIOLENT,CRAFTY
}@Embeddable
public class Toy {public String name;public String serial;public Boy owner;public String getName() {return name;}public void setName(String name) {this.name = name;}public String getSerial() {return serial;}public void setSerial(String serial) {this.serial = serial;}@Parentpublic Boy getOwner() {return owner;}public void setOwner(Boy owner) {this.owner = owner;}public boolean equals(Object o) {if ( this == o ) return true;if ( o == null || getClass() != o.getClass() ) return false;final Toy toy = (Toy) o;if ( !name.equals( toy.name ) ) return false;if ( !serial.equals( toy.serial ) ) return false;return true;}public int hashCode() {int result;result = name.hashCode();result = 29 * result + serial.hashCode();return result;}
}

在嵌入式对象的集合中,可以使用 @Parent注解嵌入式对象的某属性. 该属性指向该嵌入式对象所属的集合实体.

注意

旧版的Hibernate Annotations用@OneToMany来标识集合元素. 由于语义矛盾,我们引入了@CollectionOfElements注解. 用@OneToMany来标识集合元素的这种旧有方式目前尚有效, 但是不推荐使用,而且在以后的发布版本中不再支持这种方式.

为了优化数据库访问,你可以激活所谓的Hibernate二级缓存.该缓存是可以按每个实体和集合进行配置的.

@org.hibernate.annotations.Cache定义了缓存策略及给定的二级缓存的范围. 此注解适用于根实体(非子实体),还有集合.

@Entity
@Cache(usage = CacheConcurrencyStrategy.NONSTRICT_READ_WRITE)
public class Forest { ... }
@OneToMany(cascade=CascadeType.ALL, fetch=FetchType.EAGER)@JoinColumn(name="CUST_ID")@Cache(usage = CacheConcurrencyStrategy.NONSTRICT_READ_WRITE)public SortedSet<Ticket> getTickets() {return tickets;}
@Cache(CacheConcurrencyStrategy usage();                 (1)String region() default "";                       (2)String include() default "all";                   (3)
)
(1)

usage: 给定缓存的并发策略(NONE, READ_ONLY, NONSTRICT_READ_WRITE, READ_WRITE, TRANSACTIONAL)

(2)

region (可选的):缓存范围(默认为类的全限定类名或是集合的全限定角色名)

(3)

include (可选的):值为all时包括了所有的属性(proterty), 为non-lazy时仅含非延迟属性(默认值为all)

由于Hibernate引入了 @org.hibernate.annotations.NamedQuery,@org.hibernate.annotations.NamedQueries,@org.hibernate.annotations.NamedNativeQuery@org.hibernate.annotations.NamedNativeQueries 命名式查询, 因此Hibernate在命名式查询上比EBJ3规范中所定义的命名式查询提供了更多的特性. 他们在标准版中添加了可作为替代品的一些属性(attributes):

  • flushMode: 定义查询的刷新模式(Always, Auto, Commit或Manual)

  • cacheable: 查询该不该被缓存

  • cacheRegion: 若查询已被缓存时所用缓存的范围

  • fetchSize: 针对该查询的JDBC statement单次获取记录的数目

  • timeout: 查询超时

  • callable: 仅用于本地化查询(native query),对于存储过程设为true

  • comment: 一旦激活注释功能,我们会在向数据库交送查询请求时看到注释

  • cacheMode: 缓存交护模式(get, ignore,normal,或refresh)

  • readOnly: 不管是否从查询获取元素都是在只读模式下

注意,EJB3已公开的最终草案中引入了@QueryHint的概念, 这可能是定义hints更好的方法.


上一页 上一级 下一页
第 1 章 创建一个注解项目 起始页 第 3 章 通过XML覆写元数据

Hibernate注解完整文档相关推荐

  1. Spring 2.5 jar 所有开发包及完整文档及项目开发实例

    Spring 2.5 jar 所有开发包及完整文档及项目开发实例 spring jar 包详解spring.jar是包含有完整发布的单个jar包,spring.jar中包含除了 spring-mock ...

  2. openlayers5之完整文档v5.1.3.zip下载

    版权声明:本文为博主原创文章,未经博主允许不得转载. https://blog.csdn.net/gisdoer/article/details/81697967 openlayers完整文档v5.1 ...

  3. 大型三甲医院云HIS系统源码 强大的电子病历+完整文档

    医院HIS系统源码云HIS系统:SaaS运维平台+多医院入驻+强大的电子病历+完整文档 有源码,有演示 一.系统概述 Ø 采用主流成熟技术,软件结构简洁.代码规范易阅读,SaaS应用,全浏览器访问前后 ...

  4. 【源码分享】ASP.NET大型快运(快递)管理系统带完整文档

    ASP.NET大型快运(快递)管理系统源码带完整文档 大型快递(快运)管理系统基于webservice的分布式系统,集成快递物流业务流程管理,快递物流公司内部管理,快递物流单全网跟踪监控,并集成基于w ...

  5. (运动会模拟射靶)Python期末大作业(附完整文档)

    python期末大作业,因为是数据分析与可视化,所以我在网上搜索的时候,找到了一篇关于大作业射靶的题目,原文写的很好,也提供了下载,本篇在其基础上增加了数据可视化-图表,并且增加了,方差,个人平均分在 ...

  6. ASP.NET大型快运(快递)ERP系统带完整文档【源码分享】

    ASP.NET大型快运(快递)管理系统源码带完整文档 源码分享,需要源码学习参考可私信我. 大型快递(快运)管理系统基于webservice的分布式系统,集成快递物流业务流程管理,快递物流公司内部管理 ...

  7. 敏感词“智能”检测(代码和完整文档在最后)

    完整文档下载 案例代码下载

  8. Hibernate中文参考文档(JFIS)

    HIBERNATE - 符合Java习惯的关系数据库持久化      下一页 HIBERNATE - 符合Java习惯的关系数据库持久化 Hibernate参考文档 3.0.4 目录 前言 1. 翻译 ...

  9. 完整版H5社交聊天平台源码[完整数据库+完整文档教程]

    介绍: 开发语言:PHP 数据库:MySQL 完整版H5社交聊天平台源码:一款优化了的版本,带有完善的文档教程和完整数据库文件. 东西非常的齐全,这款是客户定制的,所以东西很完整,也值不少钱,源码开发 ...

最新文章

  1. python列表做参数传值_python不定参数传值怎么做-问答-阿里云开发者社区-阿里云...
  2. 51nod 1513-3的幂的和(费马小定理+快速幂)
  3. Android之ListView原理学习与优化总结
  4. 为什么python打不开_python文件打不开如何解决
  5. 用 Python 写出这样的进度条,刷新了我对进度条的认知
  6. VMware pro 14
  7. 微信公众号从测试号迁移到正式号
  8. mysql链接is not allow_解决Mysql远程连接出错不允许访问 ERROR 1130:Host is not allow...
  9. shell 脚本中双引号、单引号、反引号的区别
  10. 关闭git命令窗快捷键_zsh中git的快捷命令
  11. 字节跳动内推 校招 社招 实习生都可以投递
  12. 南京沁恒推出的国产 M3 架构芯片与意法半导体 M3 芯片对比
  13. 【转载】一个程序猿必须会玩的游戏
  14. 渐变折射率(GRIN)多模光纤的建模
  15. erdas叠加显示_ERDAS影像融合
  16. xcode8 cocoapods 执行 pod spec lint 报错
  17. Centos 6安装Maven
  18. selenium+unittest自动化测试发送邮件
  19. 我的京东管理生涯随想 1
  20. 数美科技斩获36氪“WISE 2020数据智能最佳解决方案”

热门文章

  1. WINDOWS 服务器终极安全方案
  2. 7-41 成绩统计分析表(*) (10 分)
  3. lumia 525 android 7.1,真神机!Lumia 520 吃上 Android 7.1
  4. Linux网络:HTTP协议 | URL | 协议格式 | HTTP方法 | HTTP状态码 | Cookie与Session
  5. U3D各向异性Shader
  6. Suflo-Cyanine5.5 Tyramide,Suflo-Cyanine3 TSA,磺酸基-花青素Cy5 酪酰胺
  7. 用好大数据须有大智慧
  8. QQ这个永久下线的功能,又起死回生了
  9. 在抽签仪式上,如何通过软件系统的随机抽签功能来决定选手的比赛出场顺序?
  10. 高端骨传导耳机来袭,最强旗舰机南卡Runner Pro4测评!