一个普通的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来标注。