dbtool.java

华为短信网关实现的功能,包括服务器端和客户端代码

package com.fetion.cmpp.server.db;

import java.io.UnsupportedEncodingException;
import java.util.List;
import java.util.Map;

import com.fetion.cmpp.common.Message;
import com.sleepycat.je.DatabaseException;

/**
 * 服务器端对数据持久化的处理
 * @author Administrator
 *
 */
public interface DBTool {
	/**
	 * 打开数据库
	 * @return
	 * @throws DatabaseException
	 * @throws UnsupportedEncodingException
	 */
	public boolean openDB() throws DatabaseException,
			UnsupportedEncodingException;

	/**
	 * 关闭数据库
	 * @return
	 * @throws DatabaseException
	 */
	public boolean closeDB() throws DatabaseException;

	/**
	 * 新加未读的信息
	 * @param message
	 * @throws DatabaseException
	 */
	public void insertNewMessages(Message message) throws DatabaseException;

	/**
	 * 新加历史信息
	 * @param messages
	 * @throws DatabaseException
	 */
	public void insertHistoryMessages(List<Message> messages)
			throws DatabaseException;

	/**
	 * 取得所有的未读信息
	 * @return
	 */
	public Map<Long, Message> getAllNewMessages();

	/**
	 * 取得所有的历史信息
	 * @return
	 */
	public Map<Long, Message> getAllHistoryMessages();

	/**
	 * 根据删除所有的未读信息
	 * @param messages
	 * @throws DatabaseException
	 */
	public void deleteAllNewMessages(Map<Long, Message> messages)
			throws DatabaseException;
	
	/**
	 * 把已读信息删除，并存储到历史信息中
	 * @param messages
	 * @throws DatabaseException
	 */
	public void remarkHadSendMessages(Map<Long, Message> messages) throws DatabaseException;

	/**
	 * 根据参数删除所有的历史信息
	 * @param messages
	 * @throws DatabaseException
	 */
	public void deleteAllHistoryMessages(Map<Long, Message> messages)
			throws DatabaseException;
	
	/**
	 * 删除所有的未读信息
	 * @param messages
	 * @throws DatabaseException
	 */
	public void deleteAllNewMessages()throws DatabaseException;
	
	/**
	 * 删除所有的历史信息
	 * @param messages
	 * @throws DatabaseException
	 */
	public void deleteAllHistoryMessages()throws DatabaseException;
	
	/**
	 * 删除数据库信息
	 * @throws DatabaseException
	 */
	public void deleteDataBase() throws DatabaseException;
}