com.waveset.util
Interface ITrace

All Known Implementing Classes:
Trace, WSTrace

Deprecated. as of 6.0, use com.sun.idm.logging.trace instead.

public interface ITrace

An interface that defines methods to trace execution. Lighthouse application code can use these methods to make itself "debuggable" in a customer environment.

Some parts of Lighthouse must execute before WSTrace is available. WSTrace also introduces (by reference) dependencies on very nearly the entire system, which can create a circular reference problem at build time.

// * Enabling ITrace prints messages to System.out. // * Use this to trace such portions of Lighthouse. For example, // *
 . // * lh -DITrace.enable=true -DITrace.DirectoryDataStore=3 // * -DITrace.DirectoryDataStore\$Item=4 // * com.waveset.repository.test.DirectoryDataStoreTests // * 2>&1 | tee temp; vi temp // * // *


Field Summary
static long ALWAYS
          Deprecated.  
static java.lang.String CLASS
          Deprecated.  
static java.lang.String code_id
          Deprecated.  
static long LEVEL1
          Deprecated.  
static long LEVEL2
          Deprecated.  
static long LEVEL3
          Deprecated.  
static long LEVEL4
          Deprecated.  
static java.lang.String TRACE_ENABLED
          Deprecated. Key to property that specifies whether trace is enabled (e.g., trace.enabled=true).
static java.lang.String TRACE_LEVEL
          Deprecated. Key to property that specifies global trace level (e.g., trace.level=3).
 
Method Summary
 void data(long level, java.lang.Class c, java.lang.String method, byte[] bytes)
          Deprecated. - Specify class as a String.
 void data(long level, java.lang.String c, java.lang.String method, byte[] bytes)
          Deprecated. Traces method data if the trace level in effect for the specified class meets or exceeds the specified level.
 void entry(long level, java.lang.Class c, java.lang.String method)
          Deprecated. - Specify class as a String.
 void entry(long level, java.lang.Class c, java.lang.String method, java.lang.Object[] args)
          Deprecated. - Specify class as a String.
 void entry(long level, java.lang.Class c, java.lang.String method, java.lang.String input)
          Deprecated. - Specify class as a String.
 void entry(long level, java.lang.String c, java.lang.String method)
          Deprecated. Traces method entry if the trace level in effect for the specified class meets or exceeds the specified level.
 void entry(long level, java.lang.String c, java.lang.String method, java.lang.Object[] args)
          Deprecated. Traces method entry (with an array of args) if the trace level in effect for the specified class meets or exceeds the specified level.
 void entry(long level, java.lang.String c, java.lang.String method, java.lang.String input)
          Deprecated. Traces method entry (with preformatted input) if the trace level in effect for the specified class meets or exceeds the specified level.
 void exception(long level, java.lang.Class c, java.lang.String method, java.lang.Throwable t)
          Deprecated. - Specify class as a String.
 void exception(long level, java.lang.String c, java.lang.String method, java.lang.Throwable t)
          Deprecated. Traces an exception if the trace level in effect for the specified class meets or exceeds the specified level.
 void exit(long level, java.lang.Class c, java.lang.String method)
          Deprecated. - Specify class as a String.
 void exit(long level, java.lang.Class c, java.lang.String method, boolean b)
          Deprecated. - Specify class as a String.
 void exit(long level, java.lang.Class c, java.lang.String method, int i)
          Deprecated. - Specify class as a String.
 void exit(long level, java.lang.Class c, java.lang.String method, long l)
          Deprecated. - Specify class as a String.
 void exit(long level, java.lang.Class c, java.lang.String method, java.lang.Object o)
          Deprecated. - Specify class as a String.
 void exit(long level, java.lang.String c, java.lang.String method)
          Deprecated. Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.
 void exit(long level, java.lang.String c, java.lang.String method, boolean b)
          Deprecated. Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.
 void exit(long level, java.lang.String c, java.lang.String method, int i)
          Deprecated. Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.
 void exit(long level, java.lang.String c, java.lang.String method, long l)
          Deprecated. Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.
 void exit(long level, java.lang.String c, java.lang.String method, java.lang.Object o)
          Deprecated. Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.
 void info(long level, java.lang.Class c, java.lang.String method, java.lang.String info)
          Deprecated. - Specify class as a String.
 void info(long level, java.lang.String c, java.lang.String method, java.lang.String info)
          Deprecated. Traces method information if the trace level in effect for the specified class meets or exceeds the specified level.
 boolean level1(java.lang.Class c, java.lang.String method)
          Deprecated. - Use level1(String,String).
 boolean level1(java.lang.String c, java.lang.String method)
          Deprecated.  
 boolean level2(java.lang.Class c, java.lang.String method)
          Deprecated. - Use level2(String,String).
 boolean level2(java.lang.String c, java.lang.String method)
          Deprecated.  
 boolean level3(java.lang.Class c, java.lang.String method)
          Deprecated. - Use level3(String,String).
 boolean level3(java.lang.String c, java.lang.String method)
          Deprecated.  
 boolean level4(java.lang.Class c, java.lang.String method)
          Deprecated. - Use level4(String,String).
 boolean level4(java.lang.String c, java.lang.String method)
          Deprecated.  
 void variable(long level, java.lang.Class c, java.lang.String method, java.lang.String label, boolean b)
          Deprecated. - Specify class as a String.
 void variable(long level, java.lang.Class c, java.lang.String method, java.lang.String label, int i)
          Deprecated. - Specify class as a String.
 void variable(long level, java.lang.Class c, java.lang.String method, java.lang.String label, long l)
          Deprecated. - Specify class as a String.
 void variable(long level, java.lang.Class c, java.lang.String method, java.lang.String label, java.lang.Object o)
          Deprecated. - Specify class as a String.
 void variable(long level, java.lang.String c, java.lang.String method, java.lang.String label, boolean b)
          Deprecated. Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.
 void variable(long level, java.lang.String c, java.lang.String method, java.lang.String label, int i)
          Deprecated. Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.
 void variable(long level, java.lang.String c, java.lang.String method, java.lang.String label, long l)
          Deprecated. Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.
 void variable(long level, java.lang.String c, java.lang.String method, java.lang.String label, java.lang.Object o)
          Deprecated. Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.
 

Field Detail

code_id

public static final java.lang.String code_id
Deprecated. 
See Also:
Constant Field Values

CLASS

public static final java.lang.String CLASS
Deprecated. 
See Also:
Constant Field Values

ALWAYS

public static final long ALWAYS
Deprecated. 
See Also:
Constant Field Values

LEVEL1

public static final long LEVEL1
Deprecated. 
See Also:
Constant Field Values

LEVEL2

public static final long LEVEL2
Deprecated. 
See Also:
Constant Field Values

LEVEL3

public static final long LEVEL3
Deprecated. 
See Also:
Constant Field Values

LEVEL4

public static final long LEVEL4
Deprecated. 
See Also:
Constant Field Values

TRACE_LEVEL

public static final java.lang.String TRACE_LEVEL
Deprecated. 
Key to property that specifies global trace level (e.g., trace.level=3).

See Also:
Constant Field Values

TRACE_ENABLED

public static final java.lang.String TRACE_ENABLED
Deprecated. 
Key to property that specifies whether trace is enabled (e.g., trace.enabled=true).

See Also:
Constant Field Values
Method Detail

entry

public void entry(long level,
                  java.lang.String c,
                  java.lang.String method)
Deprecated. 
Traces method entry if the trace level in effect for the specified class meets or exceeds the specified level.


entry

public void entry(long level,
                  java.lang.String c,
                  java.lang.String method,
                  java.lang.String input)
Deprecated. 
Traces method entry (with preformatted input) if the trace level in effect for the specified class meets or exceeds the specified level.


entry

public void entry(long level,
                  java.lang.String c,
                  java.lang.String method,
                  java.lang.Object[] args)
Deprecated. 
Traces method entry (with an array of args) if the trace level in effect for the specified class meets or exceeds the specified level.


exit

public void exit(long level,
                 java.lang.String c,
                 java.lang.String method)
Deprecated. 
Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.


exit

public void exit(long level,
                 java.lang.String c,
                 java.lang.String method,
                 java.lang.Object o)
Deprecated. 
Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.


exit

public void exit(long level,
                 java.lang.String c,
                 java.lang.String method,
                 int i)
Deprecated. 
Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.


exit

public void exit(long level,
                 java.lang.String c,
                 java.lang.String method,
                 long l)
Deprecated. 
Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.


exit

public void exit(long level,
                 java.lang.String c,
                 java.lang.String method,
                 boolean b)
Deprecated. 
Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.


info

public void info(long level,
                 java.lang.String c,
                 java.lang.String method,
                 java.lang.String info)
Deprecated. 
Traces method information if the trace level in effect for the specified class meets or exceeds the specified level.


data

public void data(long level,
                 java.lang.String c,
                 java.lang.String method,
                 byte[] bytes)
Deprecated. 
Traces method data if the trace level in effect for the specified class meets or exceeds the specified level.


variable

public void variable(long level,
                     java.lang.String c,
                     java.lang.String method,
                     java.lang.String label,
                     java.lang.Object o)
Deprecated. 
Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.


variable

public void variable(long level,
                     java.lang.String c,
                     java.lang.String method,
                     java.lang.String label,
                     int i)
Deprecated. 
Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.


variable

public void variable(long level,
                     java.lang.String c,
                     java.lang.String method,
                     java.lang.String label,
                     long l)
Deprecated. 
Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.


variable

public void variable(long level,
                     java.lang.String c,
                     java.lang.String method,
                     java.lang.String label,
                     boolean b)
Deprecated. 
Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.


exception

public void exception(long level,
                      java.lang.String c,
                      java.lang.String method,
                      java.lang.Throwable t)
Deprecated. 
Traces an exception if the trace level in effect for the specified class meets or exceeds the specified level.


entry

public void entry(long level,
                  java.lang.Class c,
                  java.lang.String method)
Deprecated. - Specify class as a String.

Traces method entry if the trace level in effect for the specified class meets or exceeds the specified level.


entry

public void entry(long level,
                  java.lang.Class c,
                  java.lang.String method,
                  java.lang.String input)
Deprecated. - Specify class as a String.

Traces method entry (with preformatted input) if the trace level in effect for the specified class meets or exceeds the specified level.


entry

public void entry(long level,
                  java.lang.Class c,
                  java.lang.String method,
                  java.lang.Object[] args)
Deprecated. - Specify class as a String.

Traces method entry (with an array of args) if the trace level in effect for the specified class meets or exceeds the specified level.


exit

public void exit(long level,
                 java.lang.Class c,
                 java.lang.String method)
Deprecated. - Specify class as a String.

Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.


exit

public void exit(long level,
                 java.lang.Class c,
                 java.lang.String method,
                 java.lang.Object o)
Deprecated. - Specify class as a String.

Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.


exit

public void exit(long level,
                 java.lang.Class c,
                 java.lang.String method,
                 int i)
Deprecated. - Specify class as a String.

Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.


exit

public void exit(long level,
                 java.lang.Class c,
                 java.lang.String method,
                 long l)
Deprecated. - Specify class as a String.

Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.


exit

public void exit(long level,
                 java.lang.Class c,
                 java.lang.String method,
                 boolean b)
Deprecated. - Specify class as a String.

Traces method exit if the trace level in effect for the specified class meets or exceeds the specified level.


info

public void info(long level,
                 java.lang.Class c,
                 java.lang.String method,
                 java.lang.String info)
Deprecated. - Specify class as a String.

Traces method information if the trace level in effect for the specified class meets or exceeds the specified level.


data

public void data(long level,
                 java.lang.Class c,
                 java.lang.String method,
                 byte[] bytes)
Deprecated. - Specify class as a String.

Traces method data if the trace level in effect for the specified class meets or exceeds the specified level.


variable

public void variable(long level,
                     java.lang.Class c,
                     java.lang.String method,
                     java.lang.String label,
                     java.lang.Object o)
Deprecated. - Specify class as a String.

Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.


variable

public void variable(long level,
                     java.lang.Class c,
                     java.lang.String method,
                     java.lang.String label,
                     int i)
Deprecated. - Specify class as a String.

Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.


variable

public void variable(long level,
                     java.lang.Class c,
                     java.lang.String method,
                     java.lang.String label,
                     long l)
Deprecated. - Specify class as a String.

Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.


variable

public void variable(long level,
                     java.lang.Class c,
                     java.lang.String method,
                     java.lang.String label,
                     boolean b)
Deprecated. - Specify class as a String.

Traces a method variable if the trace level in effect for the specified class meets or exceeds the specified level.


exception

public void exception(long level,
                      java.lang.Class c,
                      java.lang.String method,
                      java.lang.Throwable t)
Deprecated. - Specify class as a String.

Traces an exception if the trace level in effect for the specified class meets or exceeds the specified level.


level1

public boolean level1(java.lang.String c,
                      java.lang.String method)
Deprecated. 
Returns:
true if a trace level of at least 1 is in effect for the specified class and method.

level2

public boolean level2(java.lang.String c,
                      java.lang.String method)
Deprecated. 
Returns:
true if a trace level of at least 2 is in effect for the specified class and method.

level3

public boolean level3(java.lang.String c,
                      java.lang.String method)
Deprecated. 
Returns:
true if a trace level of at least 3 is in effect for the specified class and method.

level4

public boolean level4(java.lang.String c,
                      java.lang.String method)
Deprecated. 
Returns:
true if a trace level of at least 4 is in effect for the specified class and method.

level1

public boolean level1(java.lang.Class c,
                      java.lang.String method)
Deprecated. - Use level1(String,String).


level2

public boolean level2(java.lang.Class c,
                      java.lang.String method)
Deprecated. - Use level2(String,String).


level3

public boolean level3(java.lang.Class c,
                      java.lang.String method)
Deprecated. - Use level3(String,String).


level4

public boolean level4(java.lang.Class c,
                      java.lang.String method)
Deprecated. - Use level4(String,String).