OpenJDK 27 · java.util.logging.ErrorManager · APIdia, the JavaDoc alternative

ErrorManager objects can be attached to Handlers to process any error that occurs on a Handler during Logging.

When processing logging output, if a Handler encounters problems then rather than throwing an Exception back to the issuer of the logging call (who is unlikely to be interested) the Handler should call its associated ErrorManager.

Field Summary

Modifier and Type	Field and Description
public static final int	CLOSE_FAILURE CLOSE_FAILURE is used when a close of an output stream fails.
public static final int	FLUSH_FAILURE FLUSH_FAILURE is used when a flush to an output stream fails.
public static final int	FORMAT_FAILURE FORMAT_FAILURE is used when formatting fails for any reason.
public static final int	GENERIC_FAILURE GENERIC_FAILURE is used for failure that don't fit into one of the other categories.
public static final int	OPEN_FAILURE OPEN_FAILURE is used when an open of an output stream fails.
private boolean	reported
public static final int	WRITE_FAILURE WRITE_FAILURE is used when a write to an output stream fails.

Constructor Summary

Access	Constructor and Description
public	ErrorManager() Create an `ErrorManager`.

Method Summary

Modifier and Type	Method and Description
public void	error(String a descriptive string (may be null) msg, Exception an exception (may be null) ex, int an error code defined in ErrorManager code) The error method is called when a Handler failure occurs.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

CLOSE_FAILURE	back to summary
public static final int CLOSE_FAILURE CLOSE_FAILURE is used when a close of an output stream fails.

FLUSH_FAILURE	back to summary
public static final int FLUSH_FAILURE FLUSH_FAILURE is used when a flush to an output stream fails.

FORMAT_FAILURE	back to summary
public static final int FORMAT_FAILURE FORMAT_FAILURE is used when formatting fails for any reason.

GENERIC_FAILURE	back to summary
public static final int GENERIC_FAILURE GENERIC_FAILURE is used for failure that don't fit into one of the other categories.

OPEN_FAILURE	back to summary
public static final int OPEN_FAILURE OPEN_FAILURE is used when an open of an output stream fails.

reported	back to summary
private boolean reported

WRITE_FAILURE	back to summary
public static final int WRITE_FAILURE WRITE_FAILURE is used when a write to an output stream fails.

Constructor Detail

ErrorManager	back to summary
public ErrorManager() Create an `ErrorManager`.

Method Detail

error	back to summary
public void error(String msg, Exception ex, int code) The error method is called when a Handler failure occurs. This method may be overridden in subclasses. The default behavior in this base class is that the first call is reported to System.err, and subsequent calls are ignored. Parameters msg:String a descriptive string (may be null) ex:Exception an exception (may be null) code:int an error code defined in ErrorManager

error

back to summary

public void error(String msg, Exception ex, int code)

The error method is called when a Handler failure occurs.

This method may be overridden in subclasses. The default behavior in this base class is that the first call is reported to System.err, and subsequent calls are ignored.

Parameters