Deprecated API

Contents

• Deprecated Classes
• Deprecated Fields
• Deprecated Methods

Deprecated Classes

org.apache.log4j.spi.RootCategory
Replaced by RootLogger.

Deprecated Fields

org.apache.log4j.varia.StringMatchFilter.ACCEPT_ON_MATCH_OPTION
Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.

org.apache.log4j.spi.LoggingEvent.categoryName
This field will be marked as private in future releases. Please do not access it directly. Use the LoggingEvent.getLoggerName() method instead.

org.apache.log4j.helpers.LogLog.CONFIG_DEBUG_KEY
Use LogLog.DEBUG_KEY instead.

org.apache.log4j.LogManager.CONFIGURATOR_CLASS_KEY
This variable is for internal use only. It will become private in future versions.

org.apache.log4j.helpers.DateLayout.DATE_FORMAT_OPTION
Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.

org.apache.log4j.Priority.DEBUG
Use Level.DEBUG instead.

org.apache.log4j.LogManager.DEFAULT_CONFIGURATION_FILE
This variable is for internal use only. It will become package protected in future versions.

org.apache.log4j.LogManager.DEFAULT_CONFIGURATION_KEY
This variable is for internal use only. It will become private in future versions.

org.apache.log4j.LogManager.DEFAULT_INIT_OVERRIDE_KEY
This variable is for internal use only. It will become private in future versions.

org.apache.log4j.Priority.ERROR
Use Level.ERROR instead.

org.apache.log4j.Priority.FATAL
Use Level.FATAL instead.

org.apache.log4j.Priority.INFO
Use Level.INFO instead.

org.apache.log4j.spi.LoggingEvent.level
This field will be marked as private in future releases. Please do not access it directly. Use the LoggingEvent.getLevel() method instead.

org.apache.log4j.HTMLLayout.LOCATION_INFO_OPTION
Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.

org.apache.log4j.varia.StringMatchFilter.STRING_TO_MATCH_OPTION
Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.

org.apache.log4j.helpers.DateLayout.TIMEZONE_OPTION
Options are now handled using the JavaBeans paradigm. This constant is not longer needed and will be removed in the near term.

org.apache.log4j.Priority.WARN
Use Level.WARN instead.

Deprecated Methods

org.apache.log4j.Category.debug(Object)
Please use Category.debug(String) method instead.

org.apache.log4j.Category.error(Object)
Please use Category.error(String) method instead.

org.apache.log4j.Category.exists(String)
Please use LogManager.exists(java.lang.String) instead.

org.apache.log4j.Category.fatal(Object)
Please use Category.fatal(String) method instead.

org.apache.log4j.Priority.getAllPossiblePriorities()
This method will be removed with no replacement.

org.apache.log4j.Category.getChainedPriority()
Please use the the Category.getEffectiveLevel() method instead.

org.apache.log4j.Hierarchy.getCurrentCategories()
Please use Hierarchy.getCurrentLoggers() instead.

org.apache.log4j.Category.getCurrentCategories()
Please use LogManager.getCurrentLoggers() instead.

org.apache.log4j.spi.LoggerRepository.getCurrentCategories()
Please use LoggerRepository.getCurrentLoggers() instead.

org.apache.log4j.Category.getDefaultHierarchy()
Please use LogManager.getLoggerRepository() instead.

org.apache.log4j.Category.getHierarchy()
Please use Category.getLoggerRepository() instead.

org.apache.log4j.Category.getInstance(Class)
Please make sure to use Logger.getLogger(Class) instead.

org.apache.log4j.Category.getInstance(String)
Make sure to use Logger.getLogger(String) instead.

org.apache.log4j.helpers.DateLayout.getOptionStrings()
Use the setter method for the option directly instead of the generic setOption method.

org.apache.log4j.varia.StringMatchFilter.getOptionStrings()
We now use JavaBeans introspection to configure components. Options strings are no longer needed.

org.apache.log4j.varia.DenyAllFilter.getOptionStrings()
We now use JavaBeans introspection to configure components. Options strings are no longer needed.

org.apache.log4j.Category.getPriority()
Please use Category.getLevel() instead.

org.apache.log4j.Category.getRoot()
Please use Logger.getRootLogger() instead.

org.apache.log4j.Category.info(Object)
Please use Category.info(String) method instead.

org.apache.log4j.Hierarchy.overrideAsNeeded(String)
Deprecated with no replacement.

org.apache.log4j.Hierarchy.setDisableOverride(String)
Deprecated with no replacement.

org.apache.log4j.helpers.DateLayout.setOption(String, String)
Use the setter method for the option directly instead of the generic setOption method.

org.apache.log4j.varia.StringMatchFilter.setOption(String, String)
Use the setter method for the option directly instead of the generic setOption method.

org.apache.log4j.varia.DenyAllFilter.setOption(String, String)
Use the setter method for the option directly instead of the generic setOption method.

org.apache.log4j.Category.setPriority(Priority)
Please use Category.setLevel(org.apache.log4j.Level) instead.

org.apache.log4j.Category.shutdown()
Please use LogManager.shutdown() instead.

org.apache.log4j.Priority.toPriority(int)
Please use the Level.toLevel(int) method instead.

org.apache.log4j.Priority.toPriority(int, Priority)
Please use the Level.toLevel(int, Level) method instead.

org.apache.log4j.Priority.toPriority(String)
Please use the Level.toLevel(String) method instead.

org.apache.log4j.Priority.toPriority(String, Priority)
Please use the Level.toLevel(String, Level) method instead.

org.apache.log4j.Category.warn(Object)
Please use Category.warn(String) method instead.