JPA映射持久化对象(Entity)

时间:2023-03-09 07:52:45
JPA映射持久化对象(Entity)

推荐阅读:JPA
criteria 查询:类型安全与面向对象

来源: http://blog.sina.com.cn/s/blog_49fd52cf0100rzjn.html

一个普通的POJO类通过@Entity可以映射成为可持久化的类;

类JavaBean风格:

·类属性必须为private;

·有Getter和Setter方法;



映射实体:@Entity

# @Entity实体必须有一个无参的构造方法;

# 实现Serializable接口,建议每一个Entity都实现该接口;

# 其中,Entity中,name属性表示实体的名称,比如:

@Entity(name=Contacts)

public class ContactsEO{

...

}

在JPA执行jpql的时候,需要使用Contacts作为实体名称,而不是ContactsEO。

String jpql = "select * from Contacts c";

# 如果name没有配置,则实体名默认为类名。



可继承性:

# 实体可继承,非实体类可以继承自实体类,实体类也可以继承自非实体类;

# 抽象类也可以标注为实体类;



标注主键:

# 一个实体类至少要有一个主键(Primary Key);

# 使用@Id标注为实体主键;



默认实体映射:

# 一个类标注了@Entity的可持久化类,如果不标注其他任何注释,该类的属性和方法自动映射为数据库中默认的表和字段。如:

@Entity

public class ContactEO implement Serializable{

    public ContactEO(){}

    private Integer id;

    private String name;

    //getter和setter方法略

}

则该实体默认对应的数据库表名为:contacteo,字段为:int id; varchar name;



映射表和字段:

# @Table注释可定义映射的表;

# @Column注释可定义映射到字段;



映射表@Table:

@Target({TYPE}) @Retention(RUNTIME)

public @interface Table{

    String name() default "";

    String catalog() default "";

    String schema() defalut "";

    UniqueConstraint[] uniqueConstraints() default {};

}

# @Table必须标注在类名前;

# name属性表示实体所对应表的名称;

# catalog和schema属性表示实体指定点目录名称或数据库名称;

# uniqueConstraints属性表示该实体所关联的唯一约束条件,一个实体可以有多个唯一约束条件,默认没有约束;

# 若使用uniqueConstraints标记时,徐奥配合标记UniqueConstraint标记来使用;

示例:

@Entity

@Table(name="contact", schama="jpadb", uniqueConstraints={

    @UniqueConstraint(

        columnNames = {"name", "email"}

    )},

    @UniqueConstraint(

         columnNames = {"other_col_1", "other_col_2"}

    )}

)

# 说明:在注释中,属性值是不区分大小写的。





映射方法和属性(@Column)

@Column标记表示所持久化属性所映射表中的字段。

@Target({METHOD, FIELD}) @Retention(RUNTIME)

public @interface Column{

    String name() default "";

    boolean unique() default false;

    boolean nullable() default false;

    boolean insertable() default false;

    boolean updateable() default false;

    String columnDefinition() default "";

    String table() defalut "";

    int lenght() default 255;

    int precision() default 0;

    int scale() default 0;

}

# 标记可以标注在Getter方法前或属性前;

# name为字段名;

# unique为字段是否唯一标识,默认为false;

# nullable为该字段是否可以为null值,默认为true;

# insertable为使用“INSERT”脚本插入数据时,是否需要插入该字段的值;

# updateable为使用“UPDATE”脚本更新数据时,是否需要更新该字段的值;

以上两个多用于只读属性,比如主键或外键等,这些字段通常为自动生成的。

# columnDefinition表示创建表时,该字段创建的SQL语句,一般用于通过Entity生成表定义时使用;

# table属性表示当映射多个表时,指定表的表中的字段,默认值为主表的表名;

# lenght表示字段的长度;

# precision和scale均表示精度;

示例:

@Column(name="contact_name", nullable=false, length=200)

@Column(name="contact_name", nullable=false, columnDefinition="clob not null")



映射优化:

· 基本类型 VS 封装类型

# 当为null时,若此时Entity的对应属性的类型为int,则将一个null转换为int型必定产生转换异常;但是如果此时Entity属性类型为Integer,它是一个对象,对象的值可以为null,此时不会有问题;

# 建议标注实体的属性使用Java基本类型的包装类(这可能会牺牲一些转换的效率);



· @Basic设置加载方式

@Target({METHOD, FIELD}) @Retention(RUNTIME)

public @interface Basic {

    FetchType fetch() default EAGER;

    boolean optional() default true;

}

# 默认Entity的属性加载方式都是即时加载(EAGER);

# 两种加载方式:

    LAZY惰性加载

    EAGER即时加载(默认)

示例:@Basic(fetch=FetchType.EAGER)



主键映射:

# 主键标识@Id

# @GeneratedValue主键生成策略:TABLE, SEQUENCE, IDENTITY, AUTO.

    @GeneratedValue(strategy = GenerationType.SEQUENCE  - Oracle

    @GeneratedValue(strategy = GenerationType.IDENTITY  - SQL server

# 生成策略:自增主键、表生成器(@TableGenerator)、Sequence生成器(@Sequence)、Identity生成器、复合主键(@IdClass)和嵌入式主键(@Embeddedld)。

# JPA可定义的生成主键策略比较:

    ·SEQUENCE,IDENTITY主要针对一些特殊的数据库,未确定系统要支持的数据库类型时,最好不要使用。

    ·AUTO用于比较简单的主键,对主键生成策略要求少

    ·TABLE生成策略是将主键的值持久化在数据库的表中,因为只要是关系型数据库,都可以创建一个表,专门来保存生成的值,这样就消除了数据库之间的不兼容性,既能保证支持多种数据库,又有一定的灵活性,建议使用。

    ·如果以上方法不能满足需求时,可以通过一定的规则来设置主键的值,可以使用UUID,使其在程序中自动生成,然后映射到实体的主键上,不能通过JPA的主键生成策略来实现。



示例:

@Id

@GeneratedValue(strategy=GenerationType.AUTO)



映射特殊类型:

· 映射Blob和Clob类型(@Lob)

# Blob和Clob类型都可以通过@Lob属性来标注(text类型字段也可以用该属性标注);

# Clob(Character Large Object)类型是长字符串类型,映射到为实体中的类型可以为char[]、Charater[]或者String类型;

# Blob(Binary Large Object)类型是字节类型,映射为实体中的类型可为byte[]、Byte[]或者实现了Serializable接口的类;

# 因为上述两种类型的数据一般占用内存比较大,因此通常使用惰性加载;



· 映射时间(Temporal)类型(@Temporal)

# 时间日期类型,需要用@Temporal来标注;

# TemporalType枚举类型定义为:DATE, TIME, TIMESTAMP;默认为TemporalType.TIMESTAMP;



· 映射枚举(Enumerated)型

# 通过@Enumerated类标注枚举类型;

# 使用@Enumerated时需要注意:

    枚举类型有两个属性:名称和值。通过EnumType来定义:ORDINAL,
STRING

    ORDINAL表示持久化的为枚举类型的值;STRING表示持久化的为枚举类型的名称;

# 建议使用ORDINAL类型来持久化枚举类型;

# 枚举类型的定义位置(实体内部或外部)根据具体情况而定。



· 映射非持久化类型(@Transient)

# 如果实体中有属性或者Getter方法并不需要持久化,则需要使用@Transient来标注。