org.jivesoftware.smackx.pep

Class PEPManager

java.lang.Object

org.jivesoftware.smack.Manager

org.jivesoftware.smackx.pep.PEPManager

public final class PEPManager
extends Manager

Manages Personal Event Publishing (XEP-163). A PEPManager provides a high level access to PubSub personal events. It also provides an easy way to hook up custom logic when events are received from another XMPP client through PEPListeners. Use example:

   PEPManager pepManager = new PEPManager(smackConnection);
   pepManager.addPEPListener(new PEPListener() {
       public void eventReceived(EntityBareJid from, EventElement event, Message message) {
           LOGGER.debug("Event received: " + event);
       }
   });
 

Method Summary

Modifier and Type	Method and Description
boolean	addPEPListener(PEPListener pepListener) Adds a listener to PEPs.
static PEPManager	getInstanceFor(XMPPConnection connection)
boolean	isSupported()
void	publish(Item item, String node) Publish an event.
boolean	removePEPListener(PEPListener pepListener) Removes a listener from PEP events.

Methods inherited from class org.jivesoftware.smack.Manager

connection, getAuthenticatedConnectionOrThrow, schedule

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstanceFor

public static PEPManager getInstanceFor(XMPPConnection connection)

addPEPListener

public boolean addPEPListener(PEPListener pepListener)

Adds a listener to PEPs. The listener will be fired anytime PEP events are received from remote XMPP clients.

Parameters:

pepListener - a roster exchange listener.

Returns:

true if pepListener was added.

removePEPListener

public boolean removePEPListener(PEPListener pepListener)

Removes a listener from PEP events.

Parameters:

pepListener - a roster exchange listener.

Returns:

true, if pepListener was removed.

publish

public void publish(Item item,
                    String node)
             throws SmackException.NotConnectedException,
                    InterruptedException,
                    SmackException.NoResponseException,
                    XMPPException.XMPPErrorException,
                    PubSubException.NotAPubSubNodeException

Publish an event.

Parameters:

item - the item to publish.

node - the node to publish on.

Throws:

SmackException.NotConnectedException

InterruptedException

XMPPException.XMPPErrorException

SmackException.NoResponseException

PubSubException.NotAPubSubNodeException

isSupported

public boolean isSupported()
                    throws SmackException.NoResponseException,
                           XMPPException.XMPPErrorException,
                           SmackException.NotConnectedException,
                           InterruptedException

Throws:

SmackException.NoResponseException

XMPPException.XMPPErrorException

SmackException.NotConnectedException

InterruptedException