bspubsublistener.java

一款即时通讯软件

package edu.ou.kmi.buddyspace.plugins.pubsub.core;

/*
 * BSPubsubListener.java
 *
 * Project: BuddySpace
 * (C) Copyright Knowledge Media Institute 2003
 *
 *
 * Created on 3 October 2003, 11:23
 */

//import java.util.EventListener;
//import edu.ou.kmi.buddyspace.xml.*;

import org.jabber.jabberbeans.*;
import org.jabber.jabberbeans.util.*;

import edu.ou.kmi.buddyspace.core.*;
import edu.ou.kmi.buddyspace.plugins.pubsub.xml.*;

/**
 * <code>BSPubsubListener</code> is interface you can implement to get
 * pubsub events notifications.
 *
 * @author  Jiri Komzak, Knowledge Media Institute, Open University, United Kingdom
 */
public interface BSPubsubListener {
    /** Called when instant node created */
    public void instantNodeCreated(InfoQuery iq, String nodeName, String id);
    /** Called when result of subscription request received. */
    public void subscriptionResult(InfoQuery iq, PubsubEntity entity, String id);
    /** Called when result of affiliations request received. */
    public void affiliationsReceived(InfoQuery iq, PubsubAffiliations affs, String id);
    /** Called when result of options request received. */
    public void optionsReceived(InfoQuery iq, PubsubOptions options, String id);
    /** Called when result of items request received. */
    public void itemsReceived(InfoQuery iq, PubsubItems items, String id);
    /** Called when result of configure request received. */
    public void configureReceived(InfoQuery iq, PubsubOwnerOps configure, String id);
    /** Called when node entities received. */
    public void nodeEntities(InfoQuery iq, PubsubEntities entities, String id);
    
    /** Called when received items event - published or retracted items. */
    public void itemsEvent(Message m, PubsubEventItems items, String id);
    /** Called when node deleted event received */
    public void nodeDeletedEvent(Message m, String nodeName, String id);
    
    /** Called when an error occured */
    public void error(InfoQuery iq, String id);
    /** Called when a send fails */
    public void sendFailed(InfoQuery iq, String id);
    /** Called when empty result (possible of previous "set") received */
    public void receivedEmptyResult(InfoQuery iq, String id);
}