com.sleepycat.je.utilint

Class Tracer

java.lang.Object

com.sleepycat.je.utilint.Tracer

All Implemented Interfaces:

Loggable

public class Tracer
extends java.lang.Object
implements Loggable

The Tracer generates debug messages that are sent to the java.util.Logging facility. There are three log handlers set up for logging -- the database log itself, an output file, and stdout (the "console"). By default, only the database file is enabled.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	INFO_FILES

Constructor Summary

Constructors

Constructor and Description
Tracer() Create trace record that will be filled in from the log.
Tracer(java.lang.String msg) Create a new debug record.

Method Summary

Methods

Modifier and Type	Method and Description
void	dumpLog(java.lang.StringBuffer sb, boolean verbose) Write the object into the string buffer for log dumping.
boolean	equals(java.lang.Object obj) Override Object.equals
int	getLogSize()
java.lang.String	getMessage()
static java.lang.String	getStackTrace(java.lang.Throwable t)
long	getTransactionId()
int	hashCode() Just in case it's ever used as a hash key.
long	log(LogManager logManager) Convenience method to create a log entry containing this trace msg.
boolean	logicalEquals(Loggable other)
static java.util.logging.Level	parseLevel(EnvironmentImpl envImpl, ConfigParam configParam) Parse a logging level config parameter, and return a more explanatory error message if it doesn't parse.
void	readFromLog(java.nio.ByteBuffer itemBuffer, byte entryVersion) Initialize this object from the data in itemBuf.
java.lang.String	toString()
static void	trace(EnvironmentImpl envImpl, java.lang.String sourceClass, java.lang.String sourceMethod, java.lang.String msg, java.lang.Throwable t) Logger method for recording an exception and stacktrace.
static void	trace(java.util.logging.Level logLevel, EnvironmentImpl envImpl, java.lang.String msg) Logger method for recording a general message.
void	writeToLog(java.nio.ByteBuffer logBuffer) Serialize this object into the buffer.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

INFO_FILES

public static final java.lang.String INFO_FILES

See Also:

Constant Field Values

Constructor Detail

Tracer

public Tracer(java.lang.String msg)

Create a new debug record.

Tracer

public Tracer()

Create trace record that will be filled in from the log.

Method Detail

trace

public static void trace(java.util.logging.Level logLevel,
         EnvironmentImpl envImpl,
         java.lang.String msg)

Logger method for recording a general message.

trace

public static void trace(EnvironmentImpl envImpl,
         java.lang.String sourceClass,
         java.lang.String sourceMethod,
         java.lang.String msg,
         java.lang.Throwable t)

Logger method for recording an exception and stacktrace.

parseLevel

public static java.util.logging.Level parseLevel(EnvironmentImpl envImpl,
                                 ConfigParam configParam)
                                          throws DatabaseException

Parse a logging level config parameter, and return a more explanatory error message if it doesn't parse.

Throws:

DatabaseException

getMessage

public java.lang.String getMessage()

getStackTrace

public static java.lang.String getStackTrace(java.lang.Throwable t)

Returns:

the stacktrace for an exception

log

public long log(LogManager logManager)
         throws DatabaseException

Convenience method to create a log entry containing this trace msg.

Throws:

DatabaseException

getLogSize

public int getLogSize()

Specified by:

getLogSize in interface Loggable

Returns:

number of bytes used to store this object.

See Also:

Loggable.getLogSize()

writeToLog

public void writeToLog(java.nio.ByteBuffer logBuffer)

Description copied from interface: Loggable

Serialize this object into the buffer.

Specified by:

writeToLog in interface Loggable

Parameters:

logBuffer - is the destination buffer

See Also:

Loggable.writeToLog(java.nio.ByteBuffer)

readFromLog

public void readFromLog(java.nio.ByteBuffer itemBuffer,
               byte entryVersion)

Description copied from interface: Loggable

Initialize this object from the data in itemBuf.

Specified by:

readFromLog in interface Loggable

See Also:

Loggable.readFromLog(java.nio.ByteBuffer, byte)

dumpLog

public void dumpLog(java.lang.StringBuffer sb,
           boolean verbose)

Description copied from interface: Loggable

Write the object into the string buffer for log dumping. Each object should be dumped without indentation or new lines and should be valid XML.

Specified by:

dumpLog in interface Loggable

Parameters:

sb - destination string buffer

verbose - if true, dump the full, verbose version

See Also:

Loggable.dumpLog(java.lang.StringBuffer, boolean)

getTransactionId

public long getTransactionId()

Specified by:

getTransactionId in interface Loggable

Returns:

the transaction id embedded within this loggable object. Objects that have no transaction id should return 0.

See Also:

Loggable.getTransactionId()

logicalEquals

public boolean logicalEquals(Loggable other)

Specified by:

logicalEquals in interface Loggable

Returns:

true if these two loggable items are logically the same. Used for replication testing.

See Also:

Loggable.logicalEquals(com.sleepycat.je.log.Loggable)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Just in case it's ever used as a hash key.

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Override Object.equals

Overrides:

equals in class java.lang.Object