属性名 | 用途 |
---|---|
hibernate.dialect | 一个Hibernate Dialect 类名允许Hibernate针对特定的关系数据库生成优化的SQL. 取值 |
hibernate.show_sql | 输出所有SQL语句到控制台. 有一个另外的选择是把org.hibernate.SQL 这个log category设为debug 。 eg. |
hibernate.format_sql | 在log和console中打印出更漂亮的SQL。 取值 |
hibernate.default_schema | 在生成的SQL中, 将给定的schema/tablespace附加于非全限定名的表名上. 取值 |
hibernate.default_catalog | 在生成的SQL中, 将给定的catalog附加于非全限定名的表名上. 取值 |
hibernate.session_factory_name | SessionFactory 创建后,将自动使用这个名字绑定到JNDI中. 取值 |
hibernate.max_fetch_depth | 为单向关联(一对一, 多对一)的外连接抓取(outer join fetch)树设置最大深度. 值为0 意味着将关闭默认的外连接抓取. 取值 建议在 |
hibernate.default_batch_fetch_size | 为Hibernate关联的批量抓取设置默认数量. 取值 建议的取值为 |
hibernate.default_entity_mode | 为由这个SessionFactory 打开的所有Session指定默认的实体表现模式. 取值 |
hibernate.order_updates | 强制Hibernate按照被更新数据的主键,为SQL更新排序。这么做将减少在高并发系统中事务的死锁。 取值 |
hibernate.generate_statistics | 如果开启, Hibernate将收集有助于性能调节的统计数据. 取值 |
hibernate.use_identifer_rollback | 如果开启, 在对象被删除时生成的标识属性将被重设为默认值. 取值 |
hibernate.use_sql_comments | 如果开启, Hibernate将在SQL中生成有助于调试的注释信息, 默认值为false . 取值 |
表 3.4. Hibernate JDBC和连接(connection)属性
属性名 | 用途 |
---|---|
hibernate.jdbc.fetch_size | 非零值,指定JDBC抓取数量的大小 (调用Statement.setFetchSize() ). |
hibernate.jdbc.batch_size | 非零值,允许Hibernate使用JDBC2的批量更新. 取值 建议取 |
hibernate.jdbc.batch_versioned_data | 如果你想让你的JDBC驱动从executeBatch() 返回正确的行计数 , 那么将此属性设为true (开启这个选项通常是安全的). 同时,Hibernate将为自动版本化的数据使用批量DML. 默认值为false . eg. |
hibernate.jdbc.factory_class | 选择一个自定义的Batcher . 多数应用程序不需要这个配置属性. eg. |
hibernate.jdbc.use_scrollable_resultset | 允许Hibernate使用JDBC2的可滚动结果集. 只有在使用用户提供的JDBC连接时,这个选项才是必要的, 否则Hibernate会使用连接的元数据. 取值 |
hibernate.jdbc.use_streams_for_binary | 在JDBC读写binary (二进制) 或serializable (可序列化) 的类型时使用流(stream)(系统级属性). 取值 |
hibernate.jdbc.use_get_generated_keys | 在数据插入数据库之后,允许使用JDBC3 PreparedStatement.getGeneratedKeys() 来获取数据库生成的key(键)。需要JDBC3+驱动和JRE1.4+, 如果你的数据库驱动在使用Hibernate的标 识生成器时遇到问题,请将此值设为false. 默认情况下将使用连接的元数据来判定驱动的能力. 取值 |
hibernate.connection.provider_class | 自定义ConnectionProvider 的类名, 此类用来向Hibernate提供JDBC连接. 取值 |
hibernate.connection.isolation | 设置JDBC事务隔离级别. 查看java.sql.Connection 来了解各个值的具体意义, 但请注意多数数据库都不支持所有的隔离级别. 取值 |
hibernate.connection.autocommit | 允许被缓存的JDBC连接开启自动提交(autocommit) (不建议). 取值 |
hibernate.connection.release_mode | 指定Hibernate在何时释放JDBC连接. 默认情况下,直到Session被显式关闭或被断开连接时,才会释放JDBC连接. 对于应用程序服务器的JTA数据源, 你应当使用after_statement , 这样在每次JDBC调用后,都会主动的释放连接. 对于非JTA的连接, 使用after_transaction 在每个事务结束时释放连接是合理的. auto 将为JTA和CMT事务策略选择after_statement , 为JDBC事务策略选择after_transaction . 取值 注意,这些设置仅对通过 |
hibernate.connection.<propertyName> | 将JDBC属性propertyName 传递到DriverManager.getConnection() 中去. |
hibernate.jndi.<propertyName> | 将属性propertyName 传递到JNDI InitialContextFactory 中去. |
属性名 | 用途 |
---|---|
hibernate.cache.provider_class | 自定义的CacheProvider 的类名. 取值 |
hibernate.cache.use_minimal_puts | 以频繁的读操作为代价, 优化二级缓存来最小化写操作. 在Hibernate3中,这个设置对的集群缓存非常有用, 对集群缓存的实现而言,默认是开启的. 取值 |
hibernate.cache.use_query_cache | 允许查询缓存, 个别查询仍然需要被设置为可缓存的. 取值 |
hibernate.cache.use_second_level_cache | 能用来完全禁止使用二级缓存. 对那些在类的映射定义中指定<cache> 的类,会默认开启二级缓存. 取值 |
hibernate.cache.query_cache_factory | 自定义实现QueryCache 接口的类名, 默认为内建的StandardQueryCache . 取值 |
hibernate.cache.region_prefix | 二级缓存区域名的前缀. 取值 |
hibernate.cache.use_structured_entries | 强制Hibernate以更人性化的格式将数据存入二级缓存. 取值 |
属性名 | 用途 |
---|---|
hibernate.transaction.factory_class | 一个TransactionFactory 的类名, 用于Hibernate Transaction API (默认为JDBCTransactionFactory ). 取值 |
jta.UserTransaction | 一个JNDI名字,被JTATransactionFactory 用来从应用服务器获取JTA UserTransaction . 取值 |
hibernate.transaction.manager_lookup_class | 一个TransactionManagerLookup 的类名 - 当使用JVM级缓存,或在JTA环境中使用hilo生成器的时候需要该类. 取值 |
hibernate.transaction.flush_before_completion | 如果开启, session在事务完成后将被自动清洗(flush)。 现在更好的方法是使用自动session上下文管理。请参见第 2.5 节 “上下文相关的(Contextual)Session”。 取值 |
hibernate.transaction.auto_close_session | 如果开启, session在事务完成后将被自动关闭。 现在更好的方法是使用自动session上下文管理。请参见第 2.5 节 “上下文相关的(Contextual)Session”。 取值 |
属性名 | 用途 |
---|---|
hibernate.current_session_context_class | 为"当前" Session 指定一个(自定义的)策略。关于内置策略的详情,请参见第 2.5 节 “上下文相关的(Contextual)Session” 。 eg. |
hibernate.query.factory_class | 选择HQL解析器的实现. 取值 |
hibernate.query.substitutions | 将Hibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字). 取值 |
hibernate.hbm2ddl.auto | 在SessionFactory 创建时,自动检查数据库结构,或者将数据库schema的DDL导出到数据库. 使用 create-drop 时,在显式关闭SessionFactory 时,将drop掉数据库schema. 取值 |
hibernate.cglib.use_reflection_optimizer | 开启CGLIB来替代运行时反射机制(系统级属性). 反射机制有时在除错时比较有用. 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在hibernate.cfg.xml 中设置此属性. 取值 |
表 3.8. Hibernate SQL方言 (hibernate.dialect
)
RDBMS | 方言 |
---|---|
DB2 | org.hibernate.dialect.DB2Dialect |
DB2 AS/400 | org.hibernate.dialect.DB2400Dialect |
DB2 OS390 | org.hibernate.dialect.DB2390Dialect |
PostgreSQL | org.hibernate.dialect.PostgreSQLDialect |
MySQL | org.hibernate.dialect.MySQLDialect |
MySQL with InnoDB | org.hibernate.dialect.MySQLInnoDBDialect |
MySQL with MyISAM | org.hibernate.dialect.MySQLMyISAMDialect |
Oracle (any version) | org.hibernate.dialect.OracleDialect |
Oracle 9i/10g | org.hibernate.dialect.Oracle9Dialect |
Sybase | org.hibernate.dialect.SybaseDialect |
Sybase Anywhere | org.hibernate.dialect.SybaseAnywhereDialect |
Microsoft SQL Server | org.hibernate.dialect.SQLServerDialect |
SAP DB | org.hibernate.dialect.SAPDBDialect |
Informix | org.hibernate.dialect.InformixDialect |
HypersonicSQL | org.hibernate.dialect.HSQLDialect |
Ingres | org.hibernate.dialect.IngresDialect |
Progress | org.hibernate.dialect.ProgressDialect |
Mckoi SQL | org.hibernate.dialect.MckoiDialect |
Interbase | org.hibernate.dialect.InterbaseDialect |
Pointbase | org.hibernate.dialect.PointbaseDialect |
FrontBase | org.hibernate.dialect.FrontbaseDialect |
Firebird | org.hibernate.dialect.FirebirdDialect |
一、 环境搭建和基本映射
1) 添加Annotation包:
hibernate-annotations.jar,ejb3-persistence.jar,hibernate-commons-annotations.jar
2) 在实体类中尽量使用JPA的标准注解来进行对象关系映射。注解可以添加在属
一、 环境搭建和基本映射
1) 添加Annotation包:
hibernate-annotations.jar,ejb3-persistence.jar,hibernate-commons-annotations.jar
2) 在实体类中尽量使用JPA的标准注解来进行对象关系映射。注解可以添加在属性上,也可以添加在getXxx()方法之上。
a) @Entity 映射一个实体类
@Table(name="表名") 指定关联的表
b) @Id 映射OID
c) @GeneratedValue(strategy=生成策略) 指定OID的生成策略。
它的默认值是GenerationType.AUTO,相当于xml时的native。
如果不使用此注解定义Id,就将使用手动指定OID值。JPA注解默认没提供uuid方式。
d) @Version 映射版本号属性(乐观锁)
e) @Column(name="列名",nullable=true,unique=true) 指定属性对应列的信息。
f) @Temporal(TemporalType.TIMESTAMP) 指定日期时间的类型。(TIMESTAMP,DATE,TIME)
g) 简单属性可以不用注解。默认就是@Basic
h) @Transient 指定属性不需要持久化.
i) 复杂属性:关联,继承,组件,联合主键.
3) 在Hibernate全局配置文件中使用声明映射类的方式:<mapping class="实体类的全限定名"/>
4) 使用Annotation来映射对象关系时,加载Hibernate全局配置文件要使用AnnotationConfiguration类,如下代码:
SessionFactory factory = new AnnotationConfiguration().configure().buildSessionFactory();
5) 持久化操作与之前没有区别。
二、映射关联关系
1. 映射多对一
1) @ManyToOne
2) 指定关联列@JoinColumn(name="xxx_id")
2. 映射一对多
1) @OneToMany 默认会使用连接表做一对多的关联。
2) 添加@JoinColumn(name="xxx_id")后,就会使用外键关联,而不使用连接表了。
3. 映射双向一对多
1) 在多端:
@ManyToOne
@JoinColumn(name="外键名")
2) 在一端:(一对多关联,把关系维护权交给多端更有效率)
@OneToMany(mappedBy="多端的关联属性名")
@JoinColumn(name="外键名")
4. mappedBy属性:用在双向关联中,把关系的维护权反转。跟hibernate XML映射中的property-ref一样。
5. cascade属性: 指定级联操作的行为(可多选)
CascadeType.PERSIST :调用JPA规范中的persist(),不适用于Hibernate的save()方法
CascadeType.MERGE:调用JPA规范中merge()时,不适用于Hibernate的update()方法
CascadeType.REMOVE:调用JPA规范中的remove()时,适用于Hibernate的delete()方法
CascadeType.REFRESH:调用JPA规范中的refresh()时,适用于Hibernate的flush()方法
CascadeType.ALL:JPA规范中的所有持久化方法。适用于Hibernate中的所有持久化方法
6. cascade属性和mappedBy用在一起时,一定要通过调用双方的set方法来建立关系。
7. 双向一对一
1) 基于外键
a) 在主控方:@OneToOne
b) 在被控方:@OneToOne(mappedBy="对方的关联属性名")
2) 基于主键: JPA标准中没有提供共享主键生成问题的标准方法,需要使用Hibernate的扩展。
a) 在主控方:Car
@Id
@GeneratedValue(generator="my-uuid")
@org.hibernate.annotations.GenericGenerator(name="my-uuid", strategy="uuid")
private String id;
@OneToOne(cascade={CascadeType.ALL})
@PrimaryKeyJoinColumn
private Brand brand;
b) 在被控方:Brand
@Id
@GeneratedValue(generator="myFG")
@org.hibernate.annotations.GenericGenerator(name="myFG",
strategy="foreign",parameters=@Parameter(name="property",value="car"))
private String id;
@OneToOne(mappedBy="brand")
private Car car;
8. 双向多对多:最好由某一端来维护这个关系会更有效率.示例:学生与课程的多对多
1) 在主控方:
@ManyToMany
@JoinTable(name="student_course",
joinColumns={@JoinColumn(name="student_id")},
inverseJoinColumns={@JoinColumn(name="course_id")})
private Set<Course> courseSet = new HashSet<Course>();
2) 在被控方:
@ManyToMany(mappedBy="courseSet")
private Set<Student> stus = new HashSet<Student>();
3) 很多情况都需要把双向多对多拆成两个一对多: 1-->*<--1
三、高级映射
1. 继承映射:
1) 整个继承树一张表
在父类中添加从下注解
@Entity
@Inheritance(strategy=InheritanceType.SINGLE_TABLE)
@DiscriminatorColumn(name="type",length=3)
@DiscriminatorValue("u")
子类中添加以下注解
@Entity
@DiscriminatorValue("w")
2) 每个子类一张表
在父类添加如下注解
@Entity
@Table(name="user")
@Inheritance(strategy=InheritanceType.JOINED)
在子类中跟普通实体类的映射相同
3) 每个具体类一张表:
在父类中
@Entity
@Inheritance(strategy=InheritanceType.TABLE_PER_CLASS)
public class User {
@Id
@GeneratedValue(strategy=GenerationType.TABLE,generator="xxGen")
@TableGenerator(name="xxGen",allocationSize=1)
private Long id;
...
}
在子类中跟普通实体类的映射相同
2. 组件映射: 组件类上用@Emabbedable。在使用这个组件类的类上用:
@Emabbed
@AttributeOverrides({
@AttributeOverride(name="email", column=@Column(name="p_email")),
@AttributeOverride(name="address", column=@Column(name="p_address")),
@AttributeOverride(name="mobile", column=@Column(name="p_mobile"))
})
3. 联合主键映射
1. 主键类:用@Emabbedable映射。并实现Serializable接口,使用主键属性重写hashCode()和equals()方法。
2. 使用这个主键类的类上还是用@Id映射。