一个普通的POJO类通过标注@Entity可以映射成为可持久化的类，可持久化的类可以对应数据库中的数据。映射成为实体类要依赖一些特定的规则。
1、映射实体 （@Entity）
标注为@Entity注释的类，表示该类是一个可持久化的类，当在容器中时，服务器将会首先加载所有标注了@Entity注释的实体类，例如：
|
1
2
3
4
5
6
|
@Entitypublic class ContaceEO { ... ContactEO() {...} ...} |
@Entity注释的定义的属性如下：
|
1
2
3
4
|
@Target(TYPE) @Retention(RUNTIME)public @interface Entity { String name() default "";} |
其中name属性表示实体的名字，若不作设置，默认为标注实体类的名称。
注：标注为@Entity的实体类至少要有一个无参的构造方法。
2、标注主键（@Id）
用于标注实体类中关联数据库的主键
3、映射表（@Table）、映射方法和属性（@Column）
如下表结构：
|
1
2
3
4
|
create table contact ( id int(20) not null, name varchar(50) default null,) |
实体类代码改为：
|
1
2
3
4
5
6
7
8
9
10
11
|
@Entity@Table(name="contact")public class ContactEO implements java.io.Serializable { @Id private Integer id; @Column(name="name") private String name; //省略get、set方法} |
@Table的属性定义如下：
|
1
2
3
4
5
6
7
|
@Target({TYPE}) @Retention(RUNTIME)public @interface Table { String name() default ""; String catalog() default ""; String schema() default ""; UniqueConstraint[] uniqueConstraints() default {};} |
要注意一下几个问题：
a、该标记要在类前面
b、name属性表示实体对应的表的名称
c、catalog和shema属性表示实体指定的目录名或数据库名
d、uniqueConstraints标记属性表示该实体所关联的唯一约束条件，一个实体可以有多个唯一约束条件
|
1
2
3
4
|
@Entity@Table(name="contact", uniqueConstraints = { @UniqueConstraint(columnNames = {"name", "email"})}) |
表示指定表的name和email字段为唯一表示，也就是说不能同时存在完全相同的name和email值的记录，相当于sql中：
|
1
2
|
...unique key name_email (name,email) |
@Column标记的属性定义如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
@Target({METHOD,FIELD}) @Retention(RUNTIME)public @interface Column { String name() default ""; boolean unique() default false; boolean nullable() default true; boolean insertable() default true; boolean updateable() default true; String columnDefinition() default ""; String table() default ""; int length() default 255; int precision() default 0; int scale() default 0;} |
使用@Column标记要注意几个问题：
a、此标记可以标注在getter方法前或属性前
b、unique属性表示该字段是否是唯一标识，默认为false
c、columnDefinition属性表示创建表时，该字段创建的SQL语句，一般用于通过Entity生成表定义时使用。
d、table属性表示当映射多个表时，指定表的表中的字段。
e、precision属性和scale属性表示精度，当字段类型为double时，precision表示数值的总长度，scale表示小数点所占的位数。
例如：自定义CLOB类型字段的SQL语句，代码如下：
|
1
2
|
@Column(name="constact_name", columnDefinition="clob not null")private String name; |
生成的SQL语句如下：
|
1
2
3
4
5
|
create table contact ( id int not null; contact_name clob(200) not null; primary key (id)) |
4、可持久化的基础数据类型
（1）Java基础类型：byte, int, short, long, boolean, char, float, double
（2）Java基础数据类型对应的封装类： Byte, Integer, Short, Long, Boolean, Character, Float, Double
（3）字节和字符型数组： byte[], Byte[], char[], Character[]
（4）大数值类型： java.math.BigInteger, java.math.BigDecimal
（5）字符串类型：String
（6）时间日期类型：java.util.Date, java.util.Calendar, java.sql.Date, java.sql.Time, java.sql.TimeStamp
（7）枚举类型：用户定义的枚举类型
（8）Entity类型：标注为@Entity的类
（9）包含Entity类型的集合Collection类：java.util.Collection, java.util.List, java.util.Map
（10）嵌入式（embeddable）类
|
1
2
3
4
5
|
@Target({METHOD, FIELD}) @Retention(RUNTIME)public @interface Basic { FetchType fetch() default EAGER; boolean optional() default true;} |