cryptix.util.core

Class Debug

public class Debug extends Object

This class provides methods for determining where debugging output should be sent, and what level of debugging is enabled for specific classes and algorithms. Debugging levels are set in the Cryptix.properties file.

Copyright © 1997, 1998 Systemics Ltd on behalf of the Cryptix Development Team.
All rights reserved.

$Revision: 1.3 $

Since: Cryptix 2.2.2

Author: David Hopwood

Field Summary
static booleanGLOBAL_DEBUG
Whether to compile the library with a standard level of debugging support.
static booleanGLOBAL_DEBUG_SLOW
Whether to compile the library with additional debugging support that is likely to slow it down.
static booleanGLOBAL_TRACE
Whether to compile the library with tracing support or not.
Method Summary
static intgetLevel(String label)
Returns the debug level for label.
static intgetLevel(String label1, String label2)
Returns the maximum of the debug levels for label1 and label2.
static PrintWritergetOutput()
Returns the PrintWriter to which debugging output is to be sent.
static booleanisTraceable(String label)
Return true if tracing is requested for a given class.

User indicates this by setting the tracing boolean property for label in the Cryptix.properties file.

Field Detail

GLOBAL_DEBUG

public static final boolean GLOBAL_DEBUG
Whether to compile the library with a standard level of debugging support.

After changing this field, all classes should be recompiled in order to make sure that the change has taken effect.

GLOBAL_DEBUG_SLOW

public static final boolean GLOBAL_DEBUG_SLOW
Whether to compile the library with additional debugging support that is likely to slow it down.

After changing this field, all classes should be recompiled in order to make sure that the change has taken effect.

GLOBAL_TRACE

public static final boolean GLOBAL_TRACE
Whether to compile the library with tracing support or not.

After changing this field, all classes should be recompiled in order to make sure that the change has taken effect.

Method Detail

getLevel

public static int getLevel(String label)
Returns the debug level for label. This is normally given by the numeric provider property "Debug.Level.label".

If this property is not set, "Debug.Level.*" is searched next. If neither property is set, or if the first property found is not a valid decimal integer, then this method returns 0.

getLevel

public static int getLevel(String label1, String label2)
Returns the maximum of the debug levels for label1 and label2.

getOutput

public static PrintWriter getOutput()
Returns the PrintWriter to which debugging output is to be sent.

isTraceable

public static boolean isTraceable(String label)
Return true if tracing is requested for a given class.

User indicates this by setting the tracing boolean property for label in the Cryptix.properties file. The property's key is "Trace.label".

Parameters: label The name of a class.

Returns: True iff a boolean true value is set for a property with the key Trace.label.