Changeset 162:8bffd58d7b6d for doc/examples/muc_client.tac

Timestamp:

Jan 8, 2012, 9:26:06 AM (11 years ago)

Author:

Ralph Meijer <ralphm@…>

Branch:

default

Message:

Expose locked state of a room on join response with room created status.

When the presence in response to a join includes the room created status code
(201), the client should configure the room before it can be used. To enable
this, the locked state of the room is now exposed through the Room.locked
attribute.

Also, update example MUC client to deal with newly created, locked rooms.

File:

• doc/examples/muc_client.tac (modified) (2 diffs)

doc/examples/muc_client.tac

@@ -16 +16 @@
 
 from twisted.application import service
+from twisted.python import log
 from twisted.words.protocols.jabber.jid import JID
 from wokkel.client import XMPPClient
@@ -42 +43 @@
         """
         Once authorized, join the room.
+
+        If the join action causes a new room to be created, the room will be
+        locked until configured. Here we will just accept the default
+        configuration by submitting an empty form using L{configure}, which
+        usually results in a public non-persistent room.
+
+        Alternatively, you would use L{getConfiguration} to retrieve the
+        configuration form, and then submit the filled in form with the
+        required settings using L{configure}, possibly after presenting it to
+        an end-user.
         """
+        def joinedRoom(room):
+            if room.locked:
+                # Just accept the default configuration. 
+                return self.configure(room.roomJID, {})
+
         MUCClient.connectionInitialized(self)
-        self.join(self.roomJID, self.nick)
+
+        d = self.join(self.roomJID, self.nick)
+        d.addCallback(joinedRoom)
+        d.addCallback(lambda _: log.msg("Joined room"))
+        d.addErrback(log.err, "Join failed")
+
 
     def receivedGroupChat(self, room, user, message):