Module org.glassfish.main.jul

Package org.glassfish.main.jul.handler

Class LoggingPrintStream

java.lang.Object

java.io.OutputStream

java.io.FilterOutputStream

java.io.PrintStream

org.glassfish.main.jul.handler.LoggingPrintStream

All Implemented Interfaces:

Closeable, Flushable, Appendable, AutoCloseable

public class LoggingPrintStream
extends PrintStream

LoggingPrintStream has it's own LoggingOutputStream. Once it is set as the System.out or System.err, all outputs to these PrintStreams will end up in LoggingOutputStream which will log these on a flush.

This simple behaviour has a negative side effect that stack traces are logged with each line being a new log record. The reason for above is that Throwable.printStackTrace(PrintStream) converts each line into a separate println, causing a flush at the end of each.

One option that was thought of to smooth this over was to see if the caller of println is Throwable.[some set of methods]. Unfortunately, there are others who interpose on System.out and err (like jasper) which makes that check untenable. Hence the logic currently used is to see if there is a println(Throwable) and create a standard log record of it and then prevent subsequent printline calls done by the Throwable.printStackTrace(PrintStream) method. This is possible because Throwable locks the stream to avoid collisions.

Field Summary

Fields inherited from class java.io.FilterOutputStream

out

Method Summary

Modifier and Type	Method	Description
static LoggingPrintStream	create(Logger logger, Level level, int bufferCapacity, Charset charset)
PrintStream	format(String format, Object... args)
PrintStream	format(Locale locale, String format, Object... args)
PrintStream	printf(String str, Object... args)
PrintStream	printf(Locale locale, String str, Object... args)
void	println()
void	println(Object object)
void	println(String str)
String	toString()
void	write(byte[] buf, int off, int len)

Methods inherited from class java.io.PrintStream

append, append, append, checkError, clearError, close, flush, print, print, print, print, print, print, print, print, print, println, println, println, println, println, println, println, setError, write, write, writeBytes

Methods inherited from class java.io.OutputStream

nullOutputStream

Methods inherited from class java.lang.Object

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

Method Details

create

public static LoggingPrintStream create(Logger logger,
 Level level,
 int bufferCapacity,
 Charset charset)

println

public void println(Object object)

Overrides:

println in class PrintStream

printf

public PrintStream printf(String str,
 Object... args)

Overrides:

printf in class PrintStream

printf

public PrintStream printf(Locale locale,
 String str,
 Object... args)

Overrides:

printf in class PrintStream

format

public PrintStream format(String format,
 Object... args)

Overrides:

format in class PrintStream

format

public PrintStream format(Locale locale,
 String format,
 Object... args)

Overrides:

format in class PrintStream

println

public void println()

Overrides:

println in class PrintStream

println

public void println(String str)

Overrides:

println in class PrintStream

write

public void write(byte[] buf,
 int off,
 int len)

Overrides:

write in class PrintStream

toString

public String toString()

Overrides:

toString in class Object