org.jivesoftware.smackx.pep

Class PEPManager

java.lang.Object

org.jivesoftware.smackx.pep.PEPManager

public class PEPManager
extends Object

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(String inFrom, PEPEvent inEvent) {
           LOGGER.debug("Event received: " + inEvent);
       }
   });

   PEPProvider pepProvider = new PEPProvider();
   pepProvider.registerPEPParserExtension("http://jabber.org/protocol/tune", new TuneProvider());
   ProviderManager.getInstance().addExtensionProvider("event", "http://jabber.org/protocol/pubsub#event", pepProvider);
   
   Tune tune = new Tune("jeff", "1", "CD", "My Title", "My Track");
   pepManager.publish(tune);
 

Author:

Jeff Williams

Constructor Summary

Constructors

Constructor and Description
PEPManager(XMPPConnection connection) Creates a new PEP exchange manager.

Method Summary

Modifier and Type	Method and Description
void	addPEPListener(PEPListener pepListener) Adds a listener to PEPs.
void	destroy()
protected void	finalize()
void	publish(PEPItem item) Publish an event.
void	removePEPListener(PEPListener pepListener) Removes a listener from PEP events.

Methods inherited from class java.lang.Object

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

Constructor Detail

PEPManager

public PEPManager(XMPPConnection connection)

Creates a new PEP exchange manager.

Parameters:

connection - an XMPPConnection which is used to send and receive messages.

Method Detail

addPEPListener

public void 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.

removePEPListener

public void removePEPListener(PEPListener pepListener)

Removes a listener from PEP events.

Parameters:

pepListener - a roster exchange listener.

publish

public void publish(PEPItem item)
             throws SmackException.NotConnectedException

Publish an event.

Parameters:

item - the item to publish.

Throws:

SmackException.NotConnectedException

destroy

public void destroy()

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable