Est buildSessionFactory() déconseillée dans la mise en veille prolongée 4 ?

Question

Lorsque j'ai mis à jour la version d'Hibernate de 3.6.8.finale de la 4.0.0.final j'ai obtenu un message d'avertissement à propos de méthode dépréciée buildSessionFactory() dans cette ligne:

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

la javadoc recommande l'utilisation d'une autre méthode

buildSessionFactory(ServiceRegistry serviceRegistry)

mais dans la documentation , j'ai trouvé obsolète variante :(

Pouvez-vous m'aider avec ce petit malentendu ?

Answer 1

Oui, il est déconseillé. Remplacez votre SessionFactory par ce qui suit :

Dans la mise en veille prolongée 4.0, 4.1, 4.2

MISE À JOUR :

ServiceRegistryBuilder 4.3 mise en veille prolongée est déconseillée. Utilisez ce qui suit.

Answer 2

Oui, c'est déconseillé. http://docs.jboss.org/hibernate/core/4.0/javadocs/org/hibernate/cfg/Configuration.html#buildSessionFactory() plus précisément indique d'utiliser l'autre méthode que vous avez trouvé à la place (buildSessionFactory(ServiceRegistry serviceRegistry)) - afin de l'utiliser.

La documentation est copié à partir d'une version à une autre, et probablement n'a pas encore été mis à jour (ils ne sont pas réécrire le manuel pour chaque version) - alors faites confiance à la Javadoc.

Les détails de cette modification, peuvent être consultés à:

• Code Source: https://github.com/hibernate/hibernate-core/commit/0b10334e403cf2b11ee60725cc5619eaafecc00b
• Billet: https://hibernate.onjira.com/browse/HHH-5991

Quelques références supplémentaires:

• 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

Answer 3

ou

Answer 4

C’est aussi simple que cela : les docs de JBoss ne sont pas 100 % parfaitement bien entretenu. Aller avec ce que dit la JavaDoc: `` .

Answer 5

Il n'est pas rare de constater des écarts entre les différentes versions de la documentation. La plupart des développeurs de vue de la documentation comme une corvée, et ils ont tendance à le mettre hors tension.

En règle générale, si la javadoc dit une chose et certains non-javadoc de la documentation contredit, les chances sont que la javadoc est plus précis. Les programmeurs sont plus susceptibles de garder la javadoc à jour avec les modifications au code ... parce que la "source" de la javadoc est dans le même fichier que le code.

Dans le cas d' @deprecated tags, c'est une quasi certitude que la javadoc est plus précis. Les développeurs de rendre caduque les choses après un examen attentif ... et ils n'ont pas undeprecate.