org.x4juli.global
Class LoggingOutputStream

java.lang.Object
  java.io.OutputStream
      org.x4juli.global.LoggingOutputStream

class LoggingOutputStream

extends java.io.OutputStream

Delegates a System.out or System.err to a logger. By default, the original output will be sent to System.out or System.err. This behavior can be turned off with care (avoiding a circle of ConsoleHandler output and LoggingOutstream input to the logging system.

Since:

0.6

Author:

Boris Unckel

Field Summary

protected byte[]	buf The internal buffer where data is stored.
private int	bufLength Remembers the size of the buffer for speed.
protected int	count The number of valid bytes in the buffer.
static int	DEFAULT_BUFFER_LENGTH The default number of bytes in the buffer. =2048
protected boolean	hasBeenClosed Used to maintain the contract of close().
protected java.util.logging.Level	level The level to use when writing to the Category.
protected java.util.logging.Logger	logger The Logger to write to.

Constructor Summary

private	LoggingOutputStream()
	LoggingOutputStream(java.util.logging.Logger logger, java.util.logging.Level level) Creates the LoggingOutputStream to flush to the given Category.

Method Summary

void	close() Closes this output stream and releases any system resources associated with this stream.
void	flush() Flushes this output stream and forces any buffered output bytes to be written out.
private void	reset()
void	write(int b) Writes the specified byte to this output stream.

Methods inherited from class java.io.OutputStream

write, write

Methods inherited from class java.lang.Object

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

Field Detail

hasBeenClosed

protected boolean hasBeenClosed

Used to maintain the contract of close().

buf

protected byte[] buf

The internal buffer where data is stored.

count

protected int count

The number of valid bytes in the buffer. This value is always in the range 0 through buf.length; elements buf[0] through buf[count-1] contain valid byte data.

bufLength

private int bufLength

Remembers the size of the buffer for speed.

DEFAULT_BUFFER_LENGTH

public static final int DEFAULT_BUFFER_LENGTH

The default number of bytes in the buffer. =2048

See Also:

Constant Field Values

logger

protected java.util.logging.Logger logger

The Logger to write to.

level

protected java.util.logging.Level level

The level to use when writing to the Category.

Constructor Detail

LoggingOutputStream

private LoggingOutputStream()

LoggingOutputStream

public LoggingOutputStream(java.util.logging.Logger logger,
                           java.util.logging.Level level)
                    throws java.lang.IllegalArgumentException

Creates the LoggingOutputStream to flush to the given Category.

Parameters:

logger - the Logger to write to

level - the Level to use when writing to the Category

Throws:

java.lang.IllegalArgumentException - if cat == null or priority == null

Method Detail

close

public void close()

Closes this output stream and releases any system resources associated with this stream. The general contract of close is that it closes the output stream. A closed stream cannot perform output operations and cannot be reopened.

write

public void write(int b)
           throws java.io.IOException

Writes the specified byte to this output stream. The general contract for write is that one byte is written to the output stream. The byte to be written is the eight low-order bits of the argument b. The 24 high-order bits of b are ignored.

Parameters:

b - the byte to write

Throws:

java.io.IOException - if an I/O error occurs. In particular, an IOException may be thrown if the output stream has been closed.

flush

public void flush()

Flushes this output stream and forces any buffered output bytes to be written out. The general contract of flush is that calling it is an indication that, if any bytes previously written have been buffered by the implementation of the output stream, such bytes should immediately be written to their intended destination.

reset

private void reset()