HHH-6586 - Document metamodel package as experimental and unsupported

This commit is contained in:
Steve Ebersole 2011-08-29 18:38:16 -05:00
parent 29bce38307
commit 68f7d9b713
3 changed files with 49 additions and 6 deletions

View File

@ -156,15 +156,17 @@
* <br>
* A new <tt>Configuration</tt> will use the properties specified in
* <tt>hibernate.properties</tt> by default.
* <p/>
* NOTE : This will be replaced by use of {@link ServiceRegistryBuilder} and
* {@link org.hibernate.metamodel.MetadataSources} instead after the 4.0 release at which point this class will become
* deprecated and scheduled for removal in 5.0. See
* <a href="http://opensource.atlassian.com/projects/hibernate/browse/HHH-6183">HHH-6183</a>,
* <a href="http://opensource.atlassian.com/projects/hibernate/browse/HHH-2578">HHH-2578</a> and
* <a href="http://opensource.atlassian.com/projects/hibernate/browse/HHH-6586">HHH-6586</a> for details
*
* @author Gavin King
* @see org.hibernate.SessionFactory
*
* @deprecated use {@link ServiceRegistryBuilder} and {@link org.hibernate.metamodel.MetadataSources} instead. See
* <a href="http://opensource.atlassian.com/projects/hibernate/browse/HHH-6183">HHH-6183</a> and
* <a href="http://opensource.atlassian.com/projects/hibernate/browse/HHH-2578">HHH-2578</a> for details
*/
@Deprecated
public class Configuration implements Serializable {
private static final CoreMessageLogger LOG = Logger.getMessageLogger(CoreMessageLogger.class, Configuration.class.getName());

View File

@ -0,0 +1,36 @@
<!--
~ Hibernate, Relational Persistence for Idiomatic Java
~
~ Copyright (c) 2011, Red Hat Inc. or third-party contributors as
~ indicated by the @author tags or express copyright attribution
~ statements applied by the authors. All third-party contributions are
~ distributed under license by Red Hat Inc.
~
~ This copyrighted material is made available to anyone wishing to use, modify,
~ copy, or redistribute it subject to the terms and conditions of the GNU
~ Lesser General Public License, as published by the Free Software Foundation.
~
~ This program is distributed in the hope that it will be useful,
~ but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
~ or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
~ for more details.
~
~ You should have received a copy of the GNU Lesser General Public License
~ along with this distribution; if not, write to:
~ Free Software Foundation, Inc.
~ 51 Franklin Street, Fifth Floor
~ Boston, MA 02110-1301 USA
-->
<html>
<head></head>
<body>
<p>
<i>NOTE: This package is currently unfinished and therefore considered experimental and unsupported.</i>
</p>
<p>
This package defines the new Hibernate metamodel as well as the code used to build that metamodel from user sources
(HBM mapping files, annotations, etc).
</p>
</body>
</html>

View File

@ -122,7 +122,12 @@
*
* @author Emmanuel Bernard
*
* @deprecated See <a href="http://opensource.atlassian.com/projects/hibernate/browse/HHH-6181">HHH-6181</a> and
* @deprecated Direct usage of this class has never been supported. Instead, the application should obtain reference
* to the {@link EntityManagerFactory} as outlined in the JPA specification, section <i>7.3 Obtaining an Entity
* Manager Factory</i> based on runtime environment. Additionally this class will be removed in Hibernate release
* 5.0 for the same reasoning outlined on {@link Configuration} due to move towards new
* {@link org.hibernate.SessionFactory} building methodology. See
* <a href="http://opensource.atlassian.com/projects/hibernate/browse/HHH-6181">HHH-6181</a> and
* <a href="http://opensource.atlassian.com/projects/hibernate/browse/HHH-6159">HHH-6159</a> for details
*/
@Deprecated