boardservice.java

一个jsp写的bbs

package com.laoer.bbscs.service;

import com.laoer.bbscs.bean.Board;
import com.laoer.bbscs.exception.BbscsException;
import java.util.List;
import java.util.Map;

/**
 * <p>Title: Tianyi BBS</p>
 *
 * <p>Description: BBSCS</p>
 *
 * <p>Copyright: Copyright (c) 2006</p>
 *
 * <p>Company: Laoer.com</p>
 *
 * @author Gong Tianyi
 * @version 7.0
 */
public interface BoardService {

  /**
   * 保存或更新Board对象
   * @param board Board
   * @return Board
   * @throws BbscsException
   */
  public Board saveBoard(Board board) throws BbscsException;

  /**
   *
   * @param board Board
   * @return Board
   * @throws BbscsException
   */
  public Board createBoard(Board board) throws BbscsException;

  /**
   * 更新Board对象
   * @param board Board
   * @return Board
   * @throws BbscsException
   */
  public Board updateBoard(Board board, long oldParentID) throws BbscsException;

  /**
   * 根据ID取得Board对象
   * @param id long
   * @return Board
   */
  public Board getBoardByID(long id);

  /**
   * 根据parentID取得Board对象列表
   * @param pid long
   * @return List
   */
  public List findBoardsByParentID(long pid);

  /**
   * 根据parentID取得Board对象列表
   * @param pid long
   * @param useStat int
   * @param hidden int
   * @param orderType int
   * @return List
   */
  public List findBoardsByParentID(long pid, int useStat, int hidden, int orderType);

  /**
   * 生成版区树
   * @param pid int
   * @param topList List
   * @return List
   */
  public List findBoardsAllTree(long pid, List topList);

  /**
   *
   * @param pid long
   * @param topList List
   * @param useStat int
   * @param hidden int
   * @param orderType int
   * @return List
   */
  public List findBoardsAllTree(long pid, List topList, int useStat, int hidden, int orderType);

  /**
   * 根据parentID预取得Board序列
   * @param pid long
   * @return int
   */
  public int getNextOrder(long pid);

  /**
   * 取得帖子总数（主帖或全部）
   * @param mainorall int
   * @param useStat int
   * @param hidden int
   * @return int
   */
  public int getPostSumNum(int mainorall, int useStat, int hidden);

  /**
   * 删除Board对象
   * @param board Board
   * @throws BbscsException
   */
  public void removeBoard(Board board) throws BbscsException;

  /**
   *
   * @param boards List
   * @return List
   */
  public List getBoardIDs(List boards);

  /**
   * 取得版区用户组全县
   * @param bid long
   * @param groupID int
   * @return Map[]
   */
  public Map[] getBoardPermission(long bid, int groupID);

  /**
   *
   * @param roleID int
   * @return Map[]
   */
  public Map[] getBoardMasterPermission(int roleID);

  /**
   *
   * @param board Board
   * @param userName String
   * @return boolean
   */
  public boolean isBoardMaster(Board board, String userName);

  /**
   * 根据指定ID取得Board列表
   * @param ids List
   * @param useStat int
   * @param hidden int
   * @return List
   */
  public List findBoardsInIDsInSameLevel(List ids, int useStat, int hidden);

  /**
   *
   * @param ids List
   * @return List
   */
  public List findBoardsInIDs(List ids);

  /**
   * 取得父级版区列表，以ids的顺序取出
   * @param ids List
   * @return List
   */
  public List findParentBoards(List ids);

  /**
   *
   * @param useStat int
   * @param hidden int
   * @return List
   */
  public List findBoardsNeedCount(int useStat, int hidden);

  /**
   *
   * @param boardlist List
   * @return List
   */
  public List getBoardsNeedCount(List boardlist);

  /**
   *
   * @throws BbscsException
   */
  public void saveBoardsPostNumCount() throws BbscsException;

  /**
   *
   * @param bid long
   */
  public void createBoardListFileInForumCover(long bid);

  /**
   *
   * @param bid long
   */
  public void createBoardHotListFileInForumCover(long bid);

  /**
   *
   */
  public void createBoardFileInForumCover();

  /**
   *
   * @param board Board
   * @param tagID String
   * @throws BbscsException
   */
  public void removeBoardTag(Board board, String tagID) throws BbscsException;

}