Czy metoda konfiguracji buildSessionFactory () jest nieaktualna w Hibernacji

Kiedy zaktualizowałem wersję Hibernacji z 3.6.8 do 4.0.0, dostałem ostrzeżenie o nieaktualnej metodzie buildSessionFactory()w tym wierszu:

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

Javadoc zaleca użycie innej metody

buildSessionFactory(ServiceRegistry serviceRegistry)

ale w dokumentacji znalazłem przestarzały wariant :(

Czy możesz mi pomóc z tym małym nieporozumieniem?

Tak, jest przestarzałe. Zamień swój SessionFactory na:

W Hibernacji 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;
}

AKTUALIZACJA:

W Hibernacji 4.3 ServiceRegistryBuilder jest przestarzały . Zamiast tego użyj następujących.

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

Tak, jest przestarzałe. http://docs.jboss.org/hibernate/core/4.0/javadocs/org/hibernate/cfg/Configuration.html#buildSessionFactory () mówi konkretnie, abyś użył innej metody, którą znalazłeś ( buildSessionFactory(ServiceRegistry serviceRegistry)) - więc użyj jej.

Dokumentacja jest kopiowana z wydania na wydanie i prawdopodobnie po prostu nie została jeszcze zaktualizowana (nie przepisują instrukcji przy każdym wydaniu) - więc zaufaj Javadocs.

Szczegóły tej zmiany można zobaczyć na:

• Kod źródłowy: https://github.com/hibernate/hibernate-core/commit/0b10334e403cf2b11ee60725cc5619eaafecc00b
• Bilet: https://hibernate.onjira.com/browse/HHH-5991

Niektóre dodatkowe odniesienia:

• http://relation.to/Bloggers/HibernateCore40IsFinal
• http://relation.to/19942.lace
• http://docs.jboss.org/hibernate/core/4.0/devguide/en-US/html/ch07.html#services-registry
• http://sourceforge.net/apps/mediawiki/hibernate/index.php?title=Category:Services

lub

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();

    }
}

Kod zweryfikowany do pracy w Hibernacji 4.3.0. Zauważ, że możesz usunąć parametr nazwy pliku XML lub podać własną ścieżkę. Jest to podobne do (ale poprawionych literówek) innych postów tutaj, ale ten jest poprawny.

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);

To takie proste: dokumenty JBoss nie są w 100% doskonale utrzymane. Idź z tego, co mówi JavaDoc : buildSessionFactory(ServiceRegistry serviceRegistry).

Lepszy sposób na utworzenie obiektu SessionFactory w najnowszej wersji hibernacji 4.3.0 i nowszej jest następujący:

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

Nie jest niczym niezwykłym znalezienie rozbieżności między różnymi wersjami dokumentacji. Większość programistów uważa dokumentację za obowiązek i odkłada ją na później.

Zasadniczo, jeśli javadoc mówi jedną rzecz, a niektóre dokumenty inne niż javadoc zaprzeczają temu, istnieje prawdopodobieństwo, że javadoc jest dokładniejszy. Programiści częściej aktualizują javadoc o zmiany w kodzie ... ponieważ „źródło” javadoc znajduje się w tym samym pliku co kod.

W przypadku @deprecatedtagów wirtualna pewność, że javadoc jest dokładniejsza. Programiści wycofują rzeczy po starannym rozważeniu ... i (ogólnie rzecz biorąc) nie cofają ich.

Jeśli używasz Hibernacji 5.2 i nowszych, możesz użyć tego:

  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

Tak to jest. Są lepsze sposoby na bootowanie Hibernacji, takie jak następujące.

Hibernacja-natywny bootstrap

Wcześniejszy Configurationobiekt jest mniej wydajny niż użycie BootstrapServiceRegistryBuilder, wprowadzonego od Hibernacji 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();

Bootstrap JPA

Możesz także uruchomić Hibernację przy użyciu JPA:

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();

W ten sposób budujesz EntityManagerFactoryzamiast SessionFactory. Jednak SessionFactoryrozszerza również EntityManagerFactory, so the actual object that's built is aSessionFactoryImpl`.

Wniosek

Te dwie metody ładowania mają wpływ na zachowanie Hibernacji. Podczas korzystania z natywnego bootstrapu Hibernacja zachowuje się w starszym trybie, który jest wcześniejszy niż JPA.

Podczas ładowania przy użyciu JPA Hibernacja będzie się zachowywać zgodnie ze specyfikacją JPA.

Istnieje kilka różnic między tymi dwoma trybami:

• Jak działa tryb AUTO flush w odniesieniu do rodzimych zapytań SQL
• Jak zbudowana jest encja Proxy. Tradycyjnie Hibernacja nie dotarła do bazy danych podczas budowania serwera proxy, ale JPA wymaga wyrzucenia EntityNotFoundException, a zatem żądania sprawdzenia bazy danych.
• czy możesz usunąć niezarządzany podmiot

Aby uzyskać więcej informacji na temat tych różnic, sprawdź JpaComplianceklasę.

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 () zgłasza wyjątek {

     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.");
}

Zredagowałem metodę utworzoną przez batbaatar powyżej, więc akceptuje obiekt Configuration jako parametr:

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

W klasie głównej zrobiłem:

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

W Hibernacji 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();

    }

}

oto wiele interfejsów API przestarzałych w hibernowanym środowisku szkieletowym.

stworzyliśmy fabrykę sesji, jak poniżej:

SessionFactory sessionFactory = new Configuration (). Configure (). BuildSessionFactory ();

Metoda buildSessionFactory jest przestarzała z wersji hibernacji 4 i została zastąpiona nowym interfejsem API. Jeśli używasz hibernacji 4.3.0 i nowszych, twój kod musi być:

1. Konfiguracja konfiguracji = nowa konfiguracja (). Config ();

2. Konstruktor StandardServiceRegistryBuilder = nowy StandardServiceRegistryBuilder (). ApplySettings (configuration.getProperties ());

3. SessionFactory factory = configuration.buildSessionFactory (builder.build ());

Klasa ServiceRegistryBuilder została zastąpiona przez StandardServiceRegistryBuilder z 4.3.0. Wygląda na to, że będzie wiele zmian w wersji 5.0. Nadal brak jest jasności w odniesieniu do przestarzałych interfejsów API i odpowiednich alternatyw do użycia. Każda wersja przyrostowa zawiera bardziej przestarzałe API, są one w stanie dopracować podstawową strukturę wydania 5.0.

W hibernate 5.3.1możesz spróbować tego:

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

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

SessionFactory sf = sources.buildSessionFactory();

Jeśli ktoś tutaj po aktualizacji do 5.1, tak to działa

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

zamiast poniżej w hibernacji 4.3

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

Wystarczy zaimportować następujący pakiet,

import org.hibernate.cfg.Configuration;