forumservice.java

一个jsp写的bbs

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 7.0
 */
public interface ForumService {

  /**
   * 保存或更新Forum对象
   * @param forum Forum
   * @return Forum
   * @throws BbscsException
   */
  public Forum saveForum(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 int getForumNum(long bid, int isNew, int delSign, int auditing);

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

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

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

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

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

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

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

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

  /**
   * 取得帖子列表
   * @param bid long
   * @param isNew int
   * @param delSign int
   * @param auditing int
   * @param orderby String
   * @param ascOrDesc int
   * @return List
   */
  public List findForums(long bid, int isNew, int delSign, int auditing, String orderby,
                         int ascOrDesc);

  /**
   * 取得帖子列表
   * @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 orderby String
   * @param ascOrDesc int
   * @param pages Pages
   * @return PageList
   */
  public PageList findForums(long bid, int isNew, int delSign, int auditing, String orderby,
                             int ascOrDesc, Pages pages);

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

  /**
   *
   * @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 orderby String
   * @param ascOrDesc int
   * @return List
   */
  public List findForumsTopic(long bid, String mainID, int delSign, int auditing, String orderby,
                              int ascOrDesc);

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

  /**
   * 取得同一主题帖子分页列表
   * @param bid long
   * @param mainID String
   * @param delSign int
   * @param auditing int
   * @param orderby String
   * @param ascOrDesc int
   * @param firstResult int
   * @param maxResults int
   * @return List
   */
  public PageList findForumsTopic(long bid, String mainID, int delSign, int auditing,
                                  String orderby, int ascOrDesc, 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);

  /**
   * 取得已删除同一主题帖子列表
   * @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 bids List
   * @param isNew int
   * @param delSign int
   * @param auditing int
   * @return int
   */
  public int getForumNumInBids(List bids, int isNew, int delSign, int auditing);

  /**
   * 取得指定版区下的帖子数量
   * @param bids List
   * @return int
   */
  public int getForumNumInBids(List bids);

  /**
   * 取得指定版区下的帖子列表
   * @param bids List
   * @param isNew int
   * @param delSign int
   * @param auditing int
   * @param orderby String
   * @param ascOrDesc int
   * @return List
   */
  public List findForumsInBids(List bids, int isNew, int delSign, int auditing, String orderby,
                               int ascOrDesc);

  /**
   * 取得指定版区下的帖子列表
   * @param bids List
   * @param isNew int
   * @param delSign int
   * @param auditing int
   * @param oo OrderObj[]
   * @return List
   */
  public List findForumsInBids(List bids, int isNew, int delSign, int auditing, OrderObj[] oo);

  /**
   * 取得指定版区下的帖子分页列表
   * @param bids List
   * @param isNew int
   * @param delSign int
   * @param auditing int
   * @param orderby String
   * @param ascOrDesc int
   * @param pages Pages
   * @return PageList
   */
  public PageList findForumsInBids(List bids, int isNew, int delSign, int auditing, String orderby,
                                   int ascOrDesc, Pages pages);

  /**
   * 取得指定版区下的帖子分页列表
   * @param bids List
   * @param isNew int
   * @param delSign int
   * @param auditing int
   * @param oo OrderObj[]
   * @param pages Pages
   * @return PageList
   */
  public PageList findForumsInBids(List bids, int isNew, int delSign, int auditing, OrderObj[] oo,
                                   Pages pages);

  /**
   * 取得指定版区下的帖子分页列表,WWW方式
   * @param bids List
   * @param pages Pages
   * @return PageList
   */
  public PageList findForumsInBidsWWW(List bids, Pages pages);

  /**
   * 取得指定版区下的帖子分页列表,顶帖方式
   * @param bids List
   * @param pages Pages
   * @return PageList
   */
  public PageList findForumsInBidsLastRe(List bids, Pages pages);

  /**
   * 取得指定版区下的帖子分页列表,不分主次
   * @param bids List
   * @param pages Pages
   * @return PageList
   */
  public PageList findForumsInBidsAll(List bids, Pages pages);

  /**
   * 取得精华帖列表
   * @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 int 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 int 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 int 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;

  /**
   * 发帖