forumservice.java

天乙虚拟社区8.05版本。只支持Mysql

package com.laoer.bbscs.service;

import com.laoer.bbscs.bean.Forum;
import com.laoer.bbscs.exception.BbscsException;
import java.util.List;
import com.laoer.bbscs.service.web.PageList;
import com.laoer.bbscs.service.web.Pages;
import com.laoer.bbscs.comm.OrderObj;
import com.laoer.bbscs.bean.Board;
import com.laoer.bbscs.bean.UserInfo;
import com.laoer.bbscs.fio.UploadFile;
import com.laoer.bbscs.bean.Vote;
import com.laoer.bbscs.bean.ForumBuy;

/**
 * <p>
 * Title: TianyiBBS
 * </p>
 *
 * <p>
 * Description: BBSCS
 * </p>
 *
 * <p>
 * Copyright: Copyright (c) 2006
 * </p>
 *
 * <p>
 * Company: Laoer.com
 * </p>
 *
 * @author Laoer
 * @version 8.0
 */
public interface ForumService {

	/**
	 * 保存或更新Forum对象
	 *
	 * @param forum
	 *            Forum
	 * @return Forum
	 * @throws BbscsException
	 */
	public Forum saveOrUpdateForum(Forum forum) throws BbscsException;

	/**
	 *
	 * @param forum
	 * @return
	 * @throws BbscsException
	 */
	public Forum saveForum(Forum forum) throws BbscsException;

	/**
	 *
	 * @param forum
	 * @return
	 * @throws BbscsException
	 */
	public Forum updateForum(Forum forum) throws BbscsException;

	/**
	 * 根据ID取得Forum对象
	 *
	 * @param id
	 *            String
	 * @return Forum
	 */
	public Forum findForumByID(String id);

	/**
	 * 根据ID,Bid取得Forum对象
	 *
	 * @param id
	 *            String
	 * @param bid
	 *            long
	 * @return Forum
	 */
	public Forum findForumByID(String id, long bid);

	/**
	 * 取得帖子数量
	 *
	 * @param bid
	 *            long
	 * @param isNew
	 *            int
	 * @param delSign
	 *            int
	 * @param auditing
	 *            int
	 * @return int
	 */
	public long getForumNum(long bid, int isNew, int delSign, int auditing, int auditingAttachFile);

	/**
	 * 取得正常帖子数量
	 *
	 * @param bid
	 *            long
	 * @return int
	 */
	public long getForumNum(long bid);

	/**
	 * 取得主帖数量
	 *
	 * @param bid
	 *            long
	 * @return int
	 */
	public long getForumMainNum(long bid);

	/**
	 * 取得已删除帖子数量
	 *
	 * @param bid
	 *            long
	 * @return int
	 */
	public long getForumDelNum(long bid);

	/**
	 * 取得未审核帖子数量
	 *
	 * @param bid
	 *            long
	 * @return int
	 */
	public long getForumAuditingNum(long bid);

	/**
	 * 取得同一主题帖子数量
	 *
	 * @param bid
	 *            long
	 * @param mainID
	 *            String
	 * @param delSign
	 *            int
	 * @param auditing
	 *            int
	 * @return int
	 */
	public long getForumTopicNum(long bid, String mainID, int delSign, int auditing);

	/**
	 * 取得一个主题的帖子数量
	 *
	 * @param bid
	 *            long
	 * @param mainID
	 *            String
	 * @return int
	 */
	public long getForumTopicNum(long bid, String mainID);

	/**
	 * 取得一个主题已删除帖子数量
	 *
	 * @param bid
	 *            long
	 * @param mainID
	 *            String
	 * @return int
	 */
	public long getForumTopicDelNum(long bid, String mainID);

	/**
	 * 取得一个主题未审核帖子数量
	 *
	 * @param bid
	 *            long
	 * @param mainID
	 *            String
	 * @return int
	 */
	public long getForumTopicAuditingNum(long bid, String mainID);

	/**
	 * 取得帖子列表
	 *
	 * @param bid
	 *            long
	 * @param isNew
	 *            int
	 * @param delSign
	 *            int
	 * @param auditing
	 *            int
	 * @param oo
	 *            OrderObj[]
	 * @return List
	 */
	public List findForums(long bid, int isNew, int delSign, int auditing, OrderObj[] oo);

	/**
	 *
	 * @param bid
	 *            long
	 * @param isNew
	 *            int
	 * @param delSign
	 *            int
	 * @param auditing
	 *            int
	 * @param auditingAttachFile
	 *            int
	 * @param oo
	 *            OrderObj[]
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList findForums(long bid, int isNew, int delSign, int auditing, int auditingAttachFile, OrderObj[] oo,
			Pages pages);

	/**
	 * 取得主帖分页列表(WWW方式，发帖时间排序)
	 *
	 * @param bid
	 *            long
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList findForumsMainWWW(long bid, Pages pages);

	/**
	 * 取得主帖分页列表(顶帖方式，回复时间排序)
	 *
	 * @param bid
	 *            long
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList findForumsMainLastRe(long bid, Pages pages);

	/**
	 * 取得正常帖子分页列表，不分主从
	 *
	 * @param bid
	 *            long
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList findForumsAll(long bid, Pages pages);

	/**
	 * 取得已删除帖子分页列表
	 *
	 * @param bid
	 *            long
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList findForumsDel(long bid, Pages pages);

	/**
	 * 取得未审核帖子分页列表
	 *
	 * @param bid
	 *            long
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList findForumsAuditing(long bid, Pages pages);

	/**
	 * 取得同一主题帖子分页列表
	 *
	 * @param bid
	 *            long
	 * @param mainID
	 *            String
	 * @param delSign
	 *            int
	 * @param auditing
	 *            int
	 * @param oo
	 *            OrderObj[]
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList findForumsTopic(long bid, String mainID, int delSign, int auditing, OrderObj[] oo, Pages pages);

	/**
	 * 取得同一主题帖子分页列表
	 *
	 * @param bid
	 *            long
	 * @param mainID
	 *            String
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList findForumsTopic(long bid, String mainID, Pages pages);

	public List findForumsTopicAll(long bid, String mainID, int delSign, int auditing, OrderObj[] oo);

	/**
	 * 取得已删除同一主题帖子列表
	 *
	 * @param bid
	 *            long
	 * @param mainID
	 *            String
	 * @return List
	 */
	public List findForumsTopicDel(long bid, String mainID);

	/**
	 * 取得未审核同一主题帖子列表
	 *
	 * @param bid
	 *            long
	 * @param mainID
	 *            String
	 * @return List
	 */
	public List findForumsTopicAuditing(long bid, String mainID);

	/**
	 * 取得精华帖列表
	 *
	 * @param bid
	 *            long
	 * @param elite
	 *            long
	 * @param eliteId
	 *            long
	 * @return List
	 */
	public List findForumsElite(long bid, long elite, long eliteId);

	/**
	 * 取得搜索帖子数量
	 *
	 * @param bid
	 *            long
	 * @param con
	 *            String
	 * @param text
	 *            String
	 * @param delSign
	 *            int
	 * @param auditing
	 *            int
	 * @return int
	 */
	public long getSearchNum(long bid, String con, String text, int delSign, int auditing);

	/**
	 * 取得搜索结果分页列表
	 *
	 * @param bid
	 *            long
	 * @param con
	 *            String
	 * @param text
	 *            String
	 * @param delSign
	 *            int
	 * @param auditing
	 *            int
	 * @param orderby
	 *            String
	 * @param ascOrDesc
	 *            int
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList getSearchList(long bid, String con, String text, int delSign, int auditing, String orderby,
			int ascOrDesc, Pages pages);

	/**
	 * 取得搜索帖子数量
	 *
	 * @param bid
	 *            long
	 * @param con
	 *            String
	 * @param text
	 *            String
	 * @return int
	 */
	public long getSearchNum(long bid, String con, String text);

	/**
	 * 取得搜索结果分页列表
	 *
	 * @param bid
	 *            long
	 * @param con
	 *            String
	 * @param text
	 *            String
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList getSearchList(long bid, String con, String text, Pages pages);

	/**
	 * 取得自己的帖子数量
	 *
	 * @param userID
	 *            String
	 * @return int
	 */
	public long getForumOwnerNum(String userID);

	/**
	 * 取得自己的帖子分页列表
	 *
	 * @param userID
	 *            String
	 * @param isNew
	 *            int
	 * @param pages
	 *            Pages
	 * @return PageList
	 */
	public PageList findForumsOwner(String userID, int isNew, Pages pages);

	/**
	 * 删除Forum对象
	 *
	 * @param id
	 *            String
	 * @param bid
	 *            long
	 * @throws BbscsException
	 */
	public void removeForum(String id, long bid) throws BbscsException;

	/**
	 * 删除Forum对象
	 *
	 * @param id
	 *            String
	 * @throws BbscsException
	 */
	public void removeForum(String id) throws BbscsException;

	/**
	 * 删除Forum对象
	 *
	 * @param forum
	 *            Forum
	 * @throws BbscsException
	 */
	public void removeForum(Forum forum) throws BbscsException;

	/**
	 * 发帖
	 *
	 * @param forum
	 *            Forum
	 * @return Forum
	 * @throws BbscsException
	 */
	public Forum createForum(Forum forum) throws BbscsException;

	/**
	 * 发帖
	 *
	 * @param forum
	 *            Forum
	 * @param board
	 *            Board
	 * @param ui
	 *            UserInfo
	 * @param uploadFile
	 *            UploadFile
	 * @return Forum
	 * @throws BbscsException
	 */
	public Forum createForum(Forum forum, Board board, UserInfo ui, UploadFile uploadFile) throws BbscsException;