com.novell.nds.dirxml.shimhost

Class FileTraceImpl

java.lang.Object

com.novell.nds.dirxml.shimhost.FileTraceImpl

All Implemented Interfaces:

TraceInterface

public class FileTraceImpl
extends java.lang.Object

An implementation of com.novell.nds.dirxml.driver.TraceInterface that can be registered with the com.novell.nds.dirxml.driver.Trace class.

Trace messages are output to a file specified via the setFile() method.

See Also:

Trace.registerImpl(java.lang.Class, double)

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String	DEFAULT_TIME_FORMAT Default timestamp formatting string to use: "[MM/dd/yy HH:mm:ss.SS]: "
protected static LocalizedMessageSource	messageSource Source of localized message strings
protected static java.io.PrintStream	printStream
protected static java.lang.String	TAB String used for indenting XML documents
protected static java.text.SimpleDateFormat	timeFormat Time formatter for timestamps.
protected static java.lang.String	timeFormatString Time format string for timestamps.
protected static java.lang.String	TRACE_TIMEFORMAT
protected static int	traceLevel

Constructor Summary

Constructors

Constructor and Description
FileTraceImpl() Construct an instance.

Method Summary

Modifier and Type	Method and Description
int	getLevel() Return the current trace level.
static void	setFile(java.io.File file) Set the file to use for this class.
static void	setFile(java.lang.String filename) Set the file name to use for this class.
static void	setLevel(int newLevel) Set the trace level for this class.
protected static java.lang.String	timeStampMessage(java.lang.String message) Prepend a timestamp to a String and return the result.
void	trace(int color, int level, java.lang.String message) Output a message string if the passed level is greater than or equal to the current trace level.
void	trace(int level, java.lang.String message) Output a message string if the passed level is greater than or equal to the current trace level.
void	trace(int level, XmlDocument document) Serialize and output XML document if passed level is greater than or equal to the current trace level.
protected void	traceAlways(org.w3c.dom.Document document) Output an XML Document regardless of level
protected void	traceAlways(java.lang.String message) Output a message regardless of level.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

printStream

protected static java.io.PrintStream printStream

traceLevel

protected static int traceLevel

TAB

protected static final java.lang.String TAB

String used for indenting XML documents

See Also:

Constant Field Values

messageSource

protected static LocalizedMessageSource messageSource

Source of localized message strings

timeFormatString

protected static java.lang.String timeFormatString

Time format string for timestamps.

timeFormat

protected static java.text.SimpleDateFormat timeFormat

Time formatter for timestamps.

DEFAULT_TIME_FORMAT

protected static final java.lang.String DEFAULT_TIME_FORMAT

Default timestamp formatting string to use: "[MM/dd/yy HH:mm:ss.SS]: "

See Also:

Constant Field Values

TRACE_TIMEFORMAT

protected static final java.lang.String TRACE_TIMEFORMAT

See Also:

Constant Field Values

Constructor Detail

FileTraceImpl

public FileTraceImpl()

Construct an instance. This is designed to be called by the com.novell.nds.dirxml.driver.Trace class.

See Also:

Trace.registerImpl(java.lang.Class, double)

Method Detail

setFile

public static void setFile(java.io.File file)
                    throws java.io.IOException

Set the file to use for this class. This must be performed before the com.novell.nds.dirxml.driver.Trace class creates an instance of this class.

Parameters:

file - File to receive trace information

Throws:

java.io.IOException - if an error occurs opening the file

setFile

public static void setFile(java.lang.String filename)
                    throws java.io.IOException

Set the file name to use for this class. This must be performed before the com.novell.nds.dirxml.driver.Trace class creates an instance of this class.

Parameters:

filename - name of file to receive trace information

Throws:

java.io.IOException - if an error occurs opening the file

getLevel

public int getLevel()

Return the current trace level.

Returns:

current trace level.

setLevel

public static void setLevel(int newLevel)

Set the trace level for this class.

Parameters:

newLevel - new trace level

trace

public void trace(int level,
                  java.lang.String message)

Output a message string if the passed level is greater than or equal to the current trace level.

Specified by:

trace in interface TraceInterface

Parameters:

level - trace level for message.

message - String to output.

trace

public void trace(int color,
                  int level,
                  java.lang.String message)

Output a message string if the passed level is greater than or equal to the current trace level.

Specified by:

trace in interface TraceInterface

Parameters:

color - Ignored here

level - trace level for message.

message - String to output.

trace

public void trace(int level,
                  XmlDocument document)

Serialize and output XML document if passed level is greater than or equal to the current trace level.

Specified by:

trace in interface TraceInterface

Parameters:

level - trace level for document.

document - The XML document to output

traceAlways

protected void traceAlways(java.lang.String message)

Output a message regardless of level.

Parameters:

message - String to output

traceAlways

protected void traceAlways(org.w3c.dom.Document document)

Output an XML Document regardless of level

Parameters:

document - XML Document

timeStampMessage

protected static java.lang.String timeStampMessage(java.lang.String message)

Prepend a timestamp to a String and return the result.

Parameters:

message - String to which to prepend timestamp.

Returns:

timestamped String.