org.hibernate.internal.log

Interface DeprecationLogger

All Superinterfaces:

BasicLogger

@MessageLogger(projectCode="HHH")
 @ValidIdRange(min=90000001,
              max=90001000)
public interface DeprecationLogger
extends BasicLogger

Class to consolidate logging about usage of deprecated features.

Author:

Steve Ebersole

Field Summary

Fields

Modifier and Type	Field and Description
static String	CATEGORY
static DeprecationLogger	DEPRECATION_LOGGER

Method Summary

Modifier and Type	Method and Description
void	connectionProviderClassDeprecated(String providerClassName, String actualProviderClassName)
void	deprecatedLegacyCriteria()
void	deprecatedManyToManyFetch()
void	deprecatedManyToManyOuterJoin()
void	deprecatedSequenceGenerator(String generatorImpl)
void	deprecatedSetting(String oldSettingName, String newSettingName)
void	deprecatedTableGenerator(String generatorImpl)
void	logDeprecatedInstrumentTask(Class taskClass, Class newTaskClass)
void	logDeprecatedNamingStrategyAntArgument() Log a warning about an attempt to specify unsupported NamingStrategy
void	logDeprecatedNamingStrategyArgument() Log a warning about an attempt to specify unsupported NamingStrategy
void	logDeprecatedNamingStrategySetting(String setting, String implicitInstead, String physicalInstead) Log a warning about an attempt to specify no-longer-supported NamingStrategy
void	logDeprecatedScannerSetting() Log about usage of deprecated Scanner setting
void	logDeprecatedTransactionFactorySetting(String legacySettingName, String updatedSettingName)
void	logDeprecationOfClassEntityTypeSelector(String path)
void	logDeprecationOfCollectionPropertiesInHql(String collectionPropertyName, String alias)
void	logDeprecationOfDomEntityModeSupport() Log message indicating the use of DOM4J EntityMode.
void	logDeprecationOfEmbedXmlSupport()
void	logDeprecationOfMultipleEntityModeSupport() Log message indicating the use of multiple EntityModes for a single entity.
void	logDeprecationOfNonNamedIdAttribute(String entityName)
void	logDeprecationOfTemporaryTableBulkIdStrategy()
void	logUseOfDeprecatedConnectionHandlingSettings()
void	logUseOfDeprecatedZeroBasedJdbcStyleParams()
void	recognizedObsoleteHibernateNamespace(String oldHibernateNamespace, String hibernateNamespace)

Methods inherited from interface org.jboss.logging.BasicLogger

debug, debug, debug, debug, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugf, debugv, debugv, debugv, debugv, debugv, debugv, debugv, debugv, error, error, error, error, errorf, errorf, errorf, errorf, errorf, errorf, errorf, errorf, errorv, errorv, errorv, errorv, errorv, errorv, errorv, errorv, fatal, fatal, fatal, fatal, fatalf, fatalf, fatalf, fatalf, fatalf, fatalf, fatalf, fatalf, fatalv, fatalv, fatalv, fatalv, fatalv, fatalv, fatalv, fatalv, info, info, info, info, infof, infof, infof, infof, infof, infof, infof, infof, infov, infov, infov, infov, infov, infov, infov, infov, isDebugEnabled, isEnabled, isInfoEnabled, isTraceEnabled, log, log, log, log, logf, logf, logf, logf, logf, logf, logf, logf, logf, logf, logf, logf, logv, logv, logv, logv, logv, logv, logv, logv, logv, logv, logv, logv, trace, trace, trace, trace, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracef, tracev, tracev, tracev, tracev, tracev, tracev, tracev, tracev, warn, warn, warn, warn, warnf, warnf, warnf, warnf, warnf, warnf, warnf, warnf, warnv, warnv, warnv, warnv, warnv, warnv, warnv, warnv

Field Detail

CATEGORY

static final String CATEGORY

See Also:

Constant Field Values

DEPRECATION_LOGGER

static final DeprecationLogger DEPRECATION_LOGGER

Method Detail

logDeprecatedScannerSetting

@LogMessage(level=INFO)
 @Message(value="Found usage of deprecated setting for specifying Scanner [hibernate.ejb.resource_scanner]; use [hibernate.archive.scanner] instead",
         id=90000001)
void logDeprecatedScannerSetting()

Log about usage of deprecated Scanner setting

logDeprecationOfMultipleEntityModeSupport

@LogMessage(level=WARN)
 @Message(value="Support for an entity defining multiple entity-modes is deprecated",
         id=90000002)
void logDeprecationOfMultipleEntityModeSupport()

Log message indicating the use of multiple EntityModes for a single entity.

logDeprecationOfDomEntityModeSupport

@LogMessage(level=WARN)
 @Message(value="Use of DOM4J entity-mode is considered deprecated",
         id=90000003)
void logDeprecationOfDomEntityModeSupport()

Log message indicating the use of DOM4J EntityMode.

logDeprecationOfEmbedXmlSupport

@LogMessage(level=WARN)
 @Message(value="embed-xml attributes were intended to be used for DOM4J entity mode. Since that entity mode has been removed, embed-xml attributes are no longer supported and should be removed from mappings.",
         id=90000004)
void logDeprecationOfEmbedXmlSupport()

logDeprecationOfNonNamedIdAttribute

@LogMessage(level=WARN)
 @Message(value="Defining an entity [%s] with no physical id attribute is no longer supported; please map the identifier to a physical entity attribute",
         id=90000005)
void logDeprecationOfNonNamedIdAttribute(String entityName)

logDeprecatedNamingStrategySetting

@LogMessage(level=WARN)
 @Message(value="Attempted to specify unsupported NamingStrategy via setting [%s]; NamingStrategy has been removed in favor of the split ImplicitNamingStrategy and PhysicalNamingStrategy; use [%s] or [%s], respectively, instead.",
         id=90000006)
void logDeprecatedNamingStrategySetting(String setting,
                                                                                                                                                                                                                                                                                                                             String implicitInstead,
                                                                                                                                                                                                                                                                                                                             String physicalInstead)

Log a warning about an attempt to specify no-longer-supported NamingStrategy

Parameters:

setting - - The old setting that indicates the NamingStrategy to use

implicitInstead - - The new setting that indicates the ImplicitNamingStrategy to use

physicalInstead - - The new setting that indicates the PhysicalNamingStrategy to use

logDeprecatedNamingStrategyArgument

@LogMessage(level=WARN)
 @Message(value="Attempted to specify unsupported NamingStrategy via command-line argument [--naming]. NamingStrategy has been removed in favor of the split ImplicitNamingStrategy and PhysicalNamingStrategy; use [--implicit-naming] or [--physical-naming], respectively, instead.",
         id=90000007)
void logDeprecatedNamingStrategyArgument()

Log a warning about an attempt to specify unsupported NamingStrategy

logDeprecatedNamingStrategyAntArgument

@LogMessage(level=WARN)
 @Message(value="Attempted to specify unsupported NamingStrategy via Ant task argument. NamingStrategy has been removed in favor of the split ImplicitNamingStrategy and PhysicalNamingStrategy.",
         id=90000008)
void logDeprecatedNamingStrategyAntArgument()

Log a warning about an attempt to specify unsupported NamingStrategy

deprecatedManyToManyOuterJoin

@LogMessage(level=WARN)
 @Message(value="The outer-join attribute on <many-to-many> has been deprecated. Instead of outer-join=\"false\", use lazy=\"extra\" with <map>, <set>, <bag>, <idbag>, or <list>, which will only initialize entities (not as a proxy) as needed.",
         id=90000009)
void deprecatedManyToManyOuterJoin()

deprecatedManyToManyFetch

@LogMessage(level=WARN)
 @Message(value="The fetch attribute on <many-to-many> has been deprecated. Instead of fetch=\"select\", use lazy=\"extra\" with <map>, <set>, <bag>, <idbag>, or <list>, which will only initialize entities (not as a proxy) as needed.",
         id=90000010)
void deprecatedManyToManyFetch()

logDeprecationOfTemporaryTableBulkIdStrategy

@LogMessage(level=WARN)
 @Message(value="org.hibernate.hql.spi.TemporaryTableBulkIdStrategy (temporary) has been deprecated in favor of the more specific org.hibernate.hql.spi.id.local.LocalTemporaryTableBulkIdStrategy (local_temporary).",
         id=90000011)
void logDeprecationOfTemporaryTableBulkIdStrategy()

recognizedObsoleteHibernateNamespace

@LogMessage(level=WARN)
 @Message(value="Recognized obsolete hibernate namespace %s. Use namespace %s instead.  Support for obsolete DTD/XSD namespaces may be removed at any time.",
         id=90000012)
void recognizedObsoleteHibernateNamespace(String oldHibernateNamespace,
                                                                                                                                                                                                                                                      String hibernateNamespace)

connectionProviderClassDeprecated

@LogMessage(level=WARN)
 @Message(id=90000013,
         value="Named ConnectionProvider [%s] has been deprecated in favor of %s; that provider will be used instead.  Update your settings")
void connectionProviderClassDeprecated(String providerClassName,
                                                                                                                                                                                                                                    String actualProviderClassName)

deprecatedSequenceGenerator

@LogMessage(level=WARN)
 @Message(id=90000014,
         value="Found use of deprecated [%s] sequence-based id generator; use org.hibernate.id.enhanced.SequenceStyleGenerator instead.  See Hibernate Domain Model Mapping Guide for details.")
void deprecatedSequenceGenerator(String generatorImpl)

deprecatedTableGenerator

@LogMessage(level=WARN)
 @Message(id=90000015,
         value="Found use of deprecated [%s] table-based id generator; use org.hibernate.id.enhanced.TableGenerator instead.  See Hibernate Domain Model Mapping Guide for details.")
void deprecatedTableGenerator(String generatorImpl)

logDeprecationOfCollectionPropertiesInHql

@LogMessage(level=WARN)
 @Message(id=90000016,
         value="Found use of deprecated \'collection property\' syntax in HQL/JPQL query [%2$s.%1$s]; use collection function syntax instead [%1$s(%2$s)].")
void logDeprecationOfCollectionPropertiesInHql(String collectionPropertyName,
                                                                                                                                                                                                                                                           String alias)

logDeprecationOfClassEntityTypeSelector

@LogMessage(level=WARN)
 @Message(id=90000017,
         value="Found use of deprecated entity-type selector syntax in HQL/JPQL query [\'%1$s.class\']; use TYPE operator instead : type(%1$s)")
void logDeprecationOfClassEntityTypeSelector(String path)

logDeprecatedTransactionFactorySetting

@LogMessage(level=WARN)
 @Message(id=90000018,
         value="Found use of deprecated transaction factory setting [%s]; use the new TransactionCoordinatorBuilder settings [%s] instead")
void logDeprecatedTransactionFactorySetting(String legacySettingName,
                                                                                                                                                                                                                                       String updatedSettingName)

logDeprecatedInstrumentTask

@LogMessage(level=WARN)
 @Message(id=90000020,
         value="You are using the deprecated legacy bytecode enhancement Ant-task.  This task is left in place for a short-time to aid migrations to 5.1 and the new (vastly improved) bytecode enhancement support.  This task (%s) now delegates to thenew Ant-task (%s) leveraging that new bytecode enhancement.  You should update your build to use the new task explicitly.")
void logDeprecatedInstrumentTask(Class taskClass,
                                                                                                                                                                                                                                                                                                                                                                                                                                                                     Class newTaskClass)

deprecatedSetting

@LogMessage(level=WARN)
 @Message(id=90000021,
         value="Encountered deprecated setting [%s], use [%s] instead")
void deprecatedSetting(String oldSettingName,
                                                                                                                                              String newSettingName)

deprecatedLegacyCriteria

@LogMessage(level=WARN)
 @Message(id=90000022,
         value="Hibernate\'s legacy org.hibernate.Criteria API is deprecated; use the JPA javax.persistence.criteria.CriteriaQuery instead")
void deprecatedLegacyCriteria()

logUseOfDeprecatedConnectionHandlingSettings

@LogMessage(level=WARN)
 @Message(id=90000023,
         value="Encountered use of deprecated Connection handling settings [hibernate.connection.acquisition_mode]or [hibernate.connection.release_mode]; use [hibernate.connection.handling_mode] instead")
void logUseOfDeprecatedConnectionHandlingSettings()

logUseOfDeprecatedZeroBasedJdbcStyleParams

@LogMessage(level=WARN)
 @Message(id=90000024,
         value="Application requested zero be used as the base for JDBC-style parameters found in native-queries; this is a *temporary* backwards-compatibility setting to help applications  using versions prior to 5.3 in upgrading.  It will be removed in a later version.")
void logUseOfDeprecatedZeroBasedJdbcStyleParams()