Deprecated API

Contents

• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Classes

org.apache.log4j.jmx.Agent

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.EnhancedPatternLayout.BUF_SIZE
since 1.3

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

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.pattern.LogEvent.level
This field will be marked as private in future releases. Please do not access it directly. Use the LogEvent.getLevel() method 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.EnhancedPatternLayout.MAX_CAPACITY
since 1.3

org.apache.log4j.spi.Filter.next
As of 1.2.12, use Filter.getNext() and Filter.setNext(org.apache.log4j.spi.Filter) instead

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.exists(String)
Please use LogManager.exists(java.lang.String) 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.Category.getCurrentCategories()
Please use LogManager.getCurrentLoggers() instead.

org.apache.log4j.Hierarchy.getCurrentCategories()
Please use Hierarchy.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.varia.NullAppender.getInstance()
Use getNullAppender instead. getInstance should have been static.

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.DenyAllFilter.getOptionStrings()
We now use JavaBeans introspection to configure components. Options strings are no longer needed.

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

org.apache.log4j.lf5.util.DateFormatManager.getOutputFormat()
Use getPattern().

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

org.apache.log4j.helpers.Loader.getResource(String, Class)
as of 1.2.

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

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

org.apache.log4j.lf5.viewer.categoryexplorer.CategoryNode.setAllDescendantsDeSelected()

org.apache.log4j.lf5.viewer.categoryexplorer.CategoryNode.setAllDescendantsSelected()

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.DenyAllFilter.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.lf5.util.DateFormatManager.setOutputFormat(String)
Use setPattern().

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.jmx.Agent.start()

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.lf5.viewer.LogBrokerMonitor.trackTableScrollPane()
tracking is now done automatically.

Deprecated Constructors

org.apache.log4j.jmx.Agent()