Deprecated API

Contents

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

Deprecated Classes

Class and Description
org.apache.log4j.jmx.Agent
org.apache.log4j.spi.RootCategory Replaced by RootLogger.

Deprecated Fields

Field and Description
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.helpers.LogLog.CONFIG_DEBUG_KEY Use LogLog.DEBUG_KEY instead.
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.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.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

Method and Description
org.apache.log4j.Priority.getAllPossiblePriorities() This method will be removed with no replacement.
org.apache.log4j.Category.getChainedPriority()
org.apache.log4j.spi.NOPLogger.getChainedPriority()
org.apache.log4j.Category.getDefaultHierarchy()
org.apache.log4j.Category.getHierarchy()
org.apache.log4j.spi.NOPLogger.getHierarchy()
org.apache.log4j.varia.NullAppender.getInstance() Use getNullAppender instead. getInstance should have been static.
org.apache.log4j.Category.getInstance(Class)
org.apache.log4j.Category.getInstance(String)
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.lf5.util.DateFormatManager.getOutputFormat() Use getPattern().
org.apache.log4j.Category.getPriority()
org.apache.log4j.helpers.Loader.getResource(String, Class) as of 1.2.
org.apache.log4j.Category.getRoot()
org.apache.log4j.Hierarchy.overrideAsNeeded(String)
org.apache.log4j.lf5.viewer.categoryexplorer.CategoryNode.setAllDescendantsDeSelected()
org.apache.log4j.lf5.viewer.categoryexplorer.CategoryNode.setAllDescendantsSelected()
org.apache.log4j.Hierarchy.setDisableOverride(String)
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.lf5.util.DateFormatManager.setOutputFormat(String) Use setPattern().
org.apache.log4j.spi.NOPLogger.setPriority(Priority)
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

Constructor and Description
org.apache.log4j.jmx.Agent()