|
|||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||
java.lang.Objectcom.sun.jdmk.TraceListener
An object of this class can be used to receive notifications sent out by the class Trace, and all notifications received will be saved to a file specified, or write to user screen. This listener will print or save information with two formats:
(className methodName threadName timeStamp) Message. This is a default format
Global sequence number: 7 Sequence number: 3
Level: LEVEL_TRACE Type: INFO_CONNECTOR_RMI
Class Name: MBeanServer
Method Name: sendTraceInfo
Thread name: Thread-1 (the name of a thread which created this notification)
TimeStamp: dd:mm:ss:nn (the time when the notification was created)
Information: This is a example to send a trace information.
A user should call the method setFormated with the value "true" to select this format.
This class can be used as a default listener, a user can write his own listener to treat trace information the way he wants.
| Field Summary | |
protected boolean |
formated
|
protected boolean |
needTobeClosed
|
protected PrintStream |
out
|
| Constructor Summary | |
TraceListener()
Construct a default trace listener. |
|
TraceListener(PrintStream ps)
Construct a trace listener with a specified. |
|
TraceListener(String fileName)
Construct a trace listener with a file specified to save all information received. |
|
| Method Summary | |
void |
handleNotification(Notification notif,
Object handback)
Called by the class Trace to receive trace information. |
void |
setFile(String fileName)
Specify a file to save information received |
void |
setFormated(boolean f)
Choose a format to output trace information. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Field Detail |
protected PrintStream out
protected boolean needTobeClosed
protected boolean formated
| Constructor Detail |
public TraceListener()
public TraceListener(PrintStream ps)
throws IllegalArgumentException
ps - A PrintStream object used to print trace information.
For example, it can take value as System.out or System.err.
IllegalArgumentException - thrown if the PrintStream
parameter is null.
public TraceListener(String fileName)
throws IOException
If specified file exists currently, all trace information will be appended to this file.
fileName - the file used to save information.
IOException - thrown if failed to open or to write the file.| Method Detail |
public void setFormated(boolean f)
f - if true, the full information will be printed out.
public void handleNotification(Notification notif,
Object handback)
handleNotification in interface NotificationListener
public void setFile(String fileName)
throws IOException
fileName - the file used to save information. It will
replace the old file or the PrintStream object set before.
IOException - thrown if failed to open or to write the file.
|
FCS Release jdmk-5_1-b34.1 2005.02.10_16:46:09_MET |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||