[Sblim-commit] jsr48-client/src/org/sblim/cimclient CIMXMLTraceListener.java, NONE, 1.1.2.1 LogAndTraceManager.java, 1.4.2.3, 1.4.2.4

[Dave B. <bla...@us...>]

Update of /cvsroot/sblim/jsr48-client/src/org/sblim/cimclient
In directory vz-cvs-3.sog:/tmp/cvs-serv1307/src/org/sblim/cimclient

Modified Files:
      Tag: Experimental
	LogAndTraceManager.java 
Added Files:
      Tag: Experimental
	CIMXMLTraceListener.java 
Log Message:
3554738 - dump CIM xml by LogAndTraceBroker.trace()

Index: LogAndTraceManager.java
===================================================================
RCS file: /cvsroot/sblim/jsr48-client/src/org/sblim/cimclient/LogAndTraceManager.java,v
retrieving revision 1.4.2.3
retrieving revision 1.4.2.4
diff -u -d -r1.4.2.3 -r1.4.2.4
--- LogAndTraceManager.java	23 Feb 2009 18:18:33 -0000	1.4.2.3
+++ LogAndTraceManager.java	17 Aug 2012 01:10:06 -0000	1.4.2.4
@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2006, 2009
+ * (C) Copyright IBM Corp. 2006, 2012
  *
  * THIS FILE IS PROVIDED UNDER THE TERMS OF THE ECLIPSE PUBLIC LICENSE 
  * ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THIS FILE 
@@ -16,7 +16,8 @@
  * 1565892    2006-11-13  lupusalex    Make SBLIM client JSR48 compliant
  * 2003590    2008-06-30  blaschke-oss Change licensing from CPL to EPL
  * 2524131    2009-01-21  raman_arora  Upgrade client to JDK 1.5 (Phase 1)
- * 2531371    2009-02-10  raman_arora  Upgrade client to JDK 1.5 (Phase 2) 
+ * 2531371    2009-02-10  raman_arora  Upgrade client to JDK 1.5 (Phase 2)
+ * 3554738    2012-08-16  blaschke-oss dump CIM xml by LogAndTraceBroker.trace()
  */
 
 package org.sblim.cimclient;
@@ -131,6 +132,45 @@
 	}
 
 	/**
+	 * Adds a listener for CIM-XML trace messages. The listener will be notified
+	 * of any CIM-XML trace event.
+	 * 
+	 * @param pListener
+	 *            The listener
+	 */
+	public void addCIMXMLTraceListener(CIMXMLTraceListener pListener) {
+		LogAndTraceBroker.getBroker().addCIMXMLTraceListener(pListener);
+	}
+
+	/**
+	 * Removes a CIM-XML trace listener. This listener will not be notified of
+	 * CIM-XML trace events anymore.
+	 * 
+	 * @param pListener
+	 *            The listener
+	 */
+	public void removeCIMXMLTraceListener(CIMXMLTraceListener pListener) {
+		LogAndTraceBroker.getBroker().removeCIMXMLTraceListener(pListener);
+	}
+
+	/**
+	 * Removes all CIM-XML trace listeners.
+	 */
+	public void clearCIMXMLTraceListeners() {
+		LogAndTraceBroker.getBroker().clearCIMXMLTraceListeners();
+	}
+
+	/**
+	 * Gets the registered CIM-XML trace listeners.
+	 * 
+	 * @return A unmodifiable list of listeners
+	 */
+	public List<CIMXMLTraceListener> getCIMXMLTraceListeners() {
+		return Collections
+				.unmodifiableList(LogAndTraceBroker.getBroker().getCIMXMLTraceListeners());
+	}
+
+	/**
 	 * Returns the stream to which the CIM-XML traces are sent. A value of
 	 * <code>null</code> means that tracing is effectively disabled. Otherwise
 	 * the CIM-XML tracing can be activated either globally or per-connection

--- NEW FILE: CIMXMLTraceListener.java ---
/**
 * (C) Copyright IBM Corp. 2012
 *
 * THIS FILE IS PROVIDED UNDER THE TERMS OF THE ECLIPSE PUBLIC LICENSE 
 * ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THIS FILE 
 * CONSTITUTES RECIPIENTS ACCEPTANCE OF THE AGREEMENT.
 *
 * You can obtain a current copy of the Eclipse Public License from
 * http://www.opensource.org/licenses/eclipse-1.0.php
 *
 * @author : Alexander Wolf-Reber, IBM, a.w...@de...
 *           Dave Blaschke, IBM, bla...@us...
 * 
 * Change History
 * Flag       Date        Prog         Description
 *------------------------------------------------------------------------------- 
 * 3554738    2012-08-16  blaschke-oss dump CIM xml by LogAndTraceBroker.trace()
 */

package org.sblim.cimclient;

/**
 * The interface CIMXMLTraceListener must be implemented if you want to attach
 * your own CIM-XML logging framework to the CIM Client.
 * 
 * @see LogAndTraceManager
 */
public interface CIMXMLTraceListener {

	/**
	 * Receive a CIM-XML trace message.
	 * 
	 * @param pMessage
	 *            The CIM-XML message text
	 * @param pOutgoing
	 *            <code>true</code> if CIM-XML is outgoing (being sent from
	 *            client to server), <code>false</code> if CIM-XML is incoming
	 *            (being sent from server to client)
	 */
	public void traceCIMXML(String pMessage, boolean pOutgoing);

}