[sc1.0-cvs] CVS update: /sip-communicator-1-0-draft/src/net/java/sip/communicator/service/contactlist/

emcho at dev.java.net emcho at dev.java.net
Wed Feb 15 02:36:52 CET 2006


User: emcho   
Date: 2006/02/14 17:36:52

Log:
 Started work on the MetaContactList SLICK.

File Changes:

Directory: /sip-communicator-1-0-draft/src/net/java/sip/communicator/service/contactlist/
=========================================================================================

File [changed]: MetaContactListService.java
Url: https://sip-communicator-1-0-draft.dev.java.net/source/browse/sip-communicator-1-0-draft/src/net/java/sip/communicator/service/contactlist/MetaContactListService.java?r1=1.2&r2=1.3
Delta lines:  +22 -2
--------------------
--- MetaContactListService.java	5 Feb 2006 16:06:58 -0000	1.2
+++ MetaContactListService.java	15 Feb 2006 01:36:49 -0000	1.3
@@ -33,18 +33,38 @@
  * specific contacts. These protocol specific contacts may also be removed
  * away from a MetaContact. Whenever a MetaContact remains empty (i.e. all of
  * its protocol specific contacts are removed) it is automatically deleted.
- *
+ * <p>
  * Note that for most of the methods defined by this interface, it is likely
  * that implementations require one or more network operations to complete
  * before returning. It is therefore strongly advised not to call these methods
  * in event dispatching threads (watch out UI implementors ;) ) as this may lead
  * to unpleasant user experience.
- *
+ * <p>
+ * The MetaContactListService also defines a property named:<br>
+ * <tt>net.java.sip.communicator.service.contactlist.PROVIDER_MASK</tt><br>
+ * When this property is set, implementations of the MetaContactListService
+ * would only interact with protocol providers that same property set to the
+ * same value. This feature is mostly used during unit testing so that testing
+ * bundles could make sure that a tested meta contact list implementation would
+ * only load their mocking protocol provider implementations during the test
+ * run.
+ * <p>
  * @todo expections
  * @author Emil Ivov
  */
 public interface MetaContactListService
 {
+    /**
+     * This property is used to tell implementations of the
+     * MetaContactListService that they are to only interact with providers
+     * that have the same property set to the same value as the system one.
+     * This feature is mostly used during unit testing so that testing bundles
+     * could make sure that a tested meta contact list implementation would only
+     * load their mocking protocol provider implementations during the test run.
+     */
+    public static String PROVIDER_MASK_PROPERTY =
+        "net.java.sip.communicator.service.contactlist.PROVIDER_MASK";
+
     /**
      * Returns the root <tt>MetaContactGroup</tt> in this contact list.
      * All meta contacts and subgroups are children of the root meta contact




---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe at sip-communicator-1-0-draft.dev.java.net
For additional commands, e-mail: cvs-help at sip-communicator-1-0-draft.dev.java.net





More information about the commits mailing list