Hibernate注解（一）：基本注解

在Hibernate中使用注解，主要是为了替代映射文件，完成“类到表，属性到字段”的映射。
JPA提供了一套功能强大的注解。Hibernate直接使用了JPA的这套注解。当然，对于JPA中的一些不足，Hibernate又开发了一些自己的注解。这些注解要么继承自JPA，要么是独立的注解，作为JPA的补充。
故，我们使用的注解，基本是javax.persistence.Transient包中的。
使用注解时需注意以下几点：
（1）使用的均为javax.persistence.Transient包中的注解
（2）不再需要映射文件了
（3）在Hibernate主配置文件中无需指定映射文件了，但需要指定注解的实体类。（springboot这一步也省了）

注解的具体文档在javax.persistence包下的注解类型总结Annotation Type Summry中。

1、Hibernate基本注解

根据其标注的位置与完成的功能，Hibernate注解可分为两种：类级注解、属性级注解。
. 类级注解：注解在类的头部。完成类到表的映射。
. 属性级注解：注解在属性上面，或属性的get方法上面。完成属性到字段的映射。

第一类：类级注解

（1）@Entity
用在POJO类上，表示当前类为实体类。name属性为实体名称。默认为类的非限定性类名。一般使用默认值。

（2）@Table
与@Entity联合使用。name属性指定映射的表名。默认与实体名称相同。

@Entity
@Table(name="city")
public class City {}

第二类：属性级注解

属性级注解根据其注解属性的不同，又可分为两类：主键相关注解，与普通属性注解。

主键相关注解

（1）@Id
用在主键id属性上，或其get方法上，表示当前属性将对应数据库中的主键。

（2）@GeneratedValue
指定主键值的来源。其属性strategy用于指定主键的生成策略。其值为系统定义好的四种策略之一。默认为AUTO。

 GenerationType.AUTO：根据底层数据库自动选择（默认）若数据库支持自增长，则为自增长。类似于配置文件中的native生成策略。
在MySql中使用该策略，自动选择了Sequence生成方式。即主键值来自于序列表，而序列表由DB自己维护。查看数据库可看到，其创建了两个表，一个是映射表t_student，另一个则是序列表hibernate_sequence。
后台报错，查看错误信息，提示需要填充该序列表：you need to populate the table: hibernate_sequence。打开表hibernate_sequence，发现表中为空，即序列为空。需要为序列表指定一个初始值。填值为1后，再运行就不报错了。
 GenerationType.IDENTITY：根据数据库的Identity字段生成。类似于配置文件中的indentity生成策略。
 GenerationType.SEQUENCE：使用Sequence来决定主键的取值。类似于配置文件中的Sequence生成策略。
 GenerationType.TABLE：使用指定表来决定主键取值，结合@TableGenerator使用。
注解中的生成策略只有四种。若要使用Hibernae映射文件中的主键生成器，则可使用@GenericGenerator指定一个Hibernate主键生成器，再使用@GeneratedValue的属性generator来引用即可。

    @Id
    @GeneratedValue(generator = "city")
    @GenericGenerator(name ="city",strategy = "native")
    @Column(name="CityId")
    private Integer cityId;

 

（1）@Column
可将属性映射到列，描述了数据库表中该字段的详细定义。该注解的属性较多。
 name：可选，表示DB中该字段的名称，默认与属性名相同
 nullable：可选，表示该字段是否允许为 null，默认为 true
 unique：可选，表示该字段是否唯一，默认为 false
 length：可选，表示该字段的大小，仅对 String 类型的字段有效，默认值255
 insertable：可选，表示该字段是否可以出现在insert语句中。默认为 true。通常主键、时间戳等字段的该值设置为false。因为它们的值都是自动生成的，不需要在insert时插入。
 updateable：可选，表示该字段是否可以出现在update语句中。默认为true。通过对于一经创建就不用修改的字段，如birthday、gender等，可将该值设置为false。
 table：可选。当前字段所在的表。默认为当前表。
 precision和scale：表示精度，当字段类型为double时，precision表示数值的总长度，scale表示小数点所占的位数。
 columnDefinition：可选。用于覆盖数据库DDL建表语句中对于该字段的创建语句。

（2）@Basic与@Transient
@Basic：表示该字段将映射到DB中。是属性的默认注解。

@Transient：表示该字段将不映射到DB中。（无属性）
（3）@Version
可以在实体bean中使用@Version注解,通过这种方式可添加对乐观锁定的支持。（无属性）
（4）@Temporal
Java代码中使用的时间日期类型为java.util包下的Time、Date与Timestamp。而注解使用的则为java.sql包下的Time、Date与Timestamp。@Temporal表示将java.util包下的类映射为java.sql包下的相应类。

java.sql包下的Date、Time与Timestamp这三种时间，其精确度是不同。具体如下：

 

import org.hibernate.annotations.GenericGenerator;
import javax.persistence.*;

/**
 * Created by wangbin10 on 2018/4/25.
 */
@Entity
@Table(name="city")
public class City {

    @Id
    @GeneratedValue(generator = "city")
    @GenericGenerator(name ="city",strategy = "native")
    @Column(name="CityId")
    private Integer cityId;

    @Column(name="CityName")
    private String cityName;

    public Integer getCityId() {
        return cityId;
    }

    public void setCityId(Integer cityId) {
        this.cityId = cityId;
    }

    public String getCityName() {
        return cityName;
    }

    public void setCityName(String cityName) {
        this.cityName = cityName;
    }

    @Override
    public String toString() {
        return "City{" +
                "cityId=" + cityId +
                ", cityName='" + cityName + '\'' +
                '}';
    }
}