It has been a while since my last blog. A combination of work and reimagining
conversation support led to this hiatus. After the last blog, I wanted to do a series on the applicational aspect of Vorpal
viz. how do you go about using the various features in Vorpal to implement a custom XMPP service. However I found IQ support wanting; in particular correlating IQ request/response to be really tedious. I’ve also felt, for quite sometime now, that my initial design for conversation support which I blog about here
to be extremely simplistic. So I took the opportunity to redesign these.
The good news is that if you are using previous version of Vorpal to develop your application, nothing apparent have change; everything should works as is. If you have any issues, please open an issue
or post your problem in the forum
. Bad news? Conversation support is quite tricky because it affects the framework greatly so if you find any NPE which wasn’t in earlier releases of Vorpal, please let me know.
Rather than writing a long blog on conversation, I’m going to break this subject into 3 or 4 blogs convering concepts, implicit and explicit conversations and interactions between these.
What are Conversations?
What is the purpose of conversation? Simply put conversation allows a Vorpal application to keep states about an interaction between 2 jabber entity. This is very similar to HTTP session support
. In Vorpal states can be kept in
, very similiar to
, and/or in stateful objects marked with
(think Stateful Session Bean
). Every conversation is marked with a unique conversation id.
The default conversation provider gets the conversation id from the following
- when there is a
<thread> element in
<message>. This is part of the XMPP standard. See XEP-0201.
- or by using implied conversation id support between any 2 Jabber entities when <thread> element is missing.
All packet falling under the same conversation (viz. having the same conversation id) will be able to access to the same state information stored in
@Conversation message handlers.
The way implied conversation id works is by examining the to or from of a packet and figure out a thread id from there. Vorpal will first look for
- conversation between an entity and a chat room (ok an entity as well). It does this by looking for the following pattern ‘
@conference.‘ in either the from or to. If it finds it then Vorpal can use the chat rooms JID as a conversation id
- if the interaction is not with a chat room, then Vorpal will sort the full JID of to and from of a packet and concatenate them giving us a unique conversation id
The advantage of implied conversation id over those explicity marked with <thread> element is that implied conversation supports all 3 types of packets (message, iq and presence) whereas <thread> is only supported in message. The down side of it is that because its implied viz we compute the conversation id using information from the packet, you are really at the mercy of this algorithmn and have no control over the conversation states.
Vorpal supports 2 types of conversation:
- implicit conversation – these are for a request response cycle; they are started automatically started automatically when you send IQ (get/set) packets and are terminated automatically when the corresponding IQ response (result/error) is received or vice versa
- explicit conversations – these are conversations that are started by the service by calling
Conversation.begin(). Under certain situation explicit conversations are also started automatically; however you must terminate the conversation. We’ll look at this in a future blog (of this series)
Conversation Examples from the Playground
I’ll go into the nitty gritty details of conversation in my next blog. For the impatient, have a look at Eliza in playground
. It contains 2 Netbeans
ElizaService is the external component that implements Eliza. I got the source here. To run it you need to define ‘arkham’ as a subdomain in your XMPP server and the shared secret is ‘ICannotSleep’. Or you can change the deployment settings
Arkham is a Java Eliza client
with Jabberocky. To verify that Eliza has been deployed successfully run a discovery service on it. The following screenshot from Gajim
shows Eliza service.
There are 2 ways of accessing Eliza.
- The first is to use a standard XMPP client like Gajim. Create a chat room (muc). Then send a direct invitation to
firstname.lastname@example.org_domain. Once Eliza has joined the chat room it will send a greeting to the root. Now you can interact with it by telling Eliza your problem. To end the therapy session, simply type quit or bye
- The second is to use Arkham which essentially does the same thing as 1 above. The only difference is that it will initiate a search of for the Eliza service first on the server before connecting. If it cannot find the service, it’ll notify you. Arkham uses client side Vorpal
Eliza shows how to use the client and the server to create a virtual conversation; I’ll be talking about this in greater detail in my next few blogs.
For those who want to check out these new features please download the latest from here
. If you have downloaded the package prior to July 29 2012, please download it again.
Note: I’m trying to get a hang Blogilo
after I’ve decided to change from ScribeFire
. So you’ll have to excuse me if there are any issues with formatting, etc.
Till next time