java.util.logging

Class ErrorManager

java.lang.Object

java.util.logging.ErrorManager

public class ErrorManager
extends Object

An error reporting facility for Handler implementations to record any error that may happen during logging. Handlers should report errors to an ErrorManager, instead of throwing exceptions, which would interfere with the log issuer's execution.

Field Summary

Fields

Modifier and Type	Field and Description
static int	CLOSE_FAILURE The error code indicating a failure when closing an output stream.
static int	FLUSH_FAILURE The error code indicating a failure when flushing an output stream.
static int	FORMAT_FAILURE The error code indicating a failure when formatting the error messages.
static int	GENERIC_FAILURE The error code indicating a failure that does not fit in any of the specific types of failures that follow.
static int	OPEN_FAILURE The error code indicating a failure when opening an output stream.
static int	WRITE_FAILURE The error code indicating a failure when writing to an output stream.

Constructor Summary

Constructors

Constructor and Description
ErrorManager() Constructs an instance of ErrorManager.

Method Summary

Modifier and Type	Method and Description
void	error(String message, Exception exception, int errorCode) Reports an error using the given message, exception and error code.

Methods inherited from class java.lang.Object

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

Field Detail

GENERIC_FAILURE

public static final int GENERIC_FAILURE

The error code indicating a failure that does not fit in any of the specific types of failures that follow.

See Also:

Constant Field Values

WRITE_FAILURE

public static final int WRITE_FAILURE

The error code indicating a failure when writing to an output stream.

See Also:

Constant Field Values

FLUSH_FAILURE

public static final int FLUSH_FAILURE

The error code indicating a failure when flushing an output stream.

See Also:

Constant Field Values

CLOSE_FAILURE

public static final int CLOSE_FAILURE

The error code indicating a failure when closing an output stream.

See Also:

Constant Field Values

OPEN_FAILURE

public static final int OPEN_FAILURE

The error code indicating a failure when opening an output stream.

See Also:

Constant Field Values

FORMAT_FAILURE

public static final int FORMAT_FAILURE

The error code indicating a failure when formatting the error messages.

See Also:

Constant Field Values

Constructor Detail

ErrorManager

public ErrorManager()

Constructs an instance of ErrorManager.

Method Detail

error

public void error(String message,
                  Exception exception,
                  int errorCode)

Reports an error using the given message, exception and error code. This implementation will write out the message to System.err on the first call and all subsequent calls are ignored. A subclass of this class should override this method.

Parameters:

message - the error message, which may be null.

exception - the exception associated with the error, which may be null.

errorCode - the error code that identifies the type of error; see the constant fields of this class for possible values.