[sip-comm-cvs] CVS update: /sip-communicator/src/net/java/sip/communicator/service/protocol/OperationSetMultiUserChat.java

emcho at dev.java.net emcho at dev.java.net
Mon Apr 23 20:12:46 CEST 2007


User: emcho   
Date: 2007-04-23 18:12:46+0000
Log:
 working on multi chat and a jabber implementation
 
 fixed javadocs and exception declarations

File Changes:

Directory: /sip-communicator/src/net/java/sip/communicator/service/protocol/
============================================================================

File [changed]: OperationSetMultiUserChat.java
Url: https://sip-communicator.dev.java.net/source/browse/sip-communicator/src/net/java/sip/communicator/service/protocol/OperationSetMultiUserChat.java?r1=1.3&r2=1.4
Delta lines:  +23 -7
--------------------
--- OperationSetMultiUserChat.java	2007-03-10 14:34:08+0000	1.3
+++ OperationSetMultiUserChat.java	2007-04-23 18:12:44+0000	1.4
@@ -16,20 +16,24 @@
  * @author Emil Ivov
  */
 public interface OperationSetMultiUserChat
+    extends OperationSet
 {
     /**
-     * Returns the <tt>List</tt> of <tt>ChatRoom</tt>s currently available on
-     * the server that this protocol provider is connected to.
-     *
-     * @return a <tt>java.util.List</tt> of <tt>ChatRoom</tt>s that are
+     * Returns the <tt>List</tt> of <tt>String</tt>s indicating chat rooms
      * currently available on the server that this protocol provider is
      * connected to.
      *
+     * @return a <tt>java.util.List</tt> of the name <tt>String</tt>s for chat
+     * rooms that are currently available on the server that this protocol
+     * provider is connected to.
+     *
      * @throws OperationFailedException if we faile retrieving this list from
      * the server.
+     * @throws OperationNotSupportedException if the server does not support
+     * multi user chat
      */
     public List getExistingChatRooms()
-        throws OperationFailedException;
+        throws OperationFailedException, OperationNotSupportedException;
 
     /**
      * Returns a list of the chat rooms that we have joined and are currently
@@ -47,8 +51,14 @@
      * @param contact the contact whose current ChatRooms we will be querying.
      * @return a list of the chat rooms that <tt>contact</tt> has joined and is
      * currently active in.
+     *
+     * @throws OperationFailedException if an error occurs while trying to
+     * discover the room on the server.
+     * @throws OperationNotSupportedException if the server does not support
+     * multi user chat
      */
-    public List getCurrentlyJoinedChatRooms(Contact contact);
+    public List getCurrentlyJoinedChatRooms(Contact contact)
+        throws OperationFailedException, OperationNotSupportedException;
 
     /**
      * Creates a room with the named <tt>roomName</tt> and according to the
@@ -78,8 +88,14 @@
      * @param roomName the name of the <tt>ChatRoom</tt> that we're looking for.
      * @return the <tt>ChatRoom</tt> named <tt>roomName</tt> or null if no such
      * room exists on the server that this provider is currently connected to.
+     *
+     * @throws OperationFailedException if an error occurs while trying to
+     * discover the room on the server.
+     * @throws OperationNotSupportedException if the server does not support
+     * multi user chat
      */
-    public ChatRoom findRoom(String roomName);
+    public ChatRoom findRoom(String roomName)
+        throws OperationFailedException, OperationNotSupportedException;
 
     /**
      * Informs the sender of an invitation that we decline their invitation.




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





More information about the commits mailing list