Hibernate注解大全收藏
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() {
???...
}
?
