Log4j 1.3alpha-7

org.apache.log4j
Class ConsoleAppender

java.lang.Object
  extended byorg.apache.log4j.spi.ComponentBase
      extended byorg.apache.log4j.AppenderSkeleton
          extended byorg.apache.log4j.WriterAppender
              extended byorg.apache.log4j.ConsoleAppender
All Implemented Interfaces:
Appender, Component, OptionHandler

public class ConsoleAppender
extends WriterAppender

ConsoleAppender appends log events to System.out or System.err using a layout specified by the user. The default target is System.out.

Since:
1.1
Author:
Ceki Gülcü, Curt Arnold

Field Summary
static String SYSTEM_ERR
           
static String SYSTEM_OUT
           
protected  String target
           
 
Fields inherited from class org.apache.log4j.WriterAppender
encoding, immediateFlush, writer
 
Fields inherited from class org.apache.log4j.AppenderSkeleton
active, closed, headFilter, layout, name, tailFilter, threshold
 
Fields inherited from class org.apache.log4j.spi.ComponentBase
repository
 
Constructor Summary
ConsoleAppender()
          Constructs an unconfigured appender.
ConsoleAppender(Layout layout)
          Creates a configured appender.
ConsoleAppender(Layout layout, String targetStr)
          Creates a configured appender.
 
Method Summary
 void activateOptions()
          Prepares the appender for use.
protected  void closeWriter()
          Close the underlying Writer.
 String getTarget()
          Returns the current value of the Target property.
 void setTarget(String value)
          Sets the value of the Target option.
 
Methods inherited from class org.apache.log4j.WriterAppender
append, checkEntryConditions, close, createWriter, getEncoding, getImmediateFlush, setEncoding, setImmediateFlush, setWriter, subAppend, writeFooter, writeHeader, xreset
 
Methods inherited from class org.apache.log4j.AppenderSkeleton
addFilter, clearFilters, doAppend, finalize, getErrorHandler, getFilter, getFirstFilter, getLayout, getName, getThreshold, isActive, isAsSevereAsThreshold, isClosed, setErrorHandler, setLayout, setName, setThreshold
 
Methods inherited from class org.apache.log4j.spi.ComponentBase
getLogger, getLoggerRepository, getNonFloodingLogger, resetErrorCount, setLoggerRepository
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.apache.log4j.Appender
setLoggerRepository
 

Field Detail

SYSTEM_OUT

public static final String SYSTEM_OUT
See Also:
Constant Field Values

SYSTEM_ERR

public static final String SYSTEM_ERR
See Also:
Constant Field Values

target

protected String target
Constructor Detail

ConsoleAppender

public ConsoleAppender()
Constructs an unconfigured appender.


ConsoleAppender

public ConsoleAppender(Layout layout)
Creates a configured appender.

Parameters:
layout - layout, may not be null.

ConsoleAppender

public ConsoleAppender(Layout layout,
                       String targetStr)
Creates a configured appender.

Parameters:
layout - layout, may not be null.
targetStr - target, either "System.err" or "System.out".
Method Detail

setTarget

public void setTarget(String value)
Sets the value of the Target option. Recognized values are "System.out" and "System.err". Any other value will be ignored.


getTarget

public String getTarget()
Returns the current value of the Target property. The default value of the option is "System.out". See also setTarget(java.lang.String).


activateOptions

public void activateOptions()
Prepares the appender for use.

Specified by:
activateOptions in interface OptionHandler
Overrides:
activateOptions in class WriterAppender

closeWriter

protected final void closeWriter()
Close the underlying Writer.

Overrides:
closeWriter in class WriterAppender

Log4j 1.3alpha-7

Copyright 2000-2005 Apache Software Foundation.