[asterisk-scf-commits] asterisk-scf/integration/slice.git branch "master" updated.

[Commits to the Asterisk SCF project code repositories]

branch "master" has been updated
       via  24e811fa21d491a9a3549ff9192e7b7fc9b83081 (commit)
      from  00b19df845fbeb7a4acd1bfa14cdec482eea23db (commit)

Summary of changes:
 SessionCommunications/Bridging/BridgingIf.ice |   28 +++++++++++++++++++++---
 1 files changed, 24 insertions(+), 4 deletions(-)


- Log -----------------------------------------------------------------
commit 24e811fa21d491a9a3549ff9192e7b7fc9b83081
Author: Brent Eagles <beagles at digium.com>
Date:   Wed Sep 15 11:22:02 2010 -0230

    Add an exception to be thrown by Bridging objects if any of the
    sessions included as an argument to addSessions or removeSessions are invalid.

diff --git a/SessionCommunications/Bridging/BridgingIf.ice b/SessionCommunications/Bridging/BridgingIf.ice
index ff9fa79..d77e340 100644
--- a/SessionCommunications/Bridging/BridgingIf.ice
+++ b/SessionCommunications/Bridging/BridgingIf.ice
@@ -31,6 +31,17 @@ module V1
      */
     const string BridgeServiceDiscoveryCategory = "BridgeService";
 
+    /**
+     * The bridge throws an InvalidSessions exception if any of the sessions
+     * passed as an argument to addSessions or removeSessions are invalid (e.g. nil)
+     * It contains a vector of index values that can be used by the caller to
+     * isolate the "bad" values.
+     */
+    exception InvalidSessions
+    {
+        Ice::LongSeq indexes;
+    };
+
     interface BridgeListener;
 
     /**
@@ -44,11 +55,15 @@ module V1
          * if necessary.
          * 
          * @param session A sequence of session proxies.
+         *
+         * @throws InvalidSessions if any of the provided sessions are invalid.
          * 
          * @see Session
+         * @see InvalidSessions
          *
          */
-        void addSessions(V1::SessionSeq session);
+        void addSessions(V1::SessionSeq session)
+            throws InvalidSessions;
         
         /** 
          * Abruptly destroy the bridge. Sessions will not be stopped.
@@ -68,8 +83,15 @@ module V1
          * as they are removed.
          * 
          * @param sessions A sequence of session proxies.
+         *
+         * @throws InvalidSessions if any of the provided sessions are invalid.
+         *
+         * @see Session
+         * @see InvalidSessions
+         *
          */
-        void removeSessions(V1::SessionSeq sessions);
+        void removeSessions(V1::SessionSeq sessions)
+            throws InvalidSessions;
 
         /** 
          * Nicely shutdown the bridge. Participating sessions are disconnected.
@@ -154,8 +176,6 @@ module V1
      */
     interface BridgeManager
     {
-        
-
         void addListener(BridgeManagerListener* listener);
         Bridge* createBridge(V1::SessionSeq sessions, BridgeListener* listener);
         void removeListener(BridgeManagerListener* listener);

-----------------------------------------------------------------------


-- 
asterisk-scf/integration/slice.git