Log4j 1.3alpha-8

Deprecated API

Deprecated Classes
org.apache.log4j.helpers.AbsoluteTimeDateFormat
          use java.text.SimpleDateFormat to perform date conversion or use org.apache.log4j.helpers.CachedDateFormat to optimize high-frequency date formatting. 
org.apache.log4j.helpers.CountingQuietWriter
            
org.apache.log4j.DailyRollingFileAppender
          Replaced by RollingFileAppender 
org.apache.log4j.helpers.DateLayout
          since 1.3 
org.apache.log4j.helpers.DateTimeDateFormat
            
org.apache.log4j.varia.DenyAllFilter
          Replaced by org.apache.log4j.filters.DenyAllFilter. 
org.apache.log4j.xml.DOMConfigurator
          Replaced by the much more flexible JoranConfigurator. 
org.apache.log4j.varia.ExternallyRolledFileAppender
          version 1.3 
org.apache.log4j.varia.FallbackErrorHandler
          As of 1.3 
org.apache.log4j.helpers.FileWatchdog
          Use org.apache.log4j.watchdog.FileWatchdog instead. 
org.apache.log4j.spi.HierarchyEventListenerAdapter
            
org.apache.log4j.helpers.ISO8601DateFormat
            
org.apache.log4j.varia.LevelMatchFilter
          moved to org.apache.log4j.filter.LevelMatchFilter 
org.apache.log4j.varia.LevelRangeFilter
          moved to org.apache.log4j.filter.LevelRangeFilter 
org.apache.log4j.helpers.OnlyOnceErrorHandler
          As of 1.3 
org.apache.log4j.helpers.QuietWriter
            
org.apache.log4j.varia.Roller
          1.3 
org.apache.log4j.RollingFileAppender
          Replaced by RollingFileAppender 
org.apache.log4j.spi.RootCategory
          Replaced by RootLogger. 
org.apache.log4j.varia.StringMatchFilter
          org.apache.log4j.filter.StringMatchFilter 
org.apache.log4j.helpers.SyslogQuietWriter
            
org.apache.log4j.TTCCLayout
          Please use PatternLayout instead. 
 

Deprecated Interfaces
org.apache.log4j.spi.ErrorHandler
          As of 1.3 
org.apache.log4j.spi.HierarchyEventListener
          Superceded by LoggerEventListener. 
 

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.PatternLayout.BUF_SIZE
          since 1.3 
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
            
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
            
org.apache.log4j.AppenderSkeleton.errorHandler
          as of 1.3 
org.apache.log4j.helpers.QuietWriter.errorHandler
            
org.apache.log4j.Priority.FATAL
            
org.apache.log4j.Priority.INFO
            
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.PatternLayout.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.HTMLLayout.TITLE_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
            
 

Deprecated Methods
org.apache.log4j.config.PropertySetter.activate()
            
org.apache.log4j.Hierarchy.addHierarchyEventListener(HierarchyEventListener)
          Superceded by addLoggerEventListener 
org.apache.log4j.spi.LoggerRepository.addHierarchyEventListener(HierarchyEventListener)
          Superceded by LoggerRepositoryEx.addLoggerEventListener. 
org.apache.log4j.or.RendererMap.addRenderer(RendererSupport, String, String)
          As of release 1.3, replaced by RendererMap.addRenderer(String,String). Left here only to provide binary compatibility with 1.2.xx and will be removed in a future release. 
org.apache.log4j.FileAppender.closeFile()
          Use the super class' WriterAppender.closeWriter() method instead. 
org.apache.log4j.helpers.LogLog.error(String)
          Use Logger instead. 
org.apache.log4j.helpers.LogLog.error(String, Throwable)
          Use Logger instead. 
org.apache.log4j.Category.exists(String)
          Please use LogManager.exists(java.lang.String) instead. 
org.apache.log4j.rolling.RollingPolicyBase.getActiveFileName()
          Duplicates FileAppender.file and should be removed 
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.AppenderSkeleton.getErrorHandler()
          As of 1.3 
org.apache.log4j.Appender.getErrorHandler()
          As of 1.3 
org.apache.log4j.DailyRollingFileAppender.getErrorHandler()
          As of 1.3 
org.apache.log4j.RollingFileAppender.getErrorHandler()
          As of 1.3 
org.apache.log4j.net.SyslogAppender.getFacilityPrinting()
          No effect in log4j 1.3 
org.apache.log4j.net.SyslogAppender.getFacilityString(int)
          since 1.3 
org.apache.log4j.Category.getHierarchy()
          Please use Category.getLoggerRepository() instead. 
org.apache.log4j.Category.getInstance(Class)
          Please use Logger.getLogger(Class) instead. 
org.apache.log4j.Category.getInstance(String)
          Please use the Logger.getLogger(String) method instead. 
org.apache.log4j.net.SocketReceiver.getListener()
          This receiver now supports multiple listeners 
org.apache.log4j.spi.LoggingEvent.getMDC(String)
          use getProperty(String) instead. 
org.apache.log4j.spi.LoggingEvent.getMDCCopy()
          use initializeProperties(). 
org.apache.log4j.filter.DenyAllFilter.getOptionStrings()
          We now use JavaBeans introspection to configure components. Options strings are no longer needed. 
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.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 the Logger.getRootLogger() method instead. 
org.apache.log4j.spi.ThrowableInformation.getThrowable()
            
org.apache.log4j.AppenderSkeleton.isAsSevereAsThreshold(Priority)
            
org.apache.log4j.Category.isEnabledFor(Priority)
          Use the alternate form taking a parameter of type Level. 
org.apache.log4j.Category.log(Priority, Object)
          Use the form taking in a Level as a parameter. 
org.apache.log4j.Category.log(Priority, Object, Throwable)
          Use the form taking in a Level as a parameter. 
org.apache.log4j.Category.log(String, Priority, Object, Throwable)
          Use the form taking in a Level as a parameter. 
org.apache.log4j.MDC.put(String, Object)
          please use the MDC.put(String key, String val) form. 
org.apache.log4j.AsyncAppender.requiresLayout()
          Will be removed with no replacement. 
org.apache.log4j.WriterAppender.reset()
          Use WriterAppender.closeWriter() method instead. 
org.apache.log4j.FileAppender.reset()
            
org.apache.log4j.rolling.RollingPolicyBase.setActiveFileName(String)
          Duplicates FileAppender.file and should be removed 
org.apache.log4j.AppenderSkeleton.setErrorHandler(ErrorHandler)
          As of 1.3 
org.apache.log4j.WriterAppender.setErrorHandler(ErrorHandler)
            
org.apache.log4j.Appender.setErrorHandler(ErrorHandler)
          As of 1.3 
org.apache.log4j.DailyRollingFileAppender.setErrorHandler(ErrorHandler)
          As of 1.3 
org.apache.log4j.RollingFileAppender.setErrorHandler(ErrorHandler)
          As of 1.3 
org.apache.log4j.net.SMTPAppender.setEvaluatorClass(String)
          replaced by SMTPAppender.setEvaluator(org.apache.log4j.spi.TriggeringEventEvaluator). 
org.apache.log4j.net.SyslogAppender.setFacilityPrinting(boolean)
          No effect in log4j 1.3 
org.apache.log4j.net.SocketReceiver.setListener(SocketNodeEventListener)
          This receiver now supports multiple listeners and so this method simply removes the listener (if there already) and readds it to the list. The passed listener will also be returned via the getListener() method still, but this is also deprecated 
org.apache.log4j.net.SocketNode.setListener(SocketNodeEventListener)
          Now supports mutliple listeners, this method simply invokes the removeSocketNodeEventListener() to remove the listener, and then readds it. 
org.apache.log4j.filter.DenyAllFilter.setOption(String, String)
          Use the setter method for the option directly instead of the generic setOption method. 
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.Category.setPriority(Priority)
          Please use Category.setLevel(org.apache.log4j.Level) instead. 
org.apache.log4j.config.PropertySetter.setProperties(Object, Properties, String)
            
org.apache.log4j.helpers.LogLog.setQuietMode(boolean)
          with no replacement 
org.apache.log4j.Category.shutdown()
          Please use LogManager.shutdown() instead. 
org.apache.log4j.Priority.toPriority(int)
            
org.apache.log4j.Priority.toPriority(int, Priority)
            
org.apache.log4j.Priority.toPriority(String)
          Please use the Level.toLevel(String) method instead.} 
org.apache.log4j.Priority.toPriority(String, Priority)
            
org.apache.log4j.helpers.LogLog.warn(String)
          Use Logger instead. 
org.apache.log4j.helpers.LogLog.warn(String, Throwable)
          Use Logger instead. 
 

Deprecated Constructors
org.apache.log4j.AppenderSkeleton()
          Provided for compatibility, migrate to AppenderSkeleton(boolean) to indicate whether appender is ready upon construction. 
org.apache.log4j.helpers.CountingQuietWriter(Writer, ErrorHandler)
            
org.apache.log4j.spi.HierarchyEventListenerAdapter(HierarchyEventListener)
            
org.apache.log4j.spi.LoggingEvent(String, Category, long, Priority, Object, Throwable)
          Please use the no argument constructor and the setter methods instead. 
org.apache.log4j.helpers.QuietWriter(Writer, ErrorHandler)
            
org.apache.log4j.helpers.SyslogQuietWriter(Writer, int, ErrorHandler)
            
org.apache.log4j.WriterAppender(Layout, OutputStream)
          This constructor will be removed with no replacement in future log4j versions. 
org.apache.log4j.WriterAppender(Layout, Writer)
          This constructor will be removed with no replacement in future log4j versions 
 


Log4j 1.3alpha-8

Copyright © 2000-2006 Apache Software Foundation.
Licensed under the Apache License, Version 2.0.