Hibernate是否弃用了buildSessionFactory（）配置方法

当我将Hibernate版本从3.6.8更新到4.0.0时，buildSessionFactory()在此行中收到有关过时方法的警告：

private static final SessionFactory sessionFactory =
         new Configuration().configure().buildSessionFactory();

Javadoc建议使用另一种方法

buildSessionFactory(ServiceRegistry serviceRegistry)

但是在文档中我发现不推荐使用的变体:(

这个小小的误解可以帮助我吗？

是的，已弃用。将您的SessionFactory替换为以下内容：

在Hibernate 4.0、4.1、4.2中

private static SessionFactory sessionFactory;
private static ServiceRegistry serviceRegistry;

public static SessionFactory createSessionFactory() {
    Configuration configuration = new Configuration();
    configuration.configure();
    ServiceRegistry serviceRegistry = new ServiceRegistryBuilder().applySettings(
            configuration.getProperties()). buildServiceRegistry();
    sessionFactory = configuration.buildSessionFactory(serviceRegistry);
    return sessionFactory;
}

更新：

在Hibernate 4.3中，不推荐使用 ServiceRegistryBuilder 。请改用以下内容。

serviceRegistry = new StandardServiceRegistryBuilder().applySettings(
            configuration.getProperties()).build();

是的，已弃用。 http://docs.jboss.org/hibernate/core/4.0/javadocs/org/hibernate/cfg/Configuration.html#buildSessionFactory（）专门告诉您使用找到的另一种方法（buildSessionFactory(ServiceRegistry serviceRegistry)）-因此，请使用它。

该文档在各个发行版之间进行了复制，并且可能尚未更新（它们不会在每个发行版中都重写该手册）-因此请相信Javadocs。

可以在以下位置查看此更改的详细信息：

• 源代码：https : //github.com/hibernate/hibernate-core/commit/0b10334e403cf2b11ee60725cc5619eaafecc00b
• 门票：https：//hibernate.onjira.com/browse/HHH-5991

一些其他参考：

• http://relation.to/Bloggers/HibernateCore40IsFinal
• http://relation.to/19942.lace
• http://docs.jboss.org/hibernate/core/4.0/devguide/zh-CN/html/ch07.html#services-registry
• http://sourceforge.net/apps/mediawiki/hibernate/index.php?title=类别：服务

要么

public class Hbutil {

    private static SessionFactory sessionFactory;
    private static ServiceRegistry serviceRegistry;

    private static SessionFactory configureSessionFactory() throws HibernateException {
        Configuration configuration = new Configuration();
        configuration.configure();
        serviceRegistry = new ServiceRegistryBuilder().applySettings(configuration.getProperties()).buildServiceRegistry();        
        sessionFactory = configuration.buildSessionFactory(serviceRegistry);
        return sessionFactory;
    }

    public static SessionFactory getSessionFactory() {
        return configureSessionFactory();

    }
}

验证代码可以在Hibernate 4.3.0中工作。注意，您可以删除XML文件名参数，或者在其中提供您自己的路径。这类似于此处的其他帖子（但错别字已纠正），但这是正确的。

import org.hibernate.SessionFactory;
import org.hibernate.boot.registry.StandardServiceRegistryBuilder;
import org.hibernate.cfg.Configuration;
import org.hibernate.service.ServiceRegistry;    


Configuration configuration = new Configuration();
configuration.configure("/com/rtw/test/hiber/hibernate.cfg.xml");
ServiceRegistry  serviceRegistry = new StandardServiceRegistryBuilder().applySettings(configuration.getProperties()).build();        
    sessionFactory = configuration.buildSessionFactory(serviceRegistry);

就是这么简单：JBoss文档并不是100％完美维护的。一起去的JavaDoc说什么：buildSessionFactory(ServiceRegistry serviceRegistry)。

从最新的Hibernate版本4.3.0开始，创建SessionFactory对象的更好方法如下：

Configuration configuration = new Configuration().configure();
StandardServiceRegistryBuilder builder = new StandardServiceRegistryBuilder().
applySettings(configuration.getProperties());
SessionFactory factory = configuration.buildSessionFactory(builder.build());

在不同版本的文档之间发现差异并不罕见。大多数开发人员将文档视为繁琐的工作，并且倾向于推迟文档。

根据经验，如果javadoc说了一件事，而某些非javadoc文档与此相矛盾，则javadoc可能更准确。程序员更有可能通过更改代码来使Javadoc保持最新状态……因为Javadoc的“源”与代码位于同一文件中。

对于@deprecated标签，可以肯定地确定javadoc更准确。开发人员在仔细考虑之后便弃用了这些东西……（通常来说）他们并不会弃用它们。

如果您使用的是Hibernate 5.2及更高版本，则可以使用以下代码：

  private static StandardServiceRegistry registry;
  private static SessionFactory sessionFactory;

  public static SessionFactory getSessionFactory() {
    if (sessionFactory == null) {
      try {
        // Creating a registry
        registry = new StandardServiceRegistryBuilder().configure("hibernate.cfg.xml").build();

        // Create the MetadataSources
        MetadataSources sources = new MetadataSources(registry);

        // Create the Metadata
        Metadata metadata = sources.getMetadataBuilder().build();

        // Create SessionFactory
        sessionFactory = metadata.getSessionFactoryBuilder().build();

      } catch (Exception e) {
        e.printStackTrace();
        if (registry != null) {
          StandardServiceRegistryBuilder.destroy(registry);
        }
      }
    }
    return sessionFactory;
  }

  //To shut down
 public static void shutdown() {
    if (registry != null) {
      StandardServiceRegistryBuilder.destroy(registry);
    }
  }

TL; DR

是的。有一些更好的方法来引导Hibernate，如下所示。

休眠本机引导程序

Configuration与使用BootstrapServiceRegistryBuilderHibernate 4之后引入的相比，旧版对象的功能不那么强大：

final BootstrapServiceRegistryBuilder bsrb = new BootstrapServiceRegistryBuilder()
    .enableAutoClose();

Integrator integrator = integrator();
if (integrator != null) {
    bsrb.applyIntegrator( integrator );
}

final BootstrapServiceRegistry bsr = bsrb.build();

final StandardServiceRegistry serviceRegistry = 
    new StandardServiceRegistryBuilder(bsr)
        .applySettings(properties())
        .build();

final MetadataSources metadataSources = new MetadataSources(serviceRegistry);

for (Class annotatedClass : entities()) {
    metadataSources.addAnnotatedClass(annotatedClass);
}

String[] packages = packages();
if (packages != null) {
    for (String annotatedPackage : packages) {
        metadataSources.addPackage(annotatedPackage);
    }
}

String[] resources = resources();
if (resources != null) {
    for (String resource : resources) {
        metadataSources.addResource(resource);
    }
}

final MetadataBuilder metadataBuilder = metadataSources.getMetadataBuilder()
    .enableNewIdentifierGeneratorSupport(true)
    .applyImplicitNamingStrategy(ImplicitNamingStrategyLegacyJpaImpl.INSTANCE);

final List<Type> additionalTypes = additionalTypes();
if (additionalTypes != null) {
    additionalTypes.stream().forEach(type -> {
        metadataBuilder.applyTypes((typeContributions, sr) -> {
            if(type instanceof BasicType) {
                typeContributions.contributeType((BasicType) type);
            } else if (type instanceof UserType ){
                typeContributions.contributeType((UserType) type);
            } else if (type instanceof CompositeUserType) {
                typeContributions.contributeType((CompositeUserType) type);
            }
        });
    });
}

additionalMetadata(metadataBuilder);

MetadataImplementor metadata = (MetadataImplementor) metadataBuilder.build();

final SessionFactoryBuilder sfb = metadata.getSessionFactoryBuilder();
Interceptor interceptor = interceptor();
if(interceptor != null) {
    sfb.applyInterceptor(interceptor);
}

SessionFactory sessionFactory = sfb.build();

JPA引导程序

您还可以使用JPA引导Hibernate：

PersistenceUnitInfo persistenceUnitInfo = persistenceUnitInfo(getClass().getSimpleName());
Map configuration = properties();

Interceptor interceptor = interceptor();
if (interceptor != null) {
    configuration.put(AvailableSettings.INTERCEPTOR, interceptor);
}

Integrator integrator = integrator();
if (integrator != null) {
    configuration.put(
        "hibernate.integrator_provider", 
        (IntegratorProvider) () -> Collections.singletonList(integrator));
}

EntityManagerFactoryBuilderImpl entityManagerFactoryBuilder = 
    new EntityManagerFactoryBuilderImpl(
        new PersistenceUnitInfoDescriptor(persistenceUnitInfo), 
        configuration
);
EntityManagerFactory entityManagerFactory = entityManagerFactoryBuilder.build();

这样，您将构建EntityManagerFactory而不是SessionFactory。但是，也SessionFactory扩展了EntityManagerFactory, so the actual object that's built is aSessionFactoryImpl`。

结论

这两种引导方法会影响休眠行为。使用本机引导程序时，Hibernate会以旧模式运行，该模式早于JPA。

当使用JPA引导时，Hibernate将按照JPA规范运行。

这两种模式之间存在一些差异：

• 关于本机SQL查询，自动刷新模式如何工作
• 实体代理的构建方式。传统上，Hibernate在构建Proxy时不会命中数据库，但是JPA需要抛出EntityNotFoundException，因此需要进行数据库检查。
• 是否可以删除非托管实体

有关这些差异的更多详细信息，请查看JpaCompliance课程。

public class HibernateSessionFactory {

private static final SessionFactory sessionFactory = buildSessionFactory1();

private static SessionFactory buildSessionFactory1() {
Configuration configuration = new Configuration().configure(); // configuration
                                                                // settings
                                                                // from
                                                                // hibernate.cfg.xml

StandardServiceRegistryBuilder serviceRegistryBuilder = new StandardServiceRegistryBuilder();


serviceRegistryBuilder.applySettings(configuration.getProperties());

ServiceRegistry serviceRegistry = serviceRegistryBuilder.build();

return configuration.buildSessionFactory(serviceRegistry);
}

public static SessionFactory getSessionFactory() {
return sessionFactory;
 }

public static void shutdown() {
// Close caches and connection pools
getSessionFactory().close();
 }

public void sampleConnection（）引发异常{

     Configuration cfg = new Configuration().addResource("hibernate.cfg.xml").configure();
     StandardServiceRegistryBuilder ssrb = new StandardServiceRegistryBuilder().applySettings(configuration.getProperties());
     SessionFactory sessionFactory = configuration.buildSessionFactory(ssrb.build());
     Session session = sessionFactory.openSession();
     logger.debug(" connection with the database created successfuly.");
}

我在上面编辑了batbaatar创建的方法，因此它接受Configuration对象作为参数：

    public static SessionFactory createSessionFactory(Configuration configuration) {
        serviceRegistry = new StandardServiceRegistryBuilder().applySettings(
                configuration.getProperties()).build();
        factory = configuration.buildSessionFactory(serviceRegistry);
        return factory;
    }

在主班我做了：

    private static SessionFactory factory;
    private static Configuration configuration 
    ...      
    configuration = new Configuration();
    configuration.configure().addAnnotatedClass(Employee.class);
    // Other configurations, then           
    factory = createSessionFactory(configuration);

在Hibernate 4.2.2中

import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.Transaction;
import org.hibernate.cfg.Configuration;
import org.hibernate.service.ServiceRegistry;
import org.hibernate.service.ServiceRegistryBuilder;

public class Test {
    public static void main(String[] args) throws Exception
{
    Configuration configuration = new Configuration()
            .configure();

    ServiceRegistry serviceRegistry = new ServiceRegistryBuilder().applySettings(
            configuration.getProperties()).buildServiceRegistry();

    SessionFactory sessionFactory = configuration.buildSessionFactory(serviceRegistry);

    Session session = sessionFactory.openSession();

    Transaction transaction = session.beginTransaction();

    Users users = new Users();

    ... ...

    session.save(users);

    transaction.commit();

    session.close();

    sessionFactory.close();

    }
}

Tested on 4.2.7 release

package com.national.software.hibernate;

import org.hibernate.Session;
import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;
import org.hibernate.service.ServiceRegistry;
import org.hibernate.service.ServiceRegistryBuilder;

import com.national.software.dto.UserDetails;

public class HibernateTest {

    static SessionFactory sessionFactory;

    public static void main(String[] args) {
        // TODO Auto-generated method stub

        UserDetails user = new UserDetails();
        user.setUserId(1);
        user.setUserName("user1");

        Configuration config = new Configuration();
        config.configure();

        ServiceRegistry  serviceRegistry = (ServiceRegistry) new ServiceRegistryBuilder().applySettings(config.getProperties()).buildServiceRegistry();
        sessionFactory = config.buildSessionFactory(serviceRegistry);

        Session session = sessionFactory.openSession();
        session.beginTransaction();
        session.save(user);
        session.getTransaction().commit();

    }

}

这是休眠核心框架中不推荐使用的许多API。

我们创建了如下会话工厂：

SessionFactory sessionFactory = new Configuration（）。configure（）。buildSessionFactory（）;

从休眠4版本开始不推荐使用buildSessionFactory方法，并用新的API代替。如果您使用的是Hibernate 4.3.0及更高版本，则您的代码必须为：

1. 配置配置= new Configuration（）。configure（）;

2. StandardServiceRegistryBuilder builder = new StandardServiceRegistryBuilder（）。applySettings（configuration.getProperties（））;

3. SessionFactory factory = configuration.buildSessionFactory（builder.build（））;

从4.3.0开始，将ServiceRegistryBuilder类替换为StandardServiceRegistryBuilder。看起来5.0版本中将会有很多更改。对于已弃用的API以及使用的合适替代方案，仍然没有太多的说明。每个增量版本都提供了更不推荐使用的API，它们是通过微调版本5.0的核心框架来实现的。

在中hibernate 5.3.1，您可以尝试以下操作：

ServiceRegistry standardRegistry = 
                new StandardServiceRegistryBuilder().configure().build();

Metadata sources = new MetadataSources(standardRegistry).addAnnotatedClass(MyEntity.class).getMetadataBuilder().build();

SessionFactory sf = sources.buildSessionFactory();

如果有人在更新到5.1之后在这里，它是如何工作的

StandardServiceRegistry registry = new StandardServiceRegistryBuilder().configure().build();
                MetadataSources sources = new MetadataSources(registry);
                Metadata metadata = sources.getMetadataBuilder().build();
                sessionFactory = metadata.getSessionFactoryBuilder().build();

而不是下面的休眠4.3

 ServiceRegistry serviceRegistry = new ServiceRegistryBuilder().applySettings(
            configuration.getProperties()). buildServiceRegistry();
    sessionFactory = configuration.buildSessionFactory(serviceRegistry);

只需导入以下包，

import org.hibernate.cfg.Configuration;