| Default implementation of detail diagnostic on the object.
This interface provides a way for an object to pass back pieces of
information as requested by the caller. The information is passed
back and forth through the properties argument. It is expected that
the caller knows what kind of information to ask for, and correctly
handles the situation when the diagnostic object can't provide the
information.
As an example assume an object TABLE exists, and that we have created
an object D_TABLE that knows how to return the number of pages in the
TABLE object. The code to get that information out would looks something
like the following:
print_num_pages(Object table)
{
Properties prop = new Properties();
prop.put(Page.DIAG_NUM_PAGES, "");
DiagnosticUtil.findDiagnostic(table).diag_detail(prop);
System.out.println(
"number of pages = " + prop.getProperty(Page.DIAG_NUM_PAGES));
}
This routine should be overriden if there is detail diagnostics to
be provided by a real implementation.
exception:
StandardException - Standard cloudscape exception policy |