org.apache.log4j

Class ConsoleAppender

java.lang.Object

org.apache.log4j.AppenderSkeleton

org.apache.log4j.WriterAppender

org.apache.log4j.ConsoleAppender

All Implemented Interfaces:

org.apache.log4j.Appender, org.apache.log4j.spi.OptionHandler

public class ConsoleAppender
extends org.apache.log4j.WriterAppender

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

Modification was done in JBoss fork to use the real stdout/stderr via FileDescriptor.out/FileDescriptor.err instead of System.out/System.err, because in some cases, the standard stream may be reassigned.

Since:

1.1

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	ConsoleAppender.SystemErrStream An implementation of OutputStream that redirects to the current System.err.
private static class	ConsoleAppender.SystemOutStream An implementation of OutputStream that redirects to the current System.out.

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	follow Determines if the appender honors reassignments of System.out or System.err made after configuration.
static java.lang.String	SYSTEM_ERR
static java.lang.String	SYSTEM_OUT
protected java.lang.String	target

Fields inherited from class org.apache.log4j.WriterAppender

encoding, immediateFlush, qw

Fields inherited from class org.apache.log4j.AppenderSkeleton

closed, errorHandler, headFilter, layout, name, tailFilter, threshold

Constructor Summary

Constructors

Constructor and Description
ConsoleAppender() Constructs an unconfigured appender.
ConsoleAppender(org.apache.log4j.Layout layout) Creates a configured appender.
ConsoleAppender(org.apache.log4j.Layout layout, java.lang.String target) Creates a configured appender.

Method Summary

Modifier and Type	Method and Description
void	activateOptions() Prepares the appender for use.
protected void	closeWriter()
private static java.io.PrintStream	createPrintStream(java.io.FileDescriptor fd)
boolean	getFollow() Gets whether the appender honors reassignments of System.out or System.err made after configuration.
java.lang.String	getTarget() Returns the current value of the Target property.
void	setFollow(boolean newValue) Sets whether the appender honors reassignments of System.out or System.err made after configuration.
void	setTarget(java.lang.String value) Sets the value of the Target option.
(package private) void	targetWarn(java.lang.String val)

Methods inherited from class org.apache.log4j.WriterAppender

append, checkEntryConditions, close, createWriter, getEncoding, getImmediateFlush, requiresLayout, reset, setEncoding, setErrorHandler, setImmediateFlush, setWriter, shouldFlush, subAppend, writeFooter, writeHeader

Methods inherited from class org.apache.log4j.AppenderSkeleton

addFilter, clearFilters, doAppend, finalize, getErrorHandler, getFilter, getFirstFilter, getLayout, getName, getThreshold, isAsSevereAsThreshold, setLayout, setName, setThreshold

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SYSTEM_OUT

public static final java.lang.String SYSTEM_OUT

See Also:

Constant Field Values

SYSTEM_ERR

public static final java.lang.String SYSTEM_ERR

See Also:

Constant Field Values

target

protected java.lang.String target

follow

private boolean follow

Determines if the appender honors reassignments of System.out or System.err made after configuration.

Constructor Detail

ConsoleAppender

public ConsoleAppender()

Constructs an unconfigured appender.

ConsoleAppender

public ConsoleAppender(org.apache.log4j.Layout layout)

Creates a configured appender.

Parameters:

layout - layout, may not be null.

ConsoleAppender

public ConsoleAppender(org.apache.log4j.Layout layout,
                       java.lang.String target)

Creates a configured appender.

Parameters:

layout - layout, may not be null.

target - target, either "System.err" or "System.out".

Method Detail

setTarget

public void setTarget(java.lang.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 java.lang.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).

setFollow

public final void setFollow(boolean newValue)

Sets whether the appender honors reassignments of System.out or System.err made after configuration.

Note: The follow value is not used and streams will always be closed and recreated if necessary.

Parameters:

newValue - if true, appender will use value of System.out or System.err in force at the time when logging events are appended.

Since:

1.2.13

getFollow

public final boolean getFollow()

Gets whether the appender honors reassignments of System.out or System.err made after configuration.

Note: The follow value is not used and streams will always be closed and recreated if necessary.

Returns:

true if appender will use value of System.out or System.err in force at the time when logging events are appended.

Since:

1.2.13

targetWarn

void targetWarn(java.lang.String val)

activateOptions

public void activateOptions()

Prepares the appender for use.

Specified by:

activateOptions in interface org.apache.log4j.spi.OptionHandler

Overrides:

activateOptions in class org.apache.log4j.WriterAppender

closeWriter

protected final void closeWriter()

Overrides:

closeWriter in class org.apache.log4j.WriterAppender

createPrintStream

private static java.io.PrintStream createPrintStream(java.io.FileDescriptor fd)