类级别注解
@Entity注解
@Entity: 映射实体类
@Entity(name = "tableName")
name:可选，对应数据库中的一个表。若表名与实体类名相同，则可以省略。
注意： 使用@Entity时必须指定实体类的主键属性，该注解只能使用在类上面。
下面我们通过代码来测试一下效果。我们通过使用注解直接创建数据库的表数据。
首先创建一个Java Bean，并用@Entity注解和@Id注解
@Entity(name = "t_student")
public class Student {
@Id
private Integer id;
private String name;
private String sex;
private Date birthday;
// 省略setter/getter
}
接下来需要进行配置文件的配置了，因为使用了注解，所以就不再需要映射文件配置了。
<!-- hibernate.cfg.xml -->
<!-- 配置映射的实体类 -->
<mapping class="com.whyalwaysmea.annotation.Student"/>
这样进行简单的配置就可以测试了
@Test
public void init() {
// 创建配置对象
Configuration config = new Configuration().configure();
// 创建服务注册对象
ServiceRegistry serviceRegistry = new ServiceRegistryBuilder().applySettings(config.getProperties())
.buildServiceRegistry();
// 创建会话工厂
sessionFactory = config.buildSessionFactory(serviceRegistry);
// 创建会话对象
session = sessionFactory.openSession();
// 开启事务
transaction = session.beginTransaction();
}
我们这里的测试代码只是简单的进行相关属性的配置，运行之后会发现如下的输出：
Hibernate:
drop table if exists t_student
Hibernate:
create table t_student (
id integer not null,
birthday datetime,
name varchar(255),
sex varchar(255),
primary key (id)
)
通过sql语句的输出，可以发现@Entity(name = "t_student")中的name属性发挥作用了，生成的表名就是t_student。如果不配置该参数，那么生成的表名应该是student。
@Table
@Table(name = "", catalog = "", schema = "")
- name: 可选，映射表的名称，默认表名和实体名称一致，只有在不一致的情况下才需要指定表名。
- catalog: 可选，表示Catalog名称，默认为Catalog("")。
- schema: 可选，表示Schema名称，默认为Schema("")。
@Embeddable
@Embeddable表示一个非Entity类可以嵌入到另一个Entity类中作为属性而存在。
这里还以Student类为基础，我们额外增加一个Address.java表示地址， 它是Student的一个属性
@Embeddable
public class Address {
private String postCode;
private String address;
private String phone;
// 省略setter/getter
}
@Entity
@Table(name = "t_student")
public class Student {
...
private Address add;
// 省略setter/getter
}
测试用例依然和刚才一样，这里就直接输出控制台的语句了：
Hibernate:
drop table if exists t_student
Hibernate:
create table t_student (
id integer not null,
address varchar(255),
phone varchar(255),
postCode varchar(255),
birthday datetime,
name varchar(255),
sex varchar(255),
primary key (id)
)
这里把Address里面的属性都建立进入了t_student表中
属性级别注解
添加方式：
- 写在属性字段上面
- 写在属性的get方法上面
@Id
@Id: 是实体类必须的。 定义了映射到数据库表的主键的属性，一个实体类可以有一个或者多个属性被映射为主键，可置于主键属性或者getXxx()前。
注意： 如果有多个属性定义为主键属性，该实体类必须实现serializalbe接口。
@GeneratedValue
@GeneratedValue(strategy=GenerationType, generator=""): 可选， 用于定义主键生成策略。
strategy表示主键生成策略，取值有：
- GenerationType.AUTO: 根据底层数据库自动选择(默认)
- GenerationType.INDENTITY: 根据数据库的Identity字段生成
- GenerationType.SEQUENCE: 使用Sequence来决定主键的取值
- GenerationType.TABLE: 使用指定表来决定主键取值，结合@TableGenerator使用
generator: 表示主键生成器的名称，这个属性通常和ORM框架相关
例如：Hibernate可以指定uuid等主键生成方式
@Entity
@Table(name = "t_student")
public class Student {
@Id
@GeneratedValue(generator = "uuid")
@GenericGenerator(name = "uuid", strategy="uuid")
private String id;
private String name;
}
@GenericGenerator
@GenericGenerator注解是hibernate所提供的自定义主键生成策略生成器，由@GenericGenerator实现多定义的策略。所以，它要配合@GeneratedValue一起使用，并且@GeneratedValue注解中的”generator”属性要与@GenericGenerator注解中name属性一致，strategy属性表示hibernate的主键生成策略.
这里列出常用的几种生成策略:
- assigned: 手工分配主键ID值。该策略要求程序员必须自己维护和管理主键，当有数据需要存储时，程序员必须自己为该数据分配指定一个主键ID值，如果该数据没有被分配主键ID值或分配的值存在重复，则该数据都将无法被持久化且会引起异常的抛出。
- uuid：32位16进制数的字符串。采用128位UUID算法生成主键，能够保证网络环境下的主键唯一性，也就能够保证在不同数据库及不同服务器下主键的唯一性。uuid 最终被编码成一个32位16进制数的字符串，占用的存储空间较大。用于为 String 类型生成唯一标识，适用于所有关系型数据库。
- identity：自然递增。 支持 DB2，MySQL，SQL Server，Sybase 和HypersonicSQL 数据库， 用于为 long 或 short 或 int 类型生成唯一标识。它依赖于底层不同的数据库，与 Hibernate 和 程序员无关。
- increment：自然递增。与 identity 策略不同的是，该策略不依赖于底层数据库，而依赖于 hibernate 本身，用于为 long 或 short 或 int 类型生成唯一标识。主键计数器是由 hibernate 的一个实例来维护，每次自增量为 1，但在集群下不能使用该策略，否则将引起主键冲突的情况，该策略适用于所有关系型数据库使用。
@Column
@Column：可将属性映射到列，使用该注解来覆盖默认值，@Column描述了数据库表中该字段的详细定义，这对于根据JPA注解生成数据库表结构的工具非常有作用。
常用属性：
name: 可选，表示数据库表中该字段的名称，默认情形属性名字一致
nullable: 可选，表示该字段是否允许为null，默认为true
unique: 可选，表示该字段是否是唯一标识，默认为false
length: 可选，表示该字段的大小，仅对String类型的字段有效，默认值255.
insertable: 可选，表示在ORM框架执行插入操作时，该字段是否应出现在INSERT语句中，默认为true
updateable: 可选，表示在ORM框架执行更新操作时，该字段是否应该出现在update语句中，默认为true。对于一经创建就不可以更改的字段，该属性非常有用
@Embedded
@Embedded 是注释属性的，表示该属性的类是嵌入类
注意： 同时嵌入类也必须标注@Embeddable注解
@EmbeddedId
@EmbeddedId 使用嵌入式主键类实现复合主键
注意： 嵌入式主键类必须实现Serializable接口、必须有默认的public无参数构造方法，必须覆盖equals和hashCode方法
/**
* 嵌入式联合主键
*/
@Embeddable
public class ManPK implements Serializable {
@Column(length=18)
private String id; // 身份证号
@Column(length=8)
private String sId; // 用户编号
// 省略getter/setter equals hashCode方法
}
@Entity
@Table(name = "t_man")
public class Man {
@EmbeddedId
private ManPK manPK;
private String userName;
private Integer age;
}
@Test
public void idTest() {
ManPK manPK = new ManPK();
manPK.setId("321564561321");
manPK.setsId("abcdefg");
Man man = new Man();
man.setManPK(manPK);
man.setAge(21);
man.setUserName("善良的空间");
session.save(man);
}
@Transient
可选，表示该属性并非一个到数据库表的字段的映射，ORM框架将忽略该属性
