加载中...
The Wayback Machine - https://sup1a9wrlpyh5li9ro.vcoronado.top/web/20090328121153/http://developer.android.com:80/reference/java/util/logging/Handler.html
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, 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.
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.
boolean isLoggable(LogRecord record)
Determines whether the supplied log record need to be logged.
abstract void publish(LogRecord record)
Accepts an actual logging request.
void setEncoding(String encoding)
Sets the character encoding used by this handler.
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 this handler.
Protected Methods
void reportError(String msg, Exception ex, int code)
Report an error to the error manager associated with this handler.
[Expand]
Inherited Methods
From class java.lang.Object

Protected Constructors

protected Handler ()

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

Public Methods

public abstract void close ()

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

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

public abstract void flush ()

Flushes any buffered output.

public String getEncoding ()

Gets the character encoding used by this handler.

Returns
  • the character encoding used by this handler

public ErrorManager getErrorManager ()

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 ()

Gets the filter used by this handler.

Returns
  • the filter used by this handler

public Formatter getFormatter ()

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

Returns
  • the formatter used by this handler

public Level getLevel ()

Gets the logging level of this handler.

Returns
  • the logging level of this handler

public boolean isLoggable (LogRecord record)

Determines whether the supplied log record need 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 need to be logged, otherwise false

public abstract void publish (LogRecord record)

Accepts an actual logging request.

Parameters
record the log record to be logged

public void setEncoding (String encoding)

Sets the character encoding used by this handler. A null value indicates the using of the 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)

Sets the error manager for this handler.

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

public void setFilter (Filter newFilter)

Sets the filter to be used by this handler.

Parameters
newFilter the filter to set
Throws
SecurityException If a security manager determines that the caller does not have the required permission.

public void setFormatter (Formatter newFormatter)

Sets the formatter to be used by this handler.

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

public void setLevel (Level newLevel)

Sets the logging level of this handler.

Parameters
newLevel the logging level to set
Throws
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)

Report an error to the error manager associated with this handler.

Parameters
msg the error message
ex the associated exception
code the error code