diff --git a/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/HibernateJpaSessionFactoryBean.java b/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/HibernateJpaSessionFactoryBean.java index 3942e7ba320..69d1358edbb 100644 --- a/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/HibernateJpaSessionFactoryBean.java +++ b/spring-orm/src/main/java/org/springframework/orm/jpa/vendor/HibernateJpaSessionFactoryBean.java @@ -1,5 +1,5 @@ /* - * Copyright 2002-2014 the original author or authors. + * Copyright 2002-2017 the original author or authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. @@ -34,11 +34,35 @@ import org.springframework.util.ReflectionUtils; *

Primarily available for resolving a SessionFactory by JPA persistence unit name * via the {@link #setPersistenceUnitName "persistenceUnitName"} bean property. * + *

Note that, for straightforward cases, you could also simply declare a factory method: + * + * 

+ * <bean id="sessionFactory" factory-bean="entityManagerFactory" factory-method="getSessionFactory"/>
+ *
+ * + *

And as of JPA 2.1, {@link EntityManagerFactory#unwrap} provides a nice approach as well, + * in particular within configuration class arrangements: + * + * 

+ * @Bean
+ * public SessionFactory sessionFactory(@Qualifier("entityManagerFactory") EntityManagerFactory emf) {
+ *     return emf.unwrap(SessionFactory.class);
+ * }
+ *
+ * + * Please note: Since Hibernate 5.2 changed its {@code SessionFactory} interface to extend JPA's + * {@code EntityManagerFactory}, you may get conflicts when injecting by type, with both the + * original factory and your custom {@code SessionFactory} matching {@code EntityManagerFactory}. + * An explicit qualifier for the original factory (as indicated above) is recommended here. + * * @author Juergen Hoeller * @since 3.1 * @see #setPersistenceUnitName * @see #setEntityManagerFactory + * @deprecated as of Spring Framework 4.3.12 against Hibernate 5.2, in favor of a custom solution + * based on {@link EntityManagerFactory#unwrap} with explicit qualifiers and/or primary markers */ +@Deprecated public class HibernateJpaSessionFactoryBean extends EntityManagerFactoryAccessor implements FactoryBean { @Override