messagemanager.java

ajax-dwr方式的即时消息演示程序 jsp-servlet,ajax技术实现

package org.yeeku.service;

import org.yeeku.exception.*;
import org.yeeku.vo.*;

import java.util.List;
import javax.servlet.http.HttpServletRequest;

/**
 * @author  yeeku.H.lee [e-mail]
 * @version  1.0
 * <br>Copyright (C), 2005-2008, yeeku.H.Lee
 * <br>This program is protected by copyright laws.
 * <br>Program Name:
 * <br>Date: 
 */
public interface MessageManager 
{
	/**
	 * 创建一条消息
	 * @param title 新信息的标题
	 * @param content 新消息的父节点
	 * @param userId 创建消息的用户Id
	 * @return 新创建消息的主键,如果创建失败，返回-1。
	 */
	int createMessage(String title , String content , int userId)
		throws MessageException;

	/**
	 * 创建一个用户
	 * @param user 新创建用户的用户名
	 * @param pass 新创建用户的密码
	 * @return 新创建用户的主键
	 */
	int createUser(String user , String pass , HttpServletRequest request)
		throws MessageException;

	/**
	 * 验证用户名是否可用,本系统不允许用户名重复
	 * @param user 需要验证的用户名
	 * @return 该用户名不重复，可用，返回true，否则返回false
	 */
	boolean valid(String user)
		throws MessageException;

	/**
	 * 验证用户登陆是否成功
	 * @param user 登陆所用的用户名
	 * @param pass 登陆所用的密码
	 * @param session 登陆后需将用户名存入session
	 * @return 登陆成功，返回true；否则返回false
	 */
	boolean login(String user , String pass , HttpServletRequest request)
		throws MessageException;

	/**
	 * 当前页面的浏览者是否登陆
	 * @param session 判断用户是否登陆是通过跟踪session
	 * @return 已经登陆返回当前用户ID，否则返回-1
	 */
	int isLogin(HttpServletRequest request)
		throws MessageException;


	/**
	 * 根据消息ID返回消息
	 * @param id 消息ID
	 * @return 指定ID对应的消息
	 */
	MessageBean getMessage(int id)
		throws MessageException;

	/**
	 * 返回特定页面所有消息
	 * @param pageNo 指定页码
	 * @return 指定页的全部消息
	 */
	List<MessageBean> getAllMessageByPage(int pageNo)
		throws MessageException;	
}