public class LogAndTraceBroker
extends java.lang.Object
Modifier and Type | Method and Description |
---|---|
void |
addCIMXMLTraceListener(CIMXMLTraceListener pListener)
Adds a listener for CIM-XML trace messages.
|
void |
addLogListener(LogListener pListener)
Adds a listener for log messages.
|
void |
addTraceListener(TraceListener pListener)
Adds a listener for log messages.
|
void |
clearCIMXMLTraceListeners()
Removes all CIM-XML trace listeners.
|
void |
clearLogListeners()
Removes all listeners.
|
void |
clearTraceListeners()
Removes all listeners.
|
void |
entry()
Forwards a method entry message to the registered trace listeners.
|
void |
exit()
Forwards a method exit message to the registered trace listeners.
|
static LogAndTraceBroker |
getBroker()
Returns the singleton instance of the broker
|
java.util.List<CIMXMLTraceListener> |
getCIMXMLTraceListeners()
Gets the registered CIM-XML trace listeners.
|
java.util.List<LogListener> |
getLogListeners()
Gets the registered log listeners including the internal console and file
loggers.
|
java.util.List<TraceListener> |
getTraceListeners()
Gets the registered trace listeners including the internal console and
file loggers.
|
java.io.OutputStream |
getXmlTraceStream()
Returns the output stream to which all CIM-XML traffic (outgoing &
incoming) will be copied for debugging purposes.
|
boolean |
isLoggableCIMXMLTrace(java.util.logging.Level pLevel)
Checks whether there are CIM-XML trace listeners installed that will log
a CIM-XML trace message.
|
boolean |
isLoggableMessage(java.util.logging.Level pLevel)
Checks whether there are log listeners installed that will log a message
with the specified level.
|
boolean |
isLoggableTrace(java.util.logging.Level pLevel)
Checks whether there are trace listeners installed that will log a trace
message with the specified level.
|
static boolean |
isLoggingStarted()
Returns if the logging framework has been initialized.
|
void |
message(java.lang.String pKey)
Forwards a log/trace message to the registered log&trace listeners.
|
void |
message(java.lang.String pKey,
java.lang.Object pParameter)
Forwards a log/trace message to the registered log&trace listeners.
|
void |
message(java.lang.String pKey,
java.lang.Object[] pParameters)
Forwards a log/trace message to the registered log&trace listeners.
|
void |
registerInternalListeners()
Registers the listeners for our internal loggers
|
void |
removeCIMXMLTraceListener(CIMXMLTraceListener pListener)
Removes a CIM-XML trace listener.
|
void |
removeLogListener(LogListener pListener)
Remove a listener.
|
void |
removeTraceListener(TraceListener pListener)
Removes a listener.
|
void |
setXmlTraceStream(java.io.OutputStream pStream)
Sets an output stream to which all CIM-XML traffic (outgoing &
incoming) will be copied for debugging purposes.
|
void |
trace(java.util.logging.Level pLevel,
java.lang.String pMessage)
Forwards a trace message to the registered trace listeners.
|
void |
trace(java.util.logging.Level pLevel,
java.lang.String pMessage,
java.lang.Throwable pThrown)
Forwards a trace message to the registered trace listeners.
|
void |
traceCIMXML(java.util.logging.Level pLevel,
java.lang.String pMessage,
boolean pOutgoing)
Forwards a CIM-XML trace message to the registered CIM-XML trace
listeners.
|
public static LogAndTraceBroker getBroker()
public static boolean isLoggingStarted()
WBEMConfiguration
class to determine if the
logging is already up. The WBEMConfiguration
is initialized
before the logging, so methods in this class cannot assume the logging to
be up and running.true
if the logging is up, false
otherwisepublic void registerInternalListeners()
public void addLogListener(LogListener pListener)
pListener
- The listenerpublic void removeLogListener(LogListener pListener)
pListener
- The listenerpublic void clearLogListeners()
public java.util.List<LogListener> getLogListeners()
public void addTraceListener(TraceListener pListener)
pListener
- The listenerpublic void removeTraceListener(TraceListener pListener)
pListener
- The listenerpublic void clearTraceListeners()
public java.util.List<TraceListener> getTraceListeners()
public void addCIMXMLTraceListener(CIMXMLTraceListener pListener)
pListener
- The listenerpublic void removeCIMXMLTraceListener(CIMXMLTraceListener pListener)
pListener
- The listenerpublic void clearCIMXMLTraceListeners()
public java.util.List<CIMXMLTraceListener> getCIMXMLTraceListeners()
public void message(java.lang.String pKey)
pKey
- The message identifier.public void message(java.lang.String pKey, java.lang.Object pParameter)
pKey
- The message identifier.pParameter
- The parameter for the messagepublic void message(java.lang.String pKey, java.lang.Object[] pParameters)
pKey
- The message identifier.pParameters
- The parameters for the messagepublic void trace(java.util.logging.Level pLevel, java.lang.String pMessage)
pLevel
- One of the three message level identifiers FINE, FINER and
FINESTpMessage
- The message textpublic void trace(java.util.logging.Level pLevel, java.lang.String pMessage, java.lang.Throwable pThrown)
pLevel
- One of the three message level identifiers FINE, FINER and
FINESTpMessage
- The message textpThrown
- The throwable associated with the messagepublic void traceCIMXML(java.util.logging.Level pLevel, java.lang.String pMessage, boolean pOutgoing)
pLevel
- One of the message level identifiers, e.g. FINEpMessage
- The CIM-XML message textpOutgoing
- true
if CIM-XML is outgoing (being sent from
client to server), false
if CIM-XML is incoming
(being sent from server to client)public void entry()
public void exit()
public java.io.OutputStream getXmlTraceStream()
null
value means that CIM-XML
debugging is disabledpublic void setXmlTraceStream(java.io.OutputStream pStream)
pStream
- The output stream. A null
value means that
CIM-XML debugging is disabled.public boolean isLoggableTrace(java.util.logging.Level pLevel)
if (logger.isLoggableTrace(Level.WARNING) { // Prepare info for logging logger.trace(Level.WARNING, ...
pLevel
- The Level
of the trace message.true
if trace message could be logged,
false
otherwise.public boolean isLoggableMessage(java.util.logging.Level pLevel)
if (logger.isLoggableMessage(Level.WARNING) { // Prepare info for logging logger.message(Level.WARNING, ...
pLevel
- The Level
of the message.true
if message could be logged, false
otherwise.public boolean isLoggableCIMXMLTrace(java.util.logging.Level pLevel)
if (logger.isLoggableCIMXMLTrace(Level.FINEST) { // Prepare info for logging logger.traceCIMXML(Level.FINEST, ...
pLevel
- The Level
of the trace message.true
if CIM-XML trace message could be logged,
false
otherwise.Copyright © 2005, 2012 IBM Corporation. All Rights Reserved.