org.sblim.cimclient

Class LogAndTraceManager

public class LogAndTraceManager extends Object

Class LogAndTraceManager provides the means to register/unregister log and trace listerners. It is the entry point for application that want to redirect the CIM Client's log and trace messages into their own logging framework.

Method Summary
void	addLogListener(LogListener pListener) Adds a listener for log messages.
void	addTraceListener(TraceListener pListener) Adds a listener for log messages.
void	clearLogListeners() Removes all listeners.
void	clearTraceListeners() Removes all listeners.
List	getLogListeners() Gets the registered log listeners including the internal console and file loggers.
static LogAndTraceManager	getManager() Returns the singleton instance of the manager.
List	getTraceListeners() Gets the registered trace listeners including the internal console and file loggers.
OutputStream	getXmlTraceStream() Returns the stream to which the CIM-XML traces are sent.
void	removeLogListener(LogListener pListener) Remove a listener.
void	removeTraceListener(TraceListener pListener) Removes a listener.
void	setXmlTraceStream(OutputStream pStream) Sets the stream to which the CIM-XML traces are sent.

Method Detail

addLogListener

public void addLogListener(LogListener pListener)

Adds a listener for log messages. The listener will be notified of any log event.

Parameters: pListener The listener

addTraceListener

public void addTraceListener(TraceListener pListener)

Adds a listener for log messages. The listener will be notified of any trace event.

Parameters: pListener The listener

clearLogListeners

public void clearLogListeners()

Removes all listeners. Caution: This will also remove the internal console and file loggers.

clearTraceListeners

public void clearTraceListeners()

Removes all listeners. Caution this will also remove the internal trace file listener.

getLogListeners

public List getLogListeners()

Gets the registered log listeners including the internal console and file loggers.

Returns: An unmodifyable list of listeners

getManager

public static LogAndTraceManager getManager()

Returns the singleton instance of the manager.

Returns: The manager

getTraceListeners

public List getTraceListeners()

Gets the registered trace listeners including the internal console and file loggers.

Returns: A unmodifiable list of listeners

getXmlTraceStream

public OutputStream getXmlTraceStream()

Returns the stream to which the CIM-XML traces are sent. A value of null means that tracing is effectively disabled. Otherwise the CIM-XML tracing can be activated either globally or per-connection via the "sblim.wbem.cimxmlTracing" configuration property.

Returns: The CIM-XML trace stream

removeLogListener

public void removeLogListener(LogListener pListener)

Remove a listener. This listener will not be notified of log events anymore.

Parameters: pListener The listener

removeTraceListener

public void removeTraceListener(TraceListener pListener)

Removes a listener. This listener will not be notified of trace events anymore.

Parameters: pListener The listener

setXmlTraceStream

public void setXmlTraceStream(OutputStream pStream)

Sets the stream to which the CIM-XML traces are sent. A value of null means that tracing is effectively disabled. Otherwise the CIM-XML tracing can be activated either globally or per-connection via the "sblim.wbem.cimxmlTracing" configuration property.

Parameters: pStream The CIM-XML trace stream