nuvem-api/src/main/java/org/apache/nuvem/cloud/xmpp/presence/PresenceManager.java

/*
 * Licensed to the Apache Software Foundation (ASF) under one

 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

package org.apache.nuvem.cloud.xmpp.presence;

import java.util.List;

/**
 * Manages Presence inboud and outboud stanzas, Each cloud platform will have
 * its own implementation of the PresenceManager.
 * 
 */
public interface PresenceManager {

    /**
     * Registers a presence listener to recieve notification of any presence
     * message recieved from the XMPP server.
     * 
     * @param listener
     */
    void registerListener(PresenceListener listener);

    /**
     * Returns a list of all {@link PresenceListener}s waiting to receive
     * presence stanzas.
     * 
     * @return
     */
    List<PresenceListener> listeners();

    /**
     * Sends the presence stanza to the XMPP server.
     * @param presence
     */
    void sendPresence(Presence presence);

}