Deprecated List (LogKit API)

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV NEXT | FRAMES NO FRAMES

## 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

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV NEXT | FRAMES NO FRAMES

Copyright © 2001 Apache Jakarta Project. All Rights Reserved.