1.@Entity:
@Entity标注用于实体类声明语句之前,指出该Java类为实体类,将映射到指定的数据库表。
2.@Table:
当实体类与其映射的数据库表名不同名时,需要使用@Table标注说明,该标注与@Entity标注并列使用,置于实体类声明语句之前,可写于单独语句行,也可与声明语句同行。
@Table标注的常用选项是name,用于指明数据库的表名。
@Table标注还有一个两个选项catalog和schema用于设置表所属的数据库目录或模式,通常为数据库名。uniqueConstraints选项用于设置约束条件,通常不须设置。
3.@Id:
@Id标注用于声明一个实体类的属性映射为数据库的主键列。该属性通常置于属性声明语句之前,可与声明语句同行,也可写在单独行上。
@id标注也可置于属性的getter方法之前。
4.@GeneratedValue:
@GeneratedValue用于标注主键的生成策略,通过strategy属性指定。默认情况下,JPA自动选择一个最合适底层数据库的主键生成策略:SqlServer对应identity,MySQL对应auto increment
在java.persistence.GenerationType中定义了一下几种可供选择的策略:
--IDENTITY:采用数据库ID自增长的方式来自增主键字段,Oracle不支持这种方式;
--AUTO:JPA自动选择合适的策略,是默认选项;
--SEQUENCE:通过序列产生主键,通过@SequenceGenertor注解指定序列名,MySql不支持这种方式,Oracle可以使用;
--TABLE:通过表产生主键,框架借由表模拟序列产生主键,使用该策略可以使应用更易于数据库移植。
在使用TABLE主键生成策略的时候,则需要一个属性generator(生成器),这个属性对应另一个注解——@TableGenerator,这个注解中的name属性值与generator属性值相对应,@TableGenerator还有一个属性table,用于指定生成主键对应的表,在确定了对应的表之后,则需要确定通过属性pkColumnName、pkColumnValue、valueColumnName确定唯一的值,还可以通过属性allocationSize设置增长幅度,例如:
@TableGenerator(name="ID_GENERATOR",table="jpg_id_generators",
pkColumnName="PK_NAME",
pkColumnValue="CUSTOMER_ID",
valueColumnName="PK_VALUE",
allocationSize=100)
@GeneratedValue(strategy=GenerationType.TABLE,generator="ID_GENERATOR")
@Id
public Integer getId(){
return id;
}
5.@Basic:
@Basic表示一个简单的属性到数据库表的字段的映射,对于没有任何标注的getXxxx()方法,默认即位@Basic。
--fetch:表示该属性的读取策略,有EAGER和LAZY两种,分别表示主支抓取和延迟加载,默认为EAGER。
--optional:表示该属性是否允许为null,默认为true。
6.@Column:
当实体的属性与其映射的数据库表的列不同名时需要使用@Column标注说明,该属性通常置于实体的属性声明语句之前,还可与@Id标注一起使用。
@Column标注的常用属性是name,用于设置映射数据库表的列名。此外,该标注还包含其他多个属性,如:unique、nullable、length等。
@Column标注的columnDefinition属性:表示该字段在数据库中的实际类型。通常ORM框架可以根据属性类型自动判断数据库中字段的类型,但是对于Date类型仍然无法确定数据库中字段类型究竟是DATE、TIME还是TIMESTAMP。此外,String的默认映射类型为VARCHAR,也可将String类型映射到特定数据库的BLOB或TEXT字段类型。
@Column标注也可置于属性的getter方法之前。
7.@Transient:
表示该属性并非一个到数据库表的字段的映射,ORM框架将忽略该属性。
如果一个属性并非数据库的字段映射,就务必将其标示为@Transient,否则,ORM框架默认其注解为@Basic。
8.@Temporal:
在核心的Java API中并没有定义Date类型的精度(temporal precision)。而在数据库中,表示Date类型的数据有DATE、TIME和TIMESTAMP三种精度(即单纯的日期、时间或者两者兼备)。在进行属性映射时可使用@Temporal注解来调整精度。
例如:
@Temporal(TemporalType.TIMESTAMP)
public Date getCreatedTime(){
return createTime;
}