Deprecated API

Contents

• Deprecated Classes
• Deprecated Fields
• Deprecated Methods

Deprecated Classes

Class and Description
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.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

Method and Description
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.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.helpers.Loader.isJava1() with no replacement
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.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.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.