hibernate 常用注解

Hibernate注解映射

一、PO类的基本注释

1、@Entity：将一个类声明为一个实体bean(即一个持久化POJO类) ，可以指定一个name属性，指定实体类的名称。默认一该类的类名作为实体类的名称.

2、@Table：注释改持久化类所映射的表, 注解声明了该实体bean映射指定的表（table）,目录（catalog）和schema的名字
属性有① catalog 将持久化类映射的表放入指定的catalog中，如果没指定，则放入默认的catalog
② index为持久化类映射的表设置索引，值是一个@Index注解数组
③schema 将持久化类映射的表放入指定的schema中，如果没指定，则放入默认的schema
④name 设置持久化类的表名，默认是表名和持久化类的类名一致
⑤ uniqueConstraints 为持久化类映射的表设置唯一约束，属性值可以是一个@UniqueConstraints(columnNames属性配置)注释数组

3、@Id —— 注解声明了该实体bean的标识属性（对应表中的主键）。

3、@UniqueConstraints：用于数据表的唯一约束 columnNames属性是一个字符串数组，每一个元素代表一个数据列

4、@Index用于数据库建立索引
属性有 ①、cloumnList(必须要)：设置对那些列表建立索引，可以指定多个数据列的列名
②、name ：指定该索引的名字
③、unique：设置该索引是否具有唯一性，该属性的值只能是boolean值

5、@Proxy：该注解的proxyClass属性指定一个借口，在延迟加载时作为代理使用，也可以指定该类自己的名字

6、@DynamicInsert：指定用于插入记录的insert语句是否在运行时动态生成。并且只插入那些非空字段。默认值时false

7、@DynamicUpdate：指定用于更新巨鹿的update语句是否在运行是时动态生成，并且只更新那些修改过的字段，默认值是否false
当程序打开了@DynamicUpdate之后持久化注解可以指定如下几种乐观锁定的策略
OptimisiticLockType.VERSION：检查version/timestamp字段
OptimisiticLockType.ALL：查看全部字段
OptimisiticLockType.DIRTY：只检查修改过的字段
OptimisiticLockType.NONE：不使用乐观锁定

8、@SelectBeforeUpdate：制动Hbiernate在更新某个持久化对象之前是否进行一次select（建议false）

9、@PolymorphismType::用于指定是否需要采用隐世多台查询

二、映射属性（针对@Entity的持久化类）

1、@Clounm：指定某个属性所映射的数据列的详细信息(列名,字段长度等),注解声明了属性到列的映射。该注解有如下的属性

name：指定该列的列名。默认值是成员的变量名

unique：指定该属性是否具有唯一约束，默认值时false，不具有

nullable：是否设置该列的值可以为空（默认值false）

insertable：指定该列是否包含在Hibernate生成的的insert语句的列表中，该列是否作为生成的insert语句中的一个列（默认值true）

updatable 可选，该列是否作为生成的update语句中的一个列（默认值true）

columnDefinition 属性值时一个代表列定义的SQL字符串(列名后面部分),指定创建该数据列的SQL语句,为这个特定列覆盖sql ddl片段（这可能导致无法在不同数据库间移植）

table：指定该列所属的表名,定义对应的表（默认为主表）

length 可选，列长度（默认值255）

precision：当该列是decimal属性时，该属性指定支持的最大有效位数,列十进制精度（decimal precision)(默认值0）

scale：当该列为decimal类型时，该列支持的最大小数位数,如果列十进制数值范围（decimal scale）可用，在此设置（默认值0）

2、@Generated：指定该属性映射的书酷烈的值是否由数据库生成，该注解的value属性可以接受GenerationTime.NEVER(不由数据库生成) GenerationTime.INSERT(只在INSERT语句是生成) GenerationTime.ALWAYS(均会生成)

3、@Formula：指定一个SQL表达式，该属性的值根据表达式计算（属性值时动态的，所以无需扒皮存在数据库）

属性值value允许包含对象属性表达式，包括一些求值的SQL函数

4、@Transient：修饰不想持久保存的属性

5、@Enumerated修饰枚举类型的属性(需要一个专门的枚举类配合使用)

6、@Lob,@Basic：用于修饰大数据类型的属性

7、@Temproal：修饰日期类型的属性 value属性取之有 TemporalType.DATA/TemporalType.TIME/TemporalType/TIMESTAMP

三、映射主键（@id）

1、@GeneratedValue 自动生成值,注解声明了主键的生成策略。该注解有如下属性
strategy：指定生成的策略（JPA定义的），这是一个GenerationType。默认是GenerationType. AUTO (主键由程序控制)

GenerationType.TABLE（使用辅助表生成主键，配合@TaaleGenerator）使用一个特定的数据库表格来保存主键

GenerationType.IDENTITY（对于MYSQL/SQL Server自增长的生成策略）主键由数据库自动生成（主要是自动增长类型）

GenerationType.SEQUENCE（对于ORACLE自增长的生成策略，配合@SequenceGenerator）根据底层数据库的序列来生成主键，条件是数据库支持序列。

genetator：指定生成主键使用的生成器（可能是orcale中的序列）。用于配合GenerationType.SEQUENCE、GenerationType.TABLE使用

四、Hibernate的主键生成策略（@GenericGenerator--定义主键生成器）

@SequenceGenerator —— 注解声明了一个数据库序列。该注解有如下属性

name 表示该表主键生成策略名称，它被引用在@GeneratedValue中设置的“gernerator”值中
sequenceName 表示生成策略用到的数据库序列名称。
initialValue 表示主键初始值，默认为0.
allocationSize 每次主键值增加的大小，例如设置成1，则表示每次创建新记录后自动加1，默认为50.

@GenericGenerator —— 注解声明了一个hibernate的主键生成策略。支持十三种策略。该注解有如下属性

1、name：设置主键生成器的名称，这个名称可以被@GeneratedValue的generarot引用。

2、strategy：必须属性，指定具体生成器的类名（指定生成策略）。

3、parameters 得到strategy指定的具体生成器所用到的参数。

 1 其十三种策略（strategy属性的值）如下：   
 2 1.native 对于orcale采用Sequence方式，对于MySQL和SQL Server采用identity(处境主键生成机制)，   
 3     native就是将主键的生成工作将由数据库完成，hibernate不管（很常用）   
 4     例：@GeneratedValue(generator ="paymentableGenerator")       
 5         @GenericGenerator(name ="paymentableGenerator", strategy ="native")   
 6 2.uuid 采用128位的uuid算法生成主键，uuid被编码为一个32位16进制数字的字符串。占用空间大（字符串类型）。   
 7     例：@GeneratedValue(generator ="paymentableGenerator")       
 8     @GenericGenerator(name ="paymentableGenerator", strategy ="uuid")   
 9 3.hilo 要在数据库中建立一张额外的表，默认表名为hibernate_unque_key，默认字段为integer类型，名称是next_hi（比较少用）   
10     例：@GeneratedValue(generator ="paymentableGenerator")       
11     @GenericGenerator(name ="paymentableGenerator", strategy ="hilo")   
12 4.assigned 在插入数据的时候主键由程序处理（很常用），这是<generator>元素没有指定时的默认生成策略。等同于JPA中的AUTO。   
13     例：@GeneratedValue(generator ="paymentableGenerator")       
14     @GenericGenerator(name ="paymentableGenerator", strategy ="assigned")   
15 5.identity 使用SQL Server和MySQL的自增字段，这个方法不能放到Oracle中，Oracle不支持自增字段，要设定sequence(MySQL和SQL Server中很常用)。等同于JPA中的IDENTITY   
16     例：@GeneratedValue(generator ="paymentableGenerator")       
17     @GenericGenerator(name ="paymentableGenerator", strategy ="identity")   
18 6.select 使用触发器生成主键（主要用于早期的数据库主键生成机制，少用）   
19     例：@GeneratedValue(generator ="paymentableGenerator")       
20     @GenericGenerator(name ="paymentableGenerator", strategy ="select")   
21 7.sequence 调用谨慎数据库的序列来生成主键，要设定序列名，不然hibernate无法找到。   
22     例：@GeneratedValue(generator ="paymentableGenerator")      
23     @GenericGenerator(name ="paymentableGenerator", strategy ="sequence",       
24     parameters = { @Parameter(name ="sequence", value ="seq_payablemoney") })   
25 8.seqhilo 通过hilo算法实现，但是主键历史保存在Sequence中，适用于支持Sequence的数据库，如Orcale(比较少用）   
26     例：@GeneratedValue(generator ="paymentableGenerator")      
27     @GenericGenerator(name ="paymentableGenerator", strategy ="seqhilo",       
28     parameters = { @Parameter(name ="max_lo", value ="5") })   
29 9.increnment 插入数据的时候hibernate会给主键添加一个自增的主键，但是一个hibernate实例就维护一个计数器，所以在多个实例运行的时候不能使用这个方法。   
30     例：@GeneratedValue(generator ="paymentableGenerator")       
31     @GenericGenerator(name ="paymentableGenerator", strategy ="increnment")   
32 10.foreign 使用另一个相关的对象的主键。通常和<one-to-one>联合起来使用。   
33     例：@Id       
34     @GeneratedValue(generator ="idGenerator")      
35     @GenericGenerator(name ="idGenerator", strategy ="foreign",       
36     parameters = { @Parameter(name ="property", value ="info") })       
37     Integer id;   
38     @OneToOne   
39     EmployeeInfo info;   
40 11.guid 采用数据库底层的guid算法机制，对应MySQL的uuid()函数，SQL Server的newid()函数，ORCALE的rawtohex(sys_guid())函数等   
41     例：@GeneratedValue(generator ="paymentableGenerator")        
42     @GenericGenerator(name ="paymentableGenerator", strategy ="guid")   
43 12.uuid.hex 看uudi,建议用uuid替换   
44     例：@GeneratedValue(generator ="paymentableGenerator")        
45     @GenericGenerator(name ="paymentableGenerator", strategy ="uuid.hex")   
46 13.sequence-identity sequence策略的扩展，采用立即检索策略来获取sequence值，需要JDBC3.0和JDK4以上（含1.4）版本   
47     例：@GeneratedValue(generator ="paymentableGenerator")      
48     @GenericGenerator(name ="paymentableGenerator", strategy ="sequence-identity",       
49     parameters = { @Parameter(name ="sequence", value ="seq_payablemoney") })

View Code

生成策略有 1、increment：位long、short或者int类型的主键生成唯一标识。（集群不要使用）
2、identity:：返回的标识属性值是long、short、int类型的
3、sequence：返回的标识属性值是long、short、int类型的
4、hilo/sqphilo/uuid/guid/native/assigned/select/foreign

五、映射集合属性(@ElementCollection)
1、@ElementCollection的个属性：1、fetch：指定集合的抓取策略(FetchType.EAGER（立即抓取） Fetch.LAZY（延迟抓取）)
2、targetClass、指定集合属性中集合元素的类型

2、@CollectionTable注解映射保存集合属性的表
属性：1、name：保存集合属性的数据库的表名
2、catalog：指定保存集合属性的数据表放在指定的catalog中
3、scema：指定保存集合属性的数据表放在指定的scema中
4、indexes：为持久化类所映射的表设置索引，配合@Index注解数组
5、JoinColumns：配合@JoinColum使用
6、uniqueConstraints：为持久化类索引社的表设置唯一约束。配合@UniqueConstraint使用
3、@JoinColumn：进行外键映射
属性1、cloumnDefinition：指定Hibernate使用该属性指定的SQL片段来创建外键列
2、name：指定外键列的列名
3、insertable：指定该列是否包含在Hibernate生成的insert语句的列列表中，默认值：true
4、updatable：指定该列是否包含在Hibernate生成的update语句的列列表中，默认值：true
5、nullable
6、table：指定该列所在数据表的表名
7、unique：是否为该列增加唯一约束
8、referencedColumName：指定该列所参照的主键列的列名

4、@OrderColimn：用于定义List集合、数组的索引列
@MapKeyColumn：用于映射MAP集合的索引列

六、关联映射

1、@OneToOne单项1--1关联
cascade：CascadeType.ALL(指定所有的持久化操作都级联到关联实体)

设置一对一个关联。cascade属性有五个值(只有CascadeType.ALL好用？很奇怪)，分别是CascadeType.PERSIST(级联新建)，CascadeType.REMOVE（级联删除），CascadeType.REFRESH（级联刷新），CascadeType.MERGE（级联更新）将MERGE操作级联到关联实体，CascadeType.ALL（全部四项）

fetch：指定抓取策略，FetchType.EAGER,立即抓取 FetchType.LAZY:抓取实体时，延迟抓取关联实体
optional：指定关联关系是否可选
mappedBy：该属性合法的属性值为关联实体的属性名，该属性指定关联实体中那个属性可引用到当前实体
orphamRemoval：指定关联关系是否可选
targetEntity：指定关联实体的类名(默认反射判断实现，可以不指定)

方法一   
    主表： ?@OneToOne(cascade = CascadeType.ALL)   
      @PrimaryKeyJoinColumn  
      public 从表类 get从表类(){return 从表对象}   
       从表：没有主表类。   
       注意：这种方法要求主表与从表的主键值想对应。   
方法二   
    主表：?@OneToOne(cascade = CascadeType.ALL)   
      @JoinColumn(name="主表外键")//这里指定的是数据库中的外键字段。  
      public 从表类 get从表类(){return 从表类}   
    从表：@OneToOne(mappedBy ="主表类中的从表属性")//例主表User中有一个从表属性是Heart类型的heart，这里就填heart  
      public 主表类 get主表类(){return 主表对象}   
    注意：@JoinColumn是可选的。默认值是从表变量名+"_"+从表的主键（注意，这里加的是主键。而不是主键对应的变量）。   
方法三   
    主表：@OneToOne(cascade=CascadeType.ALL)   
      @JoinTable( name="关联表名",   
    joinColumns = @JoinColumn(name="主表外键"),   
    inverseJoinColumns = @JoinColumns(name="从表外键")   
       )   
    从表：@OneToOne(mappedBy ="主表类中的从表属性")//例主表User中有一个从表属性是Heart类型的heart，这里就填heart  
      public 主表类 get主表类(){return 主表对象}

View Code

2. @ManyToOne ：单向N-1关联,@ManyToOne 设置多对一关联

cascade：CascadeType.ALL(指定所有的持久化操作都级联到关联实体) CascadeType.MERGE:将MERGE操作级联到关联实体 CascadeType.PERSIST,CascadeType.REFRESH,CascadeType.REMOVE

fetch：指定抓取策略，FetchType.EAGER,立即抓取 FetchType.LAZY:抓取实体时，延迟抓取关联实体
optional：指定关联关系是否可选
targetEntity：指定关联实体的类名(默认反射判断实现，可以不指定)

方法一          
    @ManyToOne(cascade={CasCadeType.PERSIST,CascadeType.MERGE})   
    @JoinColumn(name="外键")   
    public 主表类 get主表类(){return 主表对象}   
方法二   
    @ManyToOne(cascade={CascadeType.PERSIST,CascadeType.MERGE})   
    @JoinTable(name="关联表名"，   
     joinColumns = @JoinColumn(name="主表外键"),   
     inverseJoinColumns = @JoinColumns(name="从表外键")   
     )

View Code

3:、@OneToMany：单项1-N关联,设置一对多关联。cascade属性指定关联级别,参考@OneToOne中的说明。fetch指定是否延迟加载，值为FetchType.LAZY表示延迟，为FetchType.EAGER表示立即加载

cascade：CascadeType.ALL(指定所有的持久化操作都级联到关联实体) CascadeType.MERGE:将MERGE操作级联到关联实体 CascadeType.PERSIST,CascadeType.REFRESH,CascadeType.REMOVE
fetch：指定抓取策略，FetchType.EAGER,立即抓取 FetchType.LAZY:抓取实体时，延迟抓取关联实体
mappedBy：该属性合法的属性值为关联实体的属性名，该属性指定关联实体中那个属性可引用到当前实体
orphamRemoval：指定关联关系是否可选
targetEntity：指定关联实体的类名(默认反射判断实现，可以不指定)

方法一      使用这种配置，在为“一端”添加“多端”时，不会修改“多端”的外键。在“一端”加载时，不会得到“多端”。如果使用延迟加载，在读“多端”列表时会出异常，立即加载在得到多端时，是一个空集合（集合元素为0）。   
     “一端”配置   
    @OneToMany(mappedBy="“多端”的属性")   
    public List<“多端”类> get“多端”列表(){return “多端”列表}   
     “多端”配置参考@ManyToOne.        
方法二   
     “一端”配置   
    @OneToMany(mappedBy="“多端”的属性")   
    @MapKey(name="“多端”做为Key的属性")   
    public Map<“多端”做为Key的属性的类,主表类> get“多端”列表（）{return “多端”列表}   
     “多端”配置参考@ManyToOne.   
方法三 使用这种配置，在为“一端”添加“多端”时，可以修改“多端”的外键。   
     “一端”配置   
    @OneToMany  
    @JoinColumn(name="“多端”外键")   
    public List<“多端”类> get“多端”列表(){return “多端”列表}   
     “多端”配置参考@ManyToOne.

View Code

Java编译器自带的一些注解：

@SuppressWarnings({ "serial", "unchecked" })

@SuppressWarnings("deprecation")【屏蔽编译器警告】

@transient【java语言的关键字，变量修饰符，如果用transient声明一个实例变量，当对象存储时，它的值不需要维持。 Java的serialization提供了一种持久化对象实例的机制。当持久化对象时，可能有一个特殊的对象数据成员，我们不想用serialization机制来保存它。为了在一个特定对象的一个域上关闭serialization，可以在这个域前加上关键字transient。当一个对象被串行化的时候，transient型变量的值不包括在串行化的表示中，然而非transient型的变量是被包括进去的。】

二级缓存（一般使用第三方提供的开源缓存实现）
1.开启二级缓存
<property name = "hibernate.cache.user_second_level_cache">true<property>

二级缓存有三种缓存实现--ConcurrentHashMap(内存,不推荐), EhCache(内存,磁盘,事务性，支持集群), Infinispan(事务性，支持集群)

2.使用二级缓存（这里使用的是EhCache方式）
第一步：在hibernate.cfg.xml文件中启动二级缓存--设置启用二级缓存，设置二级缓存的实现类
第二步：导入JAR包
第三步：添加二级缓存的配置文件xml（此处不具体介绍）
第四步：设置具体实现类，使用@Cache注释修饰持久化类(同时可以在Cache中设置属性(usage=CacheConcurrentcyStrategy.READ_ONLY/WIRTE))

如果想要开启二级缓存的统计功能，在hibernate.cfg.xml配置下面的配置
<property name = "hibernate.generate.statistics">true<property>
<property name = "hibernate.cache.use_structured_entries">true</property>

如果想开启查询缓存，在hibernate.cfg.xml配置下面的配置
<property name="hibernate.cache.use_query_cache">true</property>

(https://www.cnblogs.com/hu1056043921/p/7943950.html)

(https://www.cnblogs.com/zzmb/p/7733677.html)

posted @ 2019-06-29 20:42 andy_mz 阅读(488) 评论(0) 收藏举报

刷新页面返回顶部

andy

hibernate 常用注解

Hibernate注解映射

一、PO类的基本注释

二、映射属性（针对@Entity的持久化类）

三、映射主键（@id）

四、Hibernate的主键生成策略（@GenericGenerator--定义主键生成器）

公告