/**
 * 文件名: RtcService.java    2012-7-17
 */
package com.gxzy.framework.comm.rtc.service;

import java.util.List;

import javax.servlet.AsyncContext;

import com.gxzy.framework.comm.rtc.entity.RtcMessage;
import com.gxzy.framework.util.bean.Pagination;

/**
 * 即时通讯服务接口
 * @作者 AMY
 * @版本 1.0
 */
public interface RtcService
{
	
	public List<RtcMessage> list(String username,Integer limit);
	
	
	Pagination<RtcMessage> list(Pagination<RtcMessage> page,String username);
	
    /**
     * 发送一条消息到指定用户
     * @param msg 消息(消息中必须指定好接收用户)
     */
    public void sendToOne(RtcMessage msg);
    
    /**
     * 发送消息到所有在线用户
     * @param msg 消息(消息体中指定的接收用户名不会被使用)
     */
    public void sendToAllOnline(RtcMessage msg);
    
    /**
     * 发送消息到除了发送者之外的所有在线用户
     * @param msg 消息(必须指定发送者)
     */
    public void sendToAllOthersOnline(RtcMessage msg);
    
    /**
     * 唤醒一个已存在的连接
     * @param key 关键字段
     */
    public void wakeupConnection(String key);
    
    /**
     * 初始化一个新连接
     * @param key 关键字段
     */
    public void setupConnection(String username, AsyncContext context);
    
    public void deleteMessages(String username);
    
    void readMessage(String msgId);
    
    void deleteMessage(List<String> msgId);
}