`
zy77612
  • 浏览: 283400 次
  • 性别: Icon_minigender_1
  • 来自: 深圳
社区版块
存档分类
最新评论

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中某个属性定义为主键,使用@Generatue注解可以定义该标识符的生成策略。

? 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;

}

...

}

分享到:
评论

相关推荐

    hibernate注释详解

    hibernate注释详解 内含hibernate各种注释说明

    Hibernate注释深入解析

    【Hibernate注释深入解析】 在Java开发中,Hibernate是一个广泛使用的对象关系映射(ORM)框架,它允许开发者使用面向对象的方式操作数据库。在Hibernate中,注释是一种强大的工具,可以简化配置,使得代码更加简洁...

    Hibernate 注解大全

    通过阅读《Hibernate注释.doc》和《Hibernate注释大全.txt》这两个文档,你可以获得更详细的信息,深入理解Hibernate注解的使用场景和配置细节。同时,参考提供的博文链接...

    Hibernate注释方法描述数据库映射

    ### Hibernate注释方法描述数据库映射 #### 一、概述 Hibernate 是一款强大的对象关系映射(ORM)框架,它简化了 Java 开发者与数据库交互的过程。在 Hibernate 中,可以利用注解来描述实体类与数据库表之间的映射...

    hibernate注释源程序

    **hibernate注释源程序详解** 在Java领域,Hibernate是一个非常重要的对象关系映射(ORM)框架,它简化了数据库操作,使开发者能够用Java对象来操作数据库。本篇文章将深入探讨Hibernate中的注释(Annotation)使用...

    Hibernate 注释语法.chm

    Hibernate 注释语法的简单讲解,个人的学习总结笔记

    Hibernate注解、注释大全

    《Hibernate注解详解》 Hibernate 是一款强大的Java对象关系映射(ORM)框架,它极大地简化了数据库操作。在Hibernate中,注解是用于描述Java类及其属性如何映射到数据库表的重要工具。本文将全面解析Hibernate中的...

    Hibernate-tools解决hbm.xml中文注释乱码和生成实体类注释

    总结,`Hibernate-tools`是Hibernate生态中不可或缺的一部分,它极大地提高了开发效率,同时也为处理中文注释提供了有效方案。通过合理配置和使用,我们可以避免乱码问题,并生成符合规范的带有丰富注释的实体类代码...

    Hibernate注释

    以上就是关于Hibernate注释的基本知识,它们在Java对象和数据库表之间的映射中起着至关重要的作用,简化了开发过程,并提供了更灵活的持久化管理。通过合理使用这些注解,开发者能够有效地控制对象的生命周期,处理...

    hibernate@注解方式配置实体类,调用javadoc接口生成数据库表及字段的注释说明

    hibernate@注解方式配置实体类时,利用javadoc接口生成数据库表及字段的注释说明,支持oracle、sqlserver、db2、mysql数据库。因用到java\lib\tools.jar,需要将该jar放入工程lib下(或者tomcat\lib下、或加入...

    Hibernate使用注释

    使用hibernate注释的核心优点是我们不需要创建映射(*.hbm.xml)文件直接创建对象关联。 在这里,hibernate注释用于提供元数据。步骤如下: 1.为MySQL添加连接驱动程序的jar文件(如果数据库是MySQL)和注释2.创建持久化...

    hibernate注解所需包

    使用hibernate注解,必须要使用库hibernate-commons-annotations,hibernate-core,hibernate-jpa,ejb3-persistence,javassist等

    Hibernate5.2.4环境搭建源码

    **Hibernate 5.2.4 环境搭建与源码解析** Hibernate 是一个流行的 Java 对象关系映射(ORM)框架,它极大地简化了数据库操作。在本教程中,我们将详细探讨如何搭建 Hibernate 5.2.4 的开发环境,并理解其源码。 ...

    hibernate配置参数大全

    13. **`hibernate.use_sql_comments`**:决定Hibernate是否在生成的SQL语句中包含注释。 - 示例: ```properties hibernate.use_sql_comments=true ``` 以上是关于Hibernate配置参数的一些核心内容。通过合理地...

    annotation(注释)版本的hibernate

    《注释驱动的Hibernate实战详解》 在Java的持久化框架中,Hibernate以其强大的功能和易用性,深受开发者喜爱。然而,随着Java技术的发展,传统的XML配置方式逐渐被注解(Annotation)所取代,使得代码更加简洁、...

    hibernate中的注释学习,以及注释帮助

    一、Hibernate注释基础 1. `@Entity`: 这个注释标记一个Java类为持久化实体,意味着这个类的实例将在数据库中有一个对应的表。例如: ```java @Entity public class User { // ... } ``` 这会告诉Hibernate,User...

    hibernate中的注释的几种配置方式

    在探讨Hibernate中注释的几种配置方式时,我们主要聚焦于如何通过注解来定义实体类与数据库表之间的映射关系,以及如何在Spring框架下整合Hibernate,利用注解进行SessionFactory的配置。以下是对给定内容中涉及的...

    使用Hibernate tools,生成带中文注释的类和hbm文件

    下载并安装hibernate tools插件,下载地址:...安装完Hibernate tools插件后,在eclipse安装目录下搜索并替换hibernate-tools-5.2.0.Beta1.jar文件,即可生成带中文注释的类和hbm文件

Global site tag (gtag.js) - Google Analytics