11.1.1 声明 Hibernate 的 Session 工厂

使用 Hibernate 所需的主要接口是 org.hibernate.Session。Session 接口提供了基本的数据访问功能,如保存、更新、删除以及从数据库加载对象的功能。通过 Hibernate 的 Session 接口,应用程序的 Repository 能够满足所有的持久化需求。

获取 Hibernate Session 对象的标准方式是借助于 Hibernate SessionFactory 接口的实现类。除了一些其他的任务,SessionFactory 主要负责 Hibernate Session 的打开、关闭以及管理。

在 Spring 中,我们要通过 Spring 的某一个 Hibernate Session 工厂 bean 来获取 Hibernate SessionFactory。从 3.1 版本开始,Spring 提供了三个 Session 工厂 bean 供我们选择:

  • org.springframework.orm.hibernate3.LocalSessionFactoryBean

  • org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean

  • org.springframework.orm.hibernate4.LocalSessionFactoryBean

这些 Session 工厂 bean 都是 Spring FactoryBean 接口的实现,它们会产生一个 HibernateSessionFactory,它能够装配进任何 SessionFactory 类型的属性中。这样的话,就能在应用的 Spring 上下文中,与其他的 bean 一起配置 Hibernate Session 工厂。

至于选择使用哪一个 Session 工厂,这取决于使用哪个版本的 Hibernate 以及你使用 XML 还是使用注解来定义对象-数据库之间的映射关系。如果你使用 Hibernate 3.2 或更高版本(直到 Hibernate 4.0,但不包含这个版本)并且使用 XML 定义映射的话,那么你需要定义 Spring 的 org.springframework.orm.hibernate3 包中的 LocalSessionFactoryBean:

@Bean
public LocalSessionFactoryBean sessionFactory(DataSource dataSource) {
  LocalSessionFactoryBean sfb = new LocalSessionFactoryBean();
  sfb.setDataSource(dataSource);
  sfb.setMappingResource(new String[] { "Spitter.hbm.xml" });
  Properties props = new Properties();
  props.setProperty("dialect", "org.hibernate.dialect.H2Dialect");
  sfb.setHebernateProperties(props);
  return sfb;
}

在配置 LocalSessionFactoryBean 时,我们使用了三个属性。属性 dataSource 装配了一个 DataSource bean 的引用。属性 mappingResources 列出了一个或多个的 Hibernate 映射文件,在这些文件中定义了应用程序的持久化策略。最后,hibernateProperties 属性配置了 Hibernate 如何进行操作的细节。在本示例中,我们配置 Hibernate 使用 H2 数据库并且要按照 H2Dialect 来构建 SQL。

如果你更倾向于使用注解的方式来定义持久化,并且你还没有使用 Hibernate 4 的话,那么需要使用 AnnotationSessionFactoryBean 来代替 LocalSession-FactoryBean:

@Bean
public AnnotationSessionFactoryBean sessionFactory(DataSource ds) {
  AnnotationSessionFactoryBean sfb = new AnnotationSessionFactoryBean();
  sfb.setDataSource(ds);
  sfb.setMappingResource(new String[] { "Spitter.hbm.xml" });
  Properties props = new Properties();
  props.setProperty("dialect", "org.hibernate.dialect.H2Dialect");
  sfb.setHebernateProperties(props);
  return sfb;
}

如果你使用 Hibernate 4 的话,那么就应该使用org.springframework.orm. hibernate4 中的 LocalSessionFactoryBean。尽管它与 Hibernate 3 包中的 Local-SessionFactoryBean 使用了相同的名称,但是 Spring 3.1 新引入的这个 Session 工厂类似于 Hibernate 3 中 LocalSessionFactoryBean 和 AnnotationSession-FactoryBean 的结合体。它有很多相同的属性,能够支持基于 XML 的映射和基于注解的映射。如下的代码展现了如何对它进行配置,使其支持基于注解的映射:

@Bean
public LocalSessionFactoryBean sessionFactory(DataSource dataSource) {
  LocalSessionFactoryBean sfb = new LocalSessionFactoryBean();
  sfb.setDataSource(dataSource);
  sfb.setMappingResource(new String[] { "com.habuma.spittr.domain" });
  Properties props = new Properties();
  props.setProperty("dialect", "org.hibernate.dialect.H2Dialect");
  sfb.setHebernateProperties(props);
  return sfb;
}

在这两个配置中,dataSource 和 hibernateProperties 属性都声明了从哪里获取数据库连接以及要使用哪一种数据库。这里不再列出 Hibernate 配置文件,而是使用 packagesToScan 属性告诉 Spring 扫描一个或多个包以查找域类,这些类通过注解的方式表明要使用 Hibernate 进行持久化,这些类可以使用的注解包括 JPA 的 @Entity 或 @MappedSuperclass 以及 Hibernate 的 @Entity。

如果愿意的话,你还可以使用 annotatedClasses 属性来将应用程序中所有的持久化类以全限定名的方式明确列出:

sfb.setAnnotationClasses(
  new Class<?>[] { Spitter.class, Spittle.class }
);

annotatedClasses 属性对于准确指定少量的域类是不错的选择。如果你有很多的域类并且不想将其全部列出,又或者你想自由地添加或移除域类而不想修改 Spring 配置的话,那使用 packagesToScan 属性是更合适的。

在 Spring 应用上下文中配置完 Hibernate 的 Session 工厂 bean 后,那我们就可以创建自己的 Repository 类了。

Last updated