JPA基本属性注解

JPA注解
1、@Entity
package javax.persistence;
@Target(TYPE) @Retention(RUNTIME)
public @interface Entity
{
String name( ) default "";
}
name( )属性指定实体bean的名称，如果没有为该属性提供取值，默认值为 bean class 的非限定类名。如果你提供了该属性值，如@Entity(name="MyPerson")，那么在JPQL表达式中，你应使用该名称，如：select o fromMyPerson o where o.personid=?1。

2、@Table(name="",catalog="",schema="")

package javax.persistence;
@Target({TYPE}) @Retention(RUNTIME)
public @interface Table
{
String name( ) default "";
String catalog( ) default "";
String schema( ) default "";
UniqueConstraint uniqueConstraints( ) default {};
}

可选,通常和@Entity配合使用,只能标注在实体的class定义处,表示实体对应的数据库表的信息
name:可选,表示表的名称.默认地,表名和实体名称一致,只有在不一致的情况下才需要指定表名 (与数据库关键字冲突)
catalog:可选,表示Catalog名称,默认为Catalog("").
schema:可选,表示Schema名称,默认为Schema("").
uniqueConstraints( )属性允许你指定唯一性字段约束。如，下面为 personid 和name 字段指定唯一性约束：
@Table(
name="Person",
uniqueConstraints={ @UniqueConstraint(columnNames={"personid", "name"})}
)
@UniqueConstraint 注释的定义如下：
public @interface UniqueConstraint
{
String[] columnNames( );
}
columnNames( ) 属性指定字段名，如果有多个，请用大括号括起来，每个字段名之间用逗号分隔。


3、@Id

package javax.persistence;
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface Id{ }

@id定义了映射到数据库表的主键的属性,一个实体只能有一个属性被映射为主键.

4、@GeneratedValue

package javax.persistence;
@Target({METHOD, FIELD}) @Retention(RUNTIME)
public @interface GeneratedValue
{
GenerationType strategy( ) default AUTO;
String generator( ) default "";
}

strategy:表示主键生成策略,有AUTO,INDENTITY,SEQUENCE 和 TABLE 4种,分别表示让ORM框架自动选择,
根据数据库的Identity字段生成,根据数据库表的Sequence字段生成,以有根据一个额外的表生成主键,默认为AUTO
generator:表示主键生成器的名称,这个属性通常和ORM框架相关,例如,Hibernate可以指定uuid等主键生成方式.
Hibernate UUID
@Id @GeneratedValue(generator="system-uuid")
@GenericGenerator(name="system-uuid",strategy = "uuid")

5、@Basic(fetch=FetchType,optional=true)
@Basic注释
对于加了@Lob 注释的大数据类型 ，为了避免每次加载实体时占用大量内存，我们有必要对该属性进行延时加载，这时我们需要用到@Basic注释，@Basic 注释的定义如下：
public @interface Basic
{
FetchType fetch( ) default EAGER;
boolean optional( ) default true;
}
FetchType 属性指定是否延时加载，默认为立即加载。
optional属性指定在生成数据库结构时字段是否允许为 null。

6、@Column

@javax.persistence.Column注释指定实体Bean的成员属性映射到数据表中的哪一个字段和该字段的一些结构信息（如字段是否唯一，是否允许为空，是否允许更新等） ，该注释需标注在成员属性的 getter方法上，
public @interface Column
{
String name( ) default "";
boolean unique( ) default false;
boolean nullable( ) default true;
boolean insertable( ) default true;
boolean updatable( ) default true;
String columnDefinition( ) default "";
String table( ) default "";
int length( ) default 255;
int precision( ) default 0;
int scale( ) default 0;
}

@Column描述了数据库表中该字段的详细定义,这对于根据JPA注解生成数据库表结构的工具非常有作用.
name:表示数据库表中该字段的名称,默认情形属性名称一致
nullable:表示该字段是否允许为null,默认为true
unique:表示该字段是否是唯一标识,默认为false
length:表示该字段的大小,仅对String类型的字段有效
columnDefinition:表示该字段在数据库中的实际类型.通常ORM框架可以根据属性类型自动判断数据库中字段的类型,但是对于Date类型仍无法确定数据库中字段类型究竟是DATE,TIME还是TIMESTAMP.此外,String的默认映射类型为VARCHAR,如果要将String类型映射到特定数据库的BLOB或TEXT字段类型,该属性非常有用.
@Column(name="BIRTH",nullable="false",columnDefinition="DATE")
public String getBithday() {
return birthday;
}

7、@Transient
@Transient表示该属性并非一个到数据库表的字段的映射,ORM框架将忽略该属性.
如果一个属性并非数据库表的字段映射,就务必将其标示为@Transient,否则,ORM框架默认其注解为@Basic
@Transient
public int getAge() {
return getYear(new Date()) - getYear(birth);
}

8、@Enumerated枚举
@Enumerated 注释可以将枚举类型成员属性映射到数据库。属性可以被映射为字符串形式（用EnumType.STRING 指定） ，也可以映射为枚举值的数据序号（用 EnumType.ORDINAL指定）

9、@Temporal时间

package javax.persistence;
public enum TemporalType
{
DATE, //代表 date类型 //java.sql.Date 2008-08-08
TIME, //代表时间类型 //java.sql.Time 20:00:00
TIMESTAMP //代表时间 //java.sql.Timestamp 2008-08-08 20:00:00.000000001
}

10、@Lob
@Lob适用于标注字段类型为Clob和Blob类型。
Clob（Character Large Ojects）类型是长字符串类型，实体的类型可为char[]、Character[]、或者String类型
Blob（Binary Large Objects）类型是字节类型，实体的类型可为byte[]、Byte[]、或者实现了Serializable接口的类。
通常使用惰性加载的方式，@Basic(fetch=FetchType.LAZY)

JPA不支持boolean类型的属性映射(可用枚举代替)