public abstract class

Log

extends Object
java.lang.Object
   ↳ sun.rmi.runtime.Log

Class Overview

Utility which provides an abstract "logger" like RMI internal API which can be directed to use one of two types of logging infrastructure: the java.util.logging API or the java.rmi.server.LogStream API. The default behavior is to use the java.util.logging API. The LogStream API may be used instead by setting the system property sun.rmi.log.useOld to true. For backwards compatibility, supports the RMI system logging properties which pre-1.4 comprised the only way to configure RMI logging. If the java.util.logging API is used and RMI system log properties are set, the system properties override initial RMI logger values as appropriate. If the java.util.logging API is turned off, pre-1.4 logging behavior is used.

Summary

Fields
public static final Level BRIEF Logger re-definition of old RMI log values
public static final Level VERBOSE
Public Constructors
Log()
Public Methods
static Log getLog(String loggerName, String oldLogName, boolean override)
Access logs associated with boolean properties Do not call getLog multiple times on the same logger name.
static Log getLog(String loggerName, String oldLogName, int override)
Access log for a tri-state system property.
abstract PrintStream getPrintStream()
abstract boolean isLoggable(Level level)
"logger like" API to be used by RMI implementation
abstract void log(Level level, String message, Throwable thrown)
abstract void log(Level level, String message)
abstract void setOutputStream(OutputStream stream)
get and set the RMI server call output stream
[Expand]
Inherited Methods
From class java.lang.Object

Fields

public static final Level BRIEF

Logger re-definition of old RMI log values

public static final Level VERBOSE

Public Constructors

public Log ()

Public Methods

public static Log getLog (String loggerName, String oldLogName, boolean override)

Access logs associated with boolean properties Do not call getLog multiple times on the same logger name. Since this is an internal API, no checks are made to ensure that multiple logs do not exist for the same logger.

public static Log getLog (String loggerName, String oldLogName, int override)

Access log for a tri-state system property. Need to first convert override value to a log level, taking care to interpret a range of values between BRIEF, VERBOSE and SILENT. An override < 0 is interpreted to mean that the logging configuration should not be overridden. The level passed to the factories createLog method will be null in this case. Note that if oldLogName is null and old logging is on, the returned LogStreamLog will ignore the override parameter - the log will never log messages. This permits new logs that only write to Loggers to do nothing when old logging is active. Do not call getLog multiple times on the same logger name. Since this is an internal API, no checks are made to ensure that multiple logs do not exist for the same logger.

public abstract PrintStream getPrintStream ()

public abstract boolean isLoggable (Level level)

"logger like" API to be used by RMI implementation

public abstract void log (Level level, String message, Throwable thrown)

public abstract void log (Level level, String message)

public abstract void setOutputStream (OutputStream stream)

get and set the RMI server call output stream