Hibernate注释大全收藏
- 声明实体Bean
- @Entity
- public class Flight implements Serializable {
- Long id;
- @Id
- public Long getId() { return id; }
- public void setId(Long id) { this.id = id; }
- }
- @Entity 注解将一个类声明为实体 Bean, @Id 注解声明了该实体Bean的标识属性。
- Hibernate 可以对类的属性或者方法进行注解。属性对应field类别,方法的 getXxx()对应property类别。
- 定义表
- 通过 @Table 为实体Bean指定对应数据库表,目录和schema的名字。
- @Entity
- @Table(name="tbl_sky")
- public class Sky implements Serializable {
- ...
- @Table 注解包含一个schema和一个catelog 属性,使用@UniqueConstraints 可以定义表的唯一约束。
- @Table(name="tbl_sky",
- uniqueConstraints = {@UniqueConstraint(columnNames={"month", "day"})}
- )
- 上述代码在 "month" 和 "day" 两个 field 上加上 unique constrainst.
- @Version 注解用于支持乐观锁版本控制。
- @Entity
- public class Flight implements Serializable {
- ...
- @Version
- @Column(name="OPTLOCK")
- public Integer getVersion() { ... }
- }
- version属性映射到 "OPTLOCK" 列,entity manager 使用这个字段来检测冲突。 一般可以用 数字 或者 timestamp 类型来支持 version.
- 实体Bean中所有非static 非 transient 属性都可以被持久化,除非用@Transient注解。
- 默认情况下,所有属性都用 @Basic 注解。
- public transient int counter; //transient property
- private String firstname; //persistent property
- @Transient
- String getLengthInMeter() { ... } //transient property
- String 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, lengthInMeter 属性将忽略不被持久化,而 firstname, name, length 被定义为可持久化和可获取的。
- @TemporalType.(DATE,TIME,TIMESTAMP) 分别Map java.sql.(Date, Time, Timestamp).
- @Lob 注解属性将被持久化为 Blog 或 Clob 类型。具体的java.sql.Clob, Character[], char[] 和 java.lang.String 将被持久化为 Clob 类型. java.sql.Blob, Byte[], byte[] 和 serializable type 将被持久化为 Blob 类型。
- @Lob
- public String getFullText() {
- return fullText; // clob type
- }
- @Lob
- public byte[] getFullCode() {
- return fullCode; // blog type
- }
- @Column 注解将属性映射到列。
- @Entity
- public class Flight implements Serializable {
- ...
- @Column(updatable = false, name = "flight_name", nullable = false, length=50)
- public String getName() { ... }
- 定义 name 属性映射到 flight_name column, not null, can't update, length equal 50
- @Column(
- name="columnName"; (1) 列名
- boolean unique() default false; (2) 是否在该列上设置唯一约束
- boolean nullable() default true; (3) 列可空?
- boolean insertable() default true; (4) 该列是否作为生成 insert语句的一个列
- boolean updatable() default true; (5) 该列是否作为生成 update语句的一个列
- String columnDefinition() default ""; (6) 默认值
- String table() default ""; (7) 定义对应的表(deault 是主表)
- int length() default 255; (8) 列长度
- int precision() default 0; // decimal precision (9) decimal精度
- int scale() default 0; // decimal scale (10) decimal长度
- 嵌入式对象(又称组件)也就是别的对象定义的属性
- 组件类必须在类一级定义 @Embeddable 注解。在特定的实体关联属性上使用 @Embeddable 和 @AttributeOverride 注解可以覆盖该属性对应的嵌入式对象的列映射。
- @Entity
- public class Person implements Serializable {
- // Persistent component using defaults
- Address 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; }
- ...
- }
- Person 类定义了 Address 和 Country 对象,具体两个类实现见上。
- 无注解属性默认值:
- • 属性为简单类型,则映射为 @Basic
- • 属性对应的类型定义了 @Embeddable 注解,则映射为 @Embedded
- • 属性对应的类型实现了Serializable,则属性被映射为@Basic并在一个列中保存该对象的serialized版本。
- • 属性的类型为 java.sql.Clob or java.sql.Blob, 则映射到 @Lob 对应的类型。
- 映射主键属性
- @Id 注解可将实体Bean中某个属性定义为主键,使用@GenerateValue注解可以定义该标识符的生成策略。
- • AUTO - 可以是 identity column, sequence 或者 table 类型,取决于不同底层的数据库
- • TABLE - 使用table保存id值
- • IDENTITY - identity column
- • SEQUENCE - seque
- nce
- @Id @GeneratedValue(strategy=GenerationType.SEQUENCE, generator="SEQ_STORE")
- public Integer getId() { ... }
- @Id @GeneratedValue(strategy=GenerationType.IDENTITY)
- public Long getId() { ... }
- AUTO 生成器,适用与可移值的应用,多个@Id可以共享同一个 identifier生成器,只要把generator属性设成相同的值就可以。通过@SequenceGenerator 和 @TableGenerator 可以配置不同的 identifier 生成器。
- <table-generator name="EMP_GEN"
- table="GENERATOR_TABLE"
- pk-column-name="key"
- value-column-name="hi"
- pk-column-value="EMP"
- allocation-size="20"/>
- //and the annotation equivalent
- @javax.persistence.TableGenerator(
- name="EMP_GEN",
- table="GENERATOR_TABLE",
- pkColumnName = "key",
- valueColumnName = "hi"
- pkColumnValue="EMP",
- allocationSize=20
- )
- <sequence-generator name="SEQ_GEN"
- sequence-name="my_sequence"
- allocation-size="20"/>
- //and the annotation equivalent
- @javax.persistence.SequenceGenerator(
- name="SEQ_GEN",
- sequenceName="my_sequence",
- allocationSize=20
- )
- The next example shows the definition of a sequence generator in a class scope:
- @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生成器对于其他类是不可见的。
- 通过下面语法,你可以定义组合键。
- • 将组件类注解为 @Embeddable, 并将组件的属性注解为 @Id
- • 将组件的属性注解为 @EmbeddedId
- • 将类注解为 @IdClass,并将该实体中所有主键的属性都注解为 @Id
- @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 Footballer
- public String getFirstname() {
- return firstname;
- }
- public void setFirstname(String firstname) {
- this.firstname = firstname;
- }
- //same name and type as in Footballer
- public String getLastname() {
- return lastname;
- }
- public void setLastname(String lastname) {
- this.lastname = lastname;
- }
- //appropriate equals() and hashCode() implementation
- }
- @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 {
- @ManyToOne
- public Channel channel;
- public String name;
- @ManyToOne
- public Presenter presenter;
- }
- 映射继承关系
- EJB支持3种类型的继承。
- • Table per Class Strategy: the <union-class> element in Hibernate 每个类一张表
- • Single Table per Class Hierarchy Strategy: the <subclass> element in Hibernate 每个类层次结构一张表
- • Joined Subclass Strategy: the <joined-subclass> element in Hibernate 连接的子类策略
- @Inheritance 注解来定义所选的之类策略。
- 每个类一张表
- @Entity
- @Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)
- public class Flight implements Serializable {
- 有缺点,如多态查询或关联。Hibernate 使用 SQL Union 查询来实现这种策略。 这种策略支持双向的一对多关联,但不支持 IDENTIFY 生成器策略,因为ID必须在多个表间共享。一旦使用就不能使用AUTO和IDENTIFY生成器。
- 每个类层次结构一张表
- @Entity
- @Inheritance(strategy=InheritanceType.SINGLE_TABLE)
- @DiscriminatorColumn(
- name="planetype",
- discriminatorType=DiscriminatorType.STRING
- )
- @DiscriminatorValue("Plane")
- public class Plane { ... }
- @Entity
- @DiscriminatorValue("A320")
- public class A320 extends Plane { ... }
- 整个层次结构中的所有父类和子类属性都映射到同一个表中,他们的实例通过一个辨别符列(discriminator)来区分。
- Plane 是父类。@DiscriminatorColumn 注解定义了辨别符列。对于继承层次结构中的每个类, @DiscriminatorValue 注解指定了用来辨别该类的值。 辨别符列名字默认为 DTYPE,其默认值为实体名。其类型为DiscriminatorType.STRING。
- 连接的子类
- @Entity
- @Inheritance(strategy=InheritanceType.JOINED)
- public class Boat implements Serializable { ... }
- @Entity
- public class Ferry extends Boat { ... }
- @Entity
- @PrimaryKeyJoinColumn(name="BOAT_ID")
- public class AmericaCupClass extends Boat { ... }
- 以上所有实体使用 JOINED 策略 Ferry和Boat class使用同名的主键关联(eg: Boat.id = Ferry.id), AmericaCupClass 和 Boat 关联的条件为 Boat.id = AmericaCupClass.BOAT_ID.
- 从父类继承的属性
- @MappedSuperclass
- public class BaseEntity {
- @Basic
- @Temporal(TemporalType.TIMESTAMP)
- public Date getLastUpdate() { ... }
- public String getLastUpdater() { ... }
- ...
- }
- @Entity class Order extends BaseEntity {
- @Id public Integer getId() { ... }
- ...
- }
- 继承父类的一些属性,但不用父类作为映射实体,这时候需要 @MappedSuperclass 注解。 上述实体映射到数据库中的时候对应 Order 实体Bean, 其具有 id, lastUpdate, lastUpdater 三个属性。如果没有@MappedSuperclass 注解,则父类中属性忽略,这是 Order 实体 Bean 只有 id 一个属性。
- 映射实体Bean的关联关系
- 一对一
- 使用 @OneToOne 注解可以建立实体Bean之间的一对一关系。一对一关系有3种情况。
- • 关联的实体都共享同样的主键。
- @Entity
- public class Body {
- @Id
- public Long getId() { return id; }
- @OneToOne(cascade = CascadeType.ALL)
- @PrimaryKeyJoinColumn
- public Heart getHeart() {
- return heart;
- }
- ...
- }
- @Entity
- public class Heart {
- @Id
- public Long getId() { ...}
- }
- 通过@PrimaryKeyJoinColumn 注解定义了一对一的关联关系。
- 多对一
- 使用 @ManyToOne 注解定义多对一关系。
- @Entity()
- public class Flight implements Serializable {
- @ManyToOne( cascade = {CascadeType.PERSIST, CascadeType.MERGE} )
- @JoinColumn(name="COMP_ID")
- public Company getCompany() {
- return company;
- }
- ...
- }
- 其中@JoinColumn 注解是可选的,关键字段默认值和一对一关联的情况相似。列名为:主题的关联属性名 + 下划线 + 被关联端的主键列名。本例中为company_id,因为关联的属性是company, Company的主键为 id.
- @ManyToOne 注解有个targetEntity属性,该参数定义了目标实体名。通常不需要定义,大部分情况为默认值。但下面这种情况则需要 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;
- }
- ...
- }
- 集合类型
- 一对多
- @OneToMany 注解可定义一对多关联。一对多关联可以是双向的。
- 双向
- 规范中多对一端几乎总是双向关联中的主体(owner)端,而一对多的关联注解为 @OneToMany(mappedBy=)
- @Entity
- public class Troop {
- @OneToMany(mappedBy="troop")
- public Set<Soldier> getSoldiers() {
- ...
- }
- @Entity
- public class Soldier {
- @ManyToOne
- @JoinColumn(name="troop_fk")
- public Troop getTroop() {
- ...
- }
- Troop 通过troop属性和Soldier建立了一对多的双向关联。在 mappedBy 端不必也不能定义任何物理映射。
- 单向
- @Entity
- public class Customer implements Serializable {
- @OneToMany(cascade=CascadeType.ALL, fetch=FetchType.EAGER)
- @JoinColumn(name="CUST_ID")
- public Set<Ticket> getTickets() {
- ...
- }
- @Entity
- public class Ticket implements Serializable {
- ... //no bidir
- }
- 一般通过连接表来实现这种关联,可以通过@JoinColumn注解来描述这种单向关联关系。上例 Customer 通过 CUST_ID 列和 Ticket 建立了单向关联关系。
- 通过关联表来处理单向关联
- @Entity
- public class Trainer {
- @OneToMany
- @JoinTable(
- name="TrainedMonkeys",
- joinColumns = @JoinColumn( name="trainer_id"),
- inverseJoinColumns = @JoinColumn( name="monkey_id")
- )
- public Set<Monkey> getTrainedMonkeys() {
- ...
- }
- @Entity
- public class Monkey {
- ... //no bidir
- }
- 通过关联表来处理单向一对多关系是首选,这种关联通过 @JoinTable 注解来进行描述。上例子中 Trainer 通过TrainedMonkeys表和Monkey建立了单向关联关系。其中外键trainer_id关联到Trainer(joinColumns)而外键monkey_id关联到Monkey(inverseJoinColumns).
- 默认处理机制
- 通过连接表来建立单向一对多关联不需要描述任何物理映射,表名由一下3个部分组成,主表(owner table)表名 + 下划线 + 从表(the other side table)表名。指向主表的外键名:主表表名+下划线+主表主键列名 指向从表的外键定义为唯一约束,用来表示一对多的关联关系。
- @Entity
- public class Trainer {
- @OneToMany
- public Set<Tiger> getTrainedTigers() {
- ...
- }
- @Entity
- public class Tiger {
- ... //no bidir
- }
- 上述例子中 Trainer 和 Tiger 通过 Trainer_Tiger 连接表建立单向关联关系。其中外键 trainer_id 关联到 Trainer表,而外键 trainedTigers_id 关联到 Tiger 表。
- 多对多
- 通过 @ManyToMany 注解定义多对多关系,同时通过 @JoinTable 注解描述关联表和关联条件。其中一端定义为 owner, 另一段定义为 inverse(对关联表进行更新操作,这段被忽略)。
- @Entity
- public class Employer implements Serializable {
- @ManyToMany(
- targetEntity=org.hibernate.test.metadata.manytomany.Employee.class,
- cascade={CascadeType.PERSIST, CascadeType.MERGE}
- )
- @JoinTable(
- name="EMPLOYER_EMPLOYEE",
- joinColumns=@JoinColumn(name="EMPER_ID"),
- inverseJoinColumns=@JoinColumn(name="EMPEE_ID")
- )
- public Collection getEmployees() {
- return employees;
- }
- ...
- }
- @Entity
- public class Employee implements Serializable {
- @ManyToMany(
- cascade = {CascadeType.PERSIST, CascadeType.MERGE},
- mappedBy = "employees",
- targetEntity = Employer.class
- )
- public Collection getEmployers() {
- return employers;
- }
- }
- 默认值:
- 关联表名:主表表名 + 下划线 + 从表表名;关联表到主表的外键:主表表名 + 下划线 + 主表中主键列名;关联表到从表的外键名:主表中用于关联的属性名 + 下划线 + 从表的主键列名。
- 用 cascading 实现传播持久化(Transitive persistence)
- cascade 属性接受值为 CascadeType 数组,其类型如下:
- • CascadeType.PERSIST: cascades the persist (create) operation to associated entities persist() is called or if the entity is managed 如果一个实体是受管状态,或者当 persist() 函数被调用时,触发级联创建(create)操作。
- • CascadeType.MERGE: cascades the merge operation to associated entities if merge() is called or if the entity is managed 如果一个实体是受管状态,或者当 merge() 函数被调用时,触发级联合并(merge)操作。
- • CascadeType.REMOVE: cascades the remove operation to associated entities if delete() is called 当 delete() 函数被调用时,触发级联删除(remove)操作。
- • CascadeType.REFRESH: cascades the refresh operation to associated entities if refresh() is called 当 refresh() 函数被调用时,出发级联更新(refresh)操作。
- • CascadeType.ALL: all of the above 以上全部
- 映射二级列表
- 使用类一级的 @SecondaryTable 和 @SecondaryTables 注解可以实现单个实体到多个表的映射。使用 @Column 或者 @JoinColumn 注解中的 table 参数可以指定某个列所属的特定表。
- @Entity
- @Table(name="MainCat")
- @SecondaryTables({
- @SecondaryTable(name="Cat1", pkJoinColumns={
- @PrimaryKeyJoinColumn(name="cat_id", referencedColumnName="id")}),
- @SecondaryTable(name="Cat2", uniqueConstraints={
- @UniqueConstraint(columnNames={"storyPart2"})})
- })
- public class Cat implements Serializable {
- private Integer id;
- private String name;
- private String storyPart1;
- private String storyPart2;
- @Id @GeneratedValue
- public Integer getId() {
- return id;
- }
- public String getName() {
- return name;
- }
- @Column(table="Cat1")
- public String getStoryPart1() {
- return storyPart1;
- }
- @Column(table="Cat2")
- public String getStoryPart2() {
- return storyPart2;
- }
- 上述例子中, name 保存在 MainCat 表中,storyPart1保存在 Cat1 表中,storyPart2 保存在 Cat2 表中。 Cat1 表通过外键 cat_id 和 MainCat 表关联, Cat2 表通过 id 列和 MainCat 表关联。对storyPart2 列还定义了唯一约束。
- 映射查询
- 使用注解可以映射 EJBQL/HQL 查询,@NamedQuery 和 @NamedQueries 是可以使用在类级别或者JPA的XML文件中的注解。
- <entity-mappings>
- <named-query name="plane.getAll">
- <query>select p from Plane p</query>
- </named-query>
- ...
- </entity-mappings>
- ...
- @Entity
- @NamedQuery(name="night.moreRecentThan", query="select n from Night n where n.date >= :date")
- public class Night {
- ...
- }
- public class MyDao {
- doStuff() {
- Query q = s.getNamedQuery("night.moreRecentThan");
- q.setDate( "date", aMonthAgo );
- List results = q.list();
- ...
- }
- ...
- }
- 可以通过定义 QueryHint 数组的 hints 属性为查询提供一些 hint 信息。下图是一些 Hibernate hints:
- 映射本地化查询
- 通过@SqlResultSetMapping 注解来描述 SQL 的 resultset 结构。如果定义多个结果集映射,则用 @SqlResultSetMappings。
- @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"结果集映射对应,该映射返回两个实体,分别为 Night 和 Area, 其中每个属性都和一个列关联,列名通过查询获取。
- @Entity
- @SqlResultSetMapping(name="implicit",
- entities=@EntityResult(
- entityClass=org.hibernate.test.annotations.@NamedNativeQuery(
- name="implicitSample", query="select * from SpaceShip",
- resultSetMapping="implicit")
- public class SpaceShip {
- private String name;
- private String model;
- private double speed;
- @Id
- public 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;
- }
- }
- 上例中 model1 属性绑定到 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 resultSetMapping="compositekey")
- })
- 如果查询返回的是单个实体,或者打算用系统默认的映射,这种情况下可以不使用 resultSetMapping,而使用resultClass属性,例如:
- @NamedNativeQuery(name="implicitSample", query="select * from SpaceShip",
- resultClass=SpaceShip.class)
- public class SpaceShip {
- Hibernate 独有的注解扩展
- Hibernate 提供了与其自身特性想吻合的注解,org.hibernate.annotations package包含了这些注解。
- 实体
- org.hibernate.annotations.Entity 定义了 Hibernate 实体需要的信息。
- • mutable: whether this entity is mutable or not 此实体是否可变
- • dynamicInsert: allow dynamic SQL for inserts 用动态SQL新增
- • dynamicUpdate: allow dynamic SQL for updates 用动态SQL更新
- • selectBeforeUpdate: Specifies that Hibernate should never perform an SQL UPDATE unless it is certain that an object is actually modified.指明Hibernate从不运行SQL Update,除非能确定对象已经被修改
- • polymorphism: whether the entity polymorphism is of PolymorphismType.IMPLICIT (default) or PolymorphismType.EXPLICIT 指出实体多态是 PolymorphismType.IMPLICIT(默认)还是PolymorphismType.EXPLICIT
- • optimisticLock: optimistic locking strategy (OptimisticLockType.VERSION, OptimisticLockType.NONE, OptimisticLockType.DIRTY or OptimisticLockType.ALL) 乐观锁策略
- 标识符
- @org.hibernate.annotations.GenericGenerator和@org.hibernate.annotations.GenericGenerators允许你定义hibernate特有的标识符。
- @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() {
- 新例子
- @GenericGenerators(
- {
- @GenericGenerator(
- name="hibseq",
- strategy = "seqhilo",
- parameters = {
- @Parameter(name="max_lo", value = "5"),
- @Parameter(name="sequence", value="heybabyhey")
- }
- ),
- @GenericGenerator(...)
- }
- )
- 自然ID
- 用 @NaturalId 注解标识
- 公式
- 让数据库而不是JVM进行计算。
- @Formula("obj_length * obj_height * obj_width")
- public long getObjectVolume()
- 索引
- 通过在列属性(property)上使用@Index注解,可以指定特定列的索引,columnNames属性(attribute)将随之被忽略。
- @Column(secondaryTable="Cat1")
- @Index(name="story1index")
- public String getStoryPart1() {
- return storyPart1;
- }
- 辨别符
- @Entity
- @DiscriminatorFormula("case when forest_type is null then 0 else forest_type end")
- public class Forest { ... }
- 过滤 查询 ...
- • 其中一个实体通过外键关联到另一个实体的主键。注:一对一,则外键必须为唯一约束。
- @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() {
- ...
- }
- 通过@JoinColumn注解定义一对一的关联关系。如果没有@JoinColumn注解,则系统自动处理,在主表中将创建连接列,列名为:主题的关联属性名 + 下划线 + 被关联端的主键列名。上例为 passport_id, 因为Customer 中关联属性为 passport, Passport 的主键为 id.
- • 通过关联表来保存两个实体之间的关联关系。注:一对一,则关联表每个外键都必须是唯一约束。
- @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 表,该信心定义为 inverseJoinColumns 的属性值。 通过 customer_fk 外键指向 Customer 表,该信息定义为 joinColumns 属性值。
- //文章出处: http://z466459262.iteye.com/blog/714554