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