java.lang.Object
org.apache.derby.iapi.services.diag.DiagnosticUtil
- public class DiagnosticUtil
- extends java.lang.Object
The Diagnostic framework is meant to provide a way to include as much
diagnostic capability within the distributed release of the cloudscape
product without adversely affecting the runtime speed or foot print of
a running configuration that needs not use this information.
In order to decrease the class size of running objects diagnostic information
should be put in "helper" classes. So to provide diagnostic capabiility
on the implementation of class Foo.java create a class D_Foo.java. Class
D_Foo must implement the Diagnosticable interface.
This class provide utility functions to get at the information provided by
the D_* helper class:
findDiagnostic() - given and object "obj", get an instance of D_obj.
toDiagString() - return the "best" diagnostic string available about
a given object.
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
DiagnosticUtil
private DiagnosticUtil()
findDiagnostic
public static Diagnosticable findDiagnostic(java.lang.Object ref)
- Given an object return instance of the diagnostic object for this class.
Given an object this routine will determine the classname of the object
and then try to instantiate a new instance of the diagnostic object
for this class by prepending on "D_" to the last element of theclassname.
If no matching class is found then the same lookup is made on the super-class
of the object, looking all the way up the hierachy until a diagnostic class
is found.
This routine will call "init(ref)" on the new instance and then return the new instance.
toDiagString
public static java.lang.String toDiagString(java.lang.Object obj)
- Return a diagnostic string associated with an object.
A utility interface to use if you just want to print a single string
that represents the object in question. In following order this routine
will deliver the string to use:
1) find diagnostic help class, and use class.diag()
2) else just use class.toString()