Hibernate註解詳細介紹

時間 2019-11-19

標籤 hibernate 註解詳細介紹欄目 Hibernate 简体版

原文原文鏈接

引自http://blog.csdn.net/lin_yongrui/article/details/6855394

聲明實體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_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-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 element in Hibernate 每一個類一張表

• Single Table per Class Hierarchy Strategy: the element in Hibernate 每一個類層次結構一張表

• Joined Subclass Strategy: the 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 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 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 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 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文件中的註解。

select p from Plane p

...

@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 屬性值。

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。