Deprecated API

Deprecated Classes
org.apache.log.format.AvalonFormatter
          Use org.apache.avalon.framework.logger.AvalonFormatter instead of this one. 
org.apache.log.ContextStack
          This class has been deprecated as it encouraged use of bad design practices. Use org.apache.log.ContextMap instead. 
org.apache.log.output.DatagramOutputTarget
          Use org.apache.log.output.net.DatagramOutputTarget instead 
org.apache.log.output.DefaultOutputLogTarget
          Use org.apache.log.output.io.WriterTarget or org.apache.log.output.io.StreamTarget as appropriate as this class encourages unsafe behaviour 
org.apache.log.output.FileOutputLogTarget
          Use org.apache.log.output.io.FileTarget as this class is not thread safe 
org.apache.log.LogKit
          Instead of using LogKit directly use the facilities in code itself 
org.apache.log.util.OutputStreamLogger
          Use LoggerOutputStream as this class was misnamed. 
 

Deprecated Interfaces
org.apache.log.FilterTarget
          Interface offered no significant advantage and thus will no longer be used by new interfaces 
org.apache.log.Formatter
          Use org.apache.log.format.Formatter instead. 
 

Deprecated Fields
org.apache.log.output.AbstractOutputTarget.m_formatter
          You should not be directly accessing this attribute as it will become private next release 
org.apache.log.output.io.WriterTarget.m_output
          Accessing this variable in subclasses is no longer supported and will become private in the future. 
 

Deprecated Methods
org.apache.log.output.AbstractTarget.error(String, Throwable)
          Use getErrorHandler().error(...) directly 
org.apache.log.Logger.getCategory()
          This method violates Inversion of Control principle. If you are relying on its presence then there may be something wrong with the design of your system 
org.apache.log.format.PatternFormatter.getContext(ContextStack, String)
          Use getContextStack rather than this method 
org.apache.log.LogEvent.getContextStack()
          ContextStack has been deprecated and thus so has this method 
org.apache.log.LogKit.getCurrentContext()
          Use ContextStack.getCurrentContext() instead 
org.apache.log.output.AbstractOutputTarget.getFormatter()
          Access to formatter is not advised and this method will be removed in future iterations. It remains only for backwards compatability. 
org.apache.log.LogKit.getLoggerFor(String)
          Use Hierarchy.getDefaultHierarchy().getLoggerFor() instead 
org.apache.log.Logger.getLogTargets()
          This method is deprecated and will be removed in Future version. Previously it allowed unsafe access to logtargets which permitted masqurade attacks. It currently returns a zero sized array. 
org.apache.log.Logger.getPriority()
          This method violates Inversion of Control principle. It will downgraded to protected access in a future release. When user needs to check priority it is advised that they use the is[Priority]Enabled() functions. 
org.apache.log.LogKit.getPriorityForName(String)
          Use Priority.getPriorityForName() instead 
org.apache.log.output.DefaultOutputLogTarget.initPattern()
          This is no longer the recomended way to set formatter. It is recomended that it be passed into constructor. 
org.apache.log.LogKit.log(String)
          Use Hierarchy.getDefaultHierarchy().log() instead 
org.apache.log.Hierarchy.log(String)
          Logging components should use ErrorHandler rather than Hierarchy.log() 
org.apache.log.LogKit.log(String, Throwable)
          Use Hierarchy.getDefaultHierarchy().log() instead 
org.apache.log.Hierarchy.log(String, Throwable)
          Logging components should use ErrorHandler rather than Hierarchy.log() 
org.apache.log.output.AbstractOutputTarget.output(String)
          User should overide write() instead of output(). Output exists for backwards compatability and will be removed in future. 
org.apache.log.LogEvent.setContextStack(ContextStack)
          ContextStack has been deprecated and thus so has this method 
org.apache.log.LogKit.setDefaultLogTarget(LogTarget)
          Use Hierarchy.getDefaultHierarchy().setDefaultLogTarget() instead 
org.apache.log.format.PatternFormatter.setFormat(String)
          Parse format in via constructor rather than use this method 
org.apache.log.output.DefaultOutputLogTarget.setFormat(String)
          This method is unsafe as it assumes formatter is PatternFormatter and accesses a protected attribute. Instead of calling this method It is recomended that a fully configured formatter is passed into constructor. 
org.apache.log.output.AbstractOutputTarget.setFormatter(Formatter)
          In future this method will become protected access. 
 

Deprecated Constructors
org.apache.log.util.OutputStreamLogger(Logger, Priority)
          Use LoggerOutputStream as this class was misnamed. 
org.apache.log.format.PatternFormatter()
          Use constructor PatternFormatter(String pattern) as this does not correctly initialize object 
 



Copyright © 2001 Apache Jakarta Project. All Rights Reserved.