messagemanager.java

本项目为电子留言系统

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 
{
	int MESSAGE_PAGE_SIZE = 3;
	/**
	 * 创建一条消息
	 * @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)
		throws MessageException;

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

	/**
	 * 验证用户登录是否成功
	 * @param user 登录所用的用户名
	 * @param pass 登录所用的密码
	 * @param session 登录后需将用户名存入session
	 * @return 登录成功，返回用户的id，否则返回-1.
	 */
	int login(String user , String pass)
		throws MessageException;

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

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

	/**
	 * 获取消息数量
	 * @return 消息的数量
	 */
	int getMessageCount()throws MessageException;
	
	/**
	 * 根据每页记录数，总记录数获取总页数
	 * @param count 总记录数
	 * @param pageSize 每页显示的记录数
	 * @return 计算得到的总页数
	 */
	int getPageCount(int count , int pageSize);

}