public abstract class

Handler

extends Object
java.lang.Object
   ↳ java.util.logging.Handler
Known Direct Subclasses
Known Indirect Subclasses

Class Overview

A Handler object accepts a logging request and exports the desired messages to a target, for example, a file, the console, etc. It can be disabled by setting its logging level to Level.OFF.

Summary

Protected Constructors
Handler()
Constructs a Handler object with a default error manager instance ErrorManager, the default encoding, and the default logging level Level.ALL.
Public Methods
abstract void close()
Closes this handler.
abstract void flush()
Flushes any buffered output.
String getEncoding()
Gets the character encoding used by this handler, null for default encoding.
ErrorManager getErrorManager()
Gets the error manager used by this handler to report errors during logging.
Filter getFilter()
Gets the filter used by this handler.
Formatter getFormatter()
Gets the formatter used by this handler to format the logging messages.
Level getLevel()
Gets the logging level of this handler, records with levels lower than this value will be dropped.
boolean isLoggable(LogRecord record)
Determines whether the supplied log record needs to be logged.
abstract void publish(LogRecord record)
Accepts a logging request and sends it to the the target.
void setEncoding(String encoding)
Sets the character encoding used by this handler, null indicates a default encoding.
void setErrorManager(ErrorManager em)
Sets the error manager for this handler.
void setFilter(Filter newFilter)
Sets the filter to be used by this handler.
void setFormatter(Formatter newFormatter)
Sets the formatter to be used by this handler.
void setLevel(Level newLevel)
Sets the logging level of the messages logged by this handler, levels lower than this value will be dropped.
Protected Methods
void reportError(String msg, Exception ex, int code)
Reports an error to the error manager associated with this handler, ErrorManager is used for that purpose.
[Expand]
Inherited Methods
From class java.lang.Object

Protected Constructors

protected Handler ()

Since: API Level 1

Constructs a Handler object with a default error manager instance ErrorManager, the default encoding, and the default logging level Level.ALL. It has no filter and no formatter.

Public Methods

public abstract void close ()

Since: API Level 1

Closes this handler. A flush operation will be performed and all the associated resources will be freed. Client applications should not use this handler after closing it.

Throws
SecurityException if a security manager determines that the caller does not have the required permission.

public abstract void flush ()

Since: API Level 1

Flushes any buffered output.

public String getEncoding ()

Since: API Level 1

Gets the character encoding used by this handler, null for default encoding.

Returns
  • the character encoding used by this handler.

public ErrorManager getErrorManager ()

Since: API Level 1

Gets the error manager used by this handler to report errors during logging.

Returns
  • the error manager used by this handler.
Throws
SecurityException if a security manager determines that the caller does not have the required permission.

public Filter getFilter ()

Since: API Level 1

Gets the filter used by this handler.

Returns
  • the filter used by this handler (possibly null).

public Formatter getFormatter ()

Since: API Level 1

Gets the formatter used by this handler to format the logging messages.

Returns
  • the formatter used by this handler (possibly null).

public Level getLevel ()

Since: API Level 1

Gets the logging level of this handler, records with levels lower than this value will be dropped.

Returns
  • the logging level of this handler.

public boolean isLoggable (LogRecord record)

Since: API Level 1

Determines whether the supplied log record needs to be logged. The logging levels will be checked as well as the filter.

Parameters
record the log record to be checked.
Returns
  • true if the supplied log record needs to be logged, otherwise false.

public abstract void publish (LogRecord record)

Since: API Level 1

Accepts a logging request and sends it to the the target.

Parameters
record the log record to be logged; null records are ignored.

public void setEncoding (String encoding)

Since: API Level 1

Sets the character encoding used by this handler, null indicates a default encoding.

Parameters
encoding the character encoding to set.
Throws
SecurityException if a security manager determines that the caller does not have the required permission.
UnsupportedEncodingException if the specified encoding is not supported by the runtime.

public void setErrorManager (ErrorManager em)

Since: API Level 1

Sets the error manager for this handler.

Parameters
em the error manager to set.
Throws
NullPointerException if em is null.
SecurityException if a security manager determines that the caller does not have the required permission.

public void setFilter (Filter newFilter)

Since: API Level 1

Sets the filter to be used by this handler.

Parameters
newFilter the filter to set, may be null.
Throws
SecurityException if a security manager determines that the caller does not have the required permission.

public void setFormatter (Formatter newFormatter)

Since: API Level 1

Sets the formatter to be used by this handler.

Parameters
newFormatter the formatter to set.
Throws
NullPointerException if newFormatter is null.
SecurityException if a security manager determines that the caller does not have the required permission.

public void setLevel (Level newLevel)

Since: API Level 1

Sets the logging level of the messages logged by this handler, levels lower than this value will be dropped.

Parameters
newLevel the logging level to set.
Throws
NullPointerException if newLevel is null.
SecurityException if a security manager determines that the caller does not have the required permission.

Protected Methods

protected void reportError (String msg, Exception ex, int code)

Since: API Level 1

Reports an error to the error manager associated with this handler, ErrorManager is used for that purpose. No security checks are done, therefore this is compatible with environments where the caller is non-privileged.

Parameters
msg the error message, may be null.
ex the associated exception, may be null.
code an ErrorManager error code.