Deprecated API

Contents

Deprecated Interfaces

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

Deprecated Classes

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

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.AbstractOutputTarget.getFormatter()
Access to formatter is not advised and this method will be removed in future iterations.
org.apache.log.output.AbstractOutputTarget.setFormatter(Formatter)
In future this method will become protected access.
org.apache.log.output.AbstractOutputTarget.output(String)
User should overide write() instead of output().
org.apache.log.output.AbstractTarget.error(String,Throwable)
Use getErrorHandler().error(...) directly
org.apache.log.output.DefaultOutputLogTarget.initPattern()
This is no longer the recomended way to set formatter.
org.apache.log.output.DefaultOutputLogTarget.setFormat(String)
This method is unsafe as it assumes formatter is PatternFormatter and accesses a protected attribute.
org.apache.log.Hierarchy.log(String,Throwable)
Logging components should use ErrorHandler rather than Hierarchy.log()
org.apache.log.Hierarchy.log(String)
Logging components should use ErrorHandler rather than Hierarchy.log()
org.apache.log.LogEvent.getContextStack()
ContextStack has been deprecated and thus so has this method
org.apache.log.LogEvent.setContextStack(ContextStack)
ContextStack has been deprecated and thus so has this method
org.apache.log.Logger.getPriority()
This method violates Inversion of Control principle.
org.apache.log.Logger.getCategory()
This method violates Inversion of Control principle.
org.apache.log.Logger.getLogTargets()
This method is deprecated and will be removed in Future version.
org.apache.log.LogKit.getCurrentContext()
Use ContextStack.getCurrentContext() instead
org.apache.log.LogKit.getLoggerFor(String)
Use Hierarchy.getDefaultHierarchy().getLoggerFor() instead
org.apache.log.LogKit.getPriorityForName(String)
Use Priority.getPriorityForName() instead
org.apache.log.LogKit.log(String,Throwable)
Use Hierarchy.getDefaultHierarchy().log() instead
org.apache.log.LogKit.log(String)
Use Hierarchy.getDefaultHierarchy().log() instead
org.apache.log.LogKit.setDefaultLogTarget(LogTarget)
Use Hierarchy.getDefaultHierarchy().setDefaultLogTarget() instead
org.apache.log.format.PatternFormatter.getContext(ContextStack,String)
Use getContextStack rather than this method
org.apache.log.format.PatternFormatter.setFormat(String)
Parse format in via constructor rather than use this method

Deprecated Constructors

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