Description

The Jabber plugin enables the usage of the XMPP protocol to communicate with Jabber servers. Relies on the Xmlrpc Plugin and the Smack/Smackx libraries.

Installation

The current version of griffon-jabber-plugin is 0.5
To install just issue the following command

griffon install-plugin jabber

Usage

The plugin will inject the following dynamic methods:

• XMPPConnection jabberConnect(Map params, Closure stmts) - connects to a Jabber server using the provided credentials

Where params may contain

Any additional params will be set on org.jivesoftware.smack.ConnectionConfiguration directly.

A new method is added to XMPPConnection in order to establish a chat session and send messages

• chatWith(String participant, String message)

If you wish to listen for incoming messages then you'll need to add a closure property (or a method) with the following signature on the instance that established the Jabber connection

def onJabberMessage = { msg -> ... }
// or as a method
void onJabberMessage(msg) { ... }

The type of the msg argument is org.jivesoftware.smack.packet.Message

Examples

Connecting to Gtalk

class GtalkController {
   def model
   private conn

   def connect = { evt = null ->
      conn = jabberConnect(host: "talk.google.com", port: 5222i,
                           serviceName: "gmail.com",
                           username: model.username,
                           password: model.password)
   }

   def sendMessage = { evt = null ->
      conn.chatWith(model.participant, model.message)
   }

   def onJabberMessage = { msg ->
       model.chatText = "${msg.from} said: '${msg.body}'"
   }
}

Configuration

Dynamic method injection

Dynamic methods will be added to controllers by default. You can change this setting by adding a configuration flag in Config.groovy

griffon.jabber.injectInto = ["controller", "service"]

History