Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	Log.InternalStreamHandler Subclass of StreamHandler for redirecting log output.
private static interface	Log.LogFactory factory interface enables Logger and LogStream implementations
private static class	Log.LoggerLog Class specialized to log messages to the java.util.logging API
private static class	Log.LoggerLogFactory Factory to create Log objects which deliver log messages to the java.util.logging API.
private static class	Log.LoggerPrintStream PrintStream which forwards log messages to the logger.
private static class	Log.LogStreamLog Class specialized to log messages to the java.rmi.server.LogStream API
private static class	Log.LogStreamLogFactory Factory to create Log objects which deliver log messages to the java.rmi.server.LogStream API

Field Summary

Modifier and Type	Field and Description
public static final Level	BRIEF Logger re-definition of old RMI log values
private static final Log.LogFactory	logFactory
public static final Level	VERBOSE
private static final StackWalker	WALKER

Access	Constructor and Description
public	Log()

Method Summary

Modifier and Type	Method and Description
public static Log	getLog(String loggerName, String oldLogName, int override) Access log for a tri-state system property.
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.
public abstract PrintStream	getPrintStream()
private static StackWalker.StackFrame	getSource() Obtain stack frame of code calling a log method.
public abstract boolean	isLoggable(Level level) "logger like" API to be used by RMI implementation
public abstract void	log(Level level, String message)
public abstract void	log(Level level, String message, Throwable thrown)
public abstract void	setOutputStream(OutputStream stream) get and set the RMI server call output stream

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

Field Detail

BRIEF	back to summary
public static final Level BRIEF Logger re-definition of old RMI log values

logFactory	back to summary
private static final Log.LogFactory logFactory

VERBOSE	back to summary
public static final Level VERBOSE

WALKER	back to summary
private static final StackWalker WALKER

Log	back to summary
public Log()

Method Detail

getLog	back to summary
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.

getLog

back to summary

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.

getLog	back to summary
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.

getPrintStream	back to summary
public abstract PrintStream getPrintStream()

getSource	back to summary
private static StackWalker.StackFrame getSource() Obtain stack frame of code calling a log method.

isLoggable	back to summary
public abstract boolean isLoggable(Level level) "logger like" API to be used by RMI implementation

log	back to summary
public abstract void log(Level level, String message)

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

setOutputStream	back to summary
public abstract void setOutputStream(OutputStream stream) get and set the RMI server call output stream

sun.rmi.runtime back to summary

private Class Log.InternalStreamHandler

Class Inheritance

extends StreamHandler

java.lang.Object
java.util.logging.Handler
java.util.logging.StreamHandler
sun.rmi.runtime.Log.InternalStreamHandler

Subclass of StreamHandler for redirecting log output. flush must be called in the publish and close methods.

Constructor Summary

Access	Constructor and Description
pack-priv	InternalStreamHandler(OutputStream out)

Method Summary

Modifier and Type	Method and Description
public void	close() Overrides java.util.logging.StreamHandler.close. Close the current output stream.
public void	publish(LogRecord description of the log event. A null record is silently ignored and is not published record) Overrides java.util.logging.StreamHandler.publish. Format and publish a `LogRecord`.

Inherited from java.util.logging.StreamHandler:: flush isLoggable setEncoding setOutputStream

Constructor Detail

InternalStreamHandler	back to summary
pack-priv InternalStreamHandler(OutputStream out)

Method Detail

close back to summary

close	back to summary
public void close() Overrides java.util.logging.StreamHandler.close. Doc from java.util.logging.StreamHandler.close. Close the current output stream. The `Formatter`'s "tail" string is written to the stream before it is closed. In addition, if the `Formatter`'s "head" string has not yet been written to the stream, it will be written before the "tail" string.

public void close()

Overrides java.util.logging.StreamHandler.close.

Doc from java.util.logging.StreamHandler.close.

Close the current output stream.

The Formatter's "tail" string is written to the stream before it is closed. In addition, if the Formatter's "head" string has not yet been written to the stream, it will be written before the "tail" string.

publish back to summary

publish	back to summary
public void publish(LogRecord record) Overrides java.util.logging.StreamHandler.publish. Doc from java.util.logging.StreamHandler.publish. Format and publish a `LogRecord`. The `StreamHandler` first checks if there is an `OutputStream` and if the given `LogRecord` has at least the required log level. If not it silently returns. If so, it calls any associated `Filter` to check if the record should be published. If so, it calls its `Formatter` to format the record and then writes the result to the current output stream. If this is the first `LogRecord` to be written to a given `OutputStream`, the `Formatter`'s "head" string is written to the stream before the `LogRecord` is written. Parameters record:LogRecord description of the log event. A null record is silently ignored and is not published

public void publish(LogRecord record)

Overrides java.util.logging.StreamHandler.publish.

Doc from java.util.logging.StreamHandler.publish.

Format and publish a LogRecord.

The StreamHandler first checks if there is an OutputStream and if the given LogRecord has at least the required log level. If not it silently returns. If so, it calls any associated Filter to check if the record should be published. If so, it calls its Formatter to format the record and then writes the result to the current output stream.

If this is the first LogRecord to be written to a given OutputStream, the Formatter's "head" string is written to the stream before the LogRecord is written.

Parameters

record:LogRecord: description of the log event. A null record is silently ignored and is not published

sun.rmi.runtime back to summary

private Interface Log.LogFactory

Known Direct Implementers: sun.rmi.runtime.Log.LoggerLogFactory, sun.rmi.runtime.Log.LogStreamLogFactory

factory interface enables Logger and LogStream implementations

Method Summary

Modifier and Type	Method and Description
public Log	createLog(String loggerName, String oldLogName, Level level)

Method Detail

createLog	back to summary
public Log createLog(String loggerName, String oldLogName, Level level)

sun.rmi.runtime back to summary

private Class Log.LoggerLog

Class Inheritance

extends Log

java.lang.Object
sun.rmi.runtime.Log
sun.rmi.runtime.Log.LoggerLog

Class specialized to log messages to the java.util.logging API

Field Summary

Modifier and Type	Field and Description
private static final Handler	alternateConsole
private Log.InternalStreamHandler	copyHandler handler to which messages are copied
private final Logger	logger
private Log.LoggerPrintStream	loggerSandwich

Inherited from sun.rmi.runtime.Log:: BRIEF VERBOSE

Constructor Summary

Access	Constructor and Description
private	LoggerLog(final Logger logger, final Level level) creates a Log which will delegate to the given logger

Method Summary

Modifier and Type	Method and Description
public synchronized PrintStream	getPrintStream() Implements abstract sun.rmi.runtime.Log.getPrintStream.
public boolean	isLoggable(Level level) Implements abstract sun.rmi.runtime.Log.isLoggable. "logger like" API to be used by RMI implementation
public void	log(Level level, String message) Implements abstract sun.rmi.runtime.Log.log.
public void	log(Level level, String message, Throwable thrown) Implements abstract sun.rmi.runtime.Log.log.
public synchronized void	setOutputStream(OutputStream out) Implements abstract sun.rmi.runtime.Log.setOutputStream. Set the output stream associated with the RMI server call logger.
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.

Inherited from sun.rmi.runtime.Log:: getLog getLog

Field Detail

alternateConsole	back to summary
private static final Handler alternateConsole Annotations @SuppressWarnings:removal

copyHandler	back to summary
private Log.InternalStreamHandler copyHandler handler to which messages are copied

logger	back to summary
private final Logger logger

loggerSandwich	back to summary
private Log.LoggerPrintStream loggerSandwich

Constructor Detail

LoggerLog	back to summary
private LoggerLog(final Logger logger, final Level level) creates a Log which will delegate to the given logger Annotations @SuppressWarnings:removal

LoggerLog

back to summary

private LoggerLog(final Logger logger, final Level level)

creates a Log which will delegate to the given logger

Annotations

@SuppressWarnings:removal

Method Detail

getPrintStream	back to summary
public synchronized PrintStream getPrintStream() Implements abstract sun.rmi.runtime.Log.getPrintStream.

isLoggable	back to summary
public boolean isLoggable(Level level) Implements abstract sun.rmi.runtime.Log.isLoggable. Doc from sun.rmi.runtime.Log.isLoggable. "logger like" API to be used by RMI implementation

isLoggable

back to summary

public boolean isLoggable(Level level)

Implements abstract sun.rmi.runtime.Log.isLoggable.

Doc from sun.rmi.runtime.Log.isLoggable.

"logger like" API to be used by RMI implementation

log	back to summary
public void log(Level level, String message) Implements abstract sun.rmi.runtime.Log.log.

log	back to summary
public void log(Level level, String message, Throwable thrown) Implements abstract sun.rmi.runtime.Log.log.

setOutputStream	back to summary
public synchronized void setOutputStream(OutputStream out) Implements abstract sun.rmi.runtime.Log.setOutputStream. Set the output stream associated with the RMI server call logger. Calling code needs LoggingPermission "control".

setOutputStream

back to summary

public synchronized void setOutputStream(OutputStream out)

Implements abstract sun.rmi.runtime.Log.setOutputStream.

Set the output stream associated with the RMI server call logger. Calling code needs LoggingPermission "control".

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Satisfying this method's contract implies a non-`null` result must be returned. Returns:String a string representation of the object

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Returns:String: a string representation of the object

sun.rmi.runtime back to summary

private Class Log.LoggerLogFactory

Class Inheritance

extends Object
implements LogFactory

java.lang.Object
sun.rmi.runtime.Log.LoggerLogFactory

All Implemented Interfaces

sun.rmi.runtime.Log.LogFactory

Factory to create Log objects which deliver log messages to the java.util.logging API.

Constructor Summary

Access	Constructor and Description
pack-priv	LoggerLogFactory()

Method Summary

Modifier and Type	Method and Description
public Log	createLog(final String loggerName, String oldLogName, final Level level) Implements sun.rmi.runtime.Log.LogFactory.createLog.

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

Constructor Detail

LoggerLogFactory	back to summary
pack-priv LoggerLogFactory()

Method Detail

createLog	back to summary
public Log createLog(final String loggerName, String oldLogName, final Level level) Implements sun.rmi.runtime.Log.LogFactory.createLog.

sun.rmi.runtime back to summary

private Class Log.LoggerPrintStream

Class Inheritance

extends PrintStream

PrintStream which forwards log messages to the logger. Class is needed to maintain backwards compatibility with RemoteServer.{set|get}Log().

Field Summary

Modifier and Type	Field and Description
private final ByteArrayOutputStream	bufOut stream used for buffering lines
private int	last record the last character written to this stream
private final Logger	logger logger where output of this log is sent

Constructor Summary

Access	Constructor and Description
private	LoggerPrintStream(Logger logger)

Method Summary

Modifier and Type	Method and Description
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
public void	write(int The byte to be written b) Overrides java.io.PrintStream.write. Writes the specified byte to this stream.
public void	write(byte[] A byte array b, int Offset from which to start taking bytes off, int Number of bytes to write len) Overrides java.io.PrintStream.write. Writes `len` bytes from the specified byte array starting at offset `off` to this stream.

Field Detail

bufOut	back to summary
private final ByteArrayOutputStream bufOut stream used for buffering lines

last	back to summary
private int last record the last character written to this stream

logger	back to summary
private final Logger logger logger where output of this log is sent

Constructor Detail

LoggerPrintStream	back to summary
private LoggerPrintStream(Logger logger)

Method Detail

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Satisfying this method's contract implies a non-`null` result must be returned. Returns:String a string representation of the object

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

Returns:String: a string representation of the object

write back to summary

public void write(int b)

Overrides java.io.PrintStream.write.

Doc from java.io.PrintStream.write.

Writes the specified byte to this stream. If the byte is a newline and automatic flushing is enabled then the flush method will be invoked on the underlying output stream.

Note that the byte is written as given; to write a character that will be translated according to the default charset, use the print(char) or println(char) methods.

Parameters

b:int: The byte to be written

write back to summary

public void write(byte[] b, int off, int len)

Overrides java.io.PrintStream.write.

Doc from java.io.PrintStream.write.

Writes len bytes from the specified byte array starting at offset off to this stream. If automatic flushing is enabled then the flush method will be invoked on the underlying output stream.

Note that the bytes will be written as given; to write characters that will be translated according to the default charset, use the print(char) or println(char) methods.

Parameters

b:byte[]: A byte array
off:int: Offset from which to start taking bytes
len:int: Number of bytes to write

sun.rmi.runtime back to summary

private Class Log.LogStreamLog

Class Inheritance

extends Log

java.lang.Object
sun.rmi.runtime.Log
sun.rmi.runtime.Log.LogStreamLog

Class specialized to log messages to the java.rmi.server.LogStream API

Field Summary

Modifier and Type	Field and Description
private int	levelValue the level of the log as set by associated property
private final LogStream	stream References Deprecated `LogStream` is deprecated or references (maybe indirectly) at least one deprecated element. Log stream to which log messages are written

Inherited from sun.rmi.runtime.Log:: BRIEF VERBOSE

Constructor Summary

Access	Constructor and Description
private	LogStreamLog(LogStream stream, Level level) References Deprecated `LogStream` is deprecated or references (maybe indirectly) at least one deprecated element.

Method Summary

Modifier and Type	Method and Description
public PrintStream	getPrintStream() Implements abstract sun.rmi.runtime.Log.getPrintStream.
public synchronized boolean	isLoggable(Level level) Implements abstract sun.rmi.runtime.Log.isLoggable. "logger like" API to be used by RMI implementation
public void	log(Level messageLevel, String message) Implements abstract sun.rmi.runtime.Log.log.
public void	log(Level level, String message, Throwable thrown) Implements abstract sun.rmi.runtime.Log.log.
public synchronized void	setOutputStream(OutputStream out) Implements abstract sun.rmi.runtime.Log.setOutputStream. get and set the RMI server call output stream
private static String	unqualifiedName(String name)

Inherited from sun.rmi.runtime.Log:: getLog getLog

Field Detail

levelValue	back to summary
private int levelValue the level of the log as set by associated property

stream	back to summary
private final LogStream stream References Deprecated `LogStream` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information. Log stream to which log messages are written

Constructor Detail

LogStreamLog	back to summary
private LogStreamLog(LogStream stream, Level level) References Deprecated `LogStream` is deprecated or references (maybe indirectly) at least one deprecated element. See corresponding docs for further information.

Method Detail

getPrintStream	back to summary
public PrintStream getPrintStream() Implements abstract sun.rmi.runtime.Log.getPrintStream.

isLoggable

back to summary

public synchronized boolean isLoggable(Level level)

Implements abstract sun.rmi.runtime.Log.isLoggable.

Doc from sun.rmi.runtime.Log.isLoggable.

"logger like" API to be used by RMI implementation

log	back to summary
public void log(Level messageLevel, String message) Implements abstract sun.rmi.runtime.Log.log.

log	back to summary
public void log(Level level, String message, Throwable thrown) Implements abstract sun.rmi.runtime.Log.log.

setOutputStream

back to summary

public synchronized void setOutputStream(OutputStream out)

Implements abstract sun.rmi.runtime.Log.setOutputStream.

Doc from sun.rmi.runtime.Log.setOutputStream.

get and set the RMI server call output stream

unqualifiedName	back to summary
private static String unqualifiedName(String name)

public abstract Class Log

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class Log.InternalStreamHandler

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Interface Log.LogFactory

Method Summary

Method Detail

private Class Log.LoggerLog

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class Log.LoggerLogFactory

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class Log.LoggerPrintStream

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class Log.LogStreamLog

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class Log.LogStreamLogFactory

Constructor Summary

Method Summary

Constructor Detail

Method Detail