Hibernate注解（一）

类级别注解

@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表中

属性级别注解

添加方式：
1. 写在属性字段上面
2. 写在属性的get方法上面

@Id

@Id: 是实体类必须的。 定义了映射到数据库表的主键的属性，一个实体类可以有一个或者多个属性被映射为主键，可置于主键属性或者getXxx()前。

注意： 如果有多个属性定义为主键属性，该实体类必须实现serializalbe接口。

@GeneratedValue

@GeneratedValue(strategy=GenerationType, generator=”“): 可选， 用于定义主键生成策略。
strategy表示主键生成策略，取值有：
1. GenerationType.AUTO: 根据底层数据库自动选择(默认)
2. GenerationType.INDENTITY: 根据数据库的Identity字段生成
3. GenerationType.SEQUENCE: 使用Sequence来决定主键的取值
4. 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的主键生成策略.
这里列出常用的几种生成策略:
1. assigned: 手工分配主键ID值。该策略要求程序员必须自己维护和管理主键，当有数据需要存储时，程序员必须自己为该数据分配指定一个主键ID值，如果该数据没有被分配主键ID值或分配的值存在重复，则该数据都将无法被持久化且会引起异常的抛出。
2. uuid：32位16进制数的字符串。采用128位UUID算法生成主键，能够保证网络环境下的主键唯一性，也就能够保证在不同数据库及不同服务器下主键的唯一性。uuid 最终被编码成一个32位16进制数的字符串，占用的存储空间较大。用于为 String 类型生成唯一标识，适用于所有关系型数据库。
3. identity：自然递增。 支持 DB2，MySQL，SQL Server，Sybase 和HypersonicSQL 数据库， 用于为 long 或 short 或 int 类型生成唯一标识。它依赖于底层不同的数据库，与 Hibernate 和 程序员无关。
4. 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框架将忽略该属性