bookservice.java

来自「一个基本的图书馆管理系统」· Java 代码 · 共 156 行

package c18.service;

import java.util.List;

import org.apache.struts.upload.FormFile;

import c18.entity.Book;
import c18.entity.Category;
import c18.helper.PageBean;
import c18.helper.PageResult;
import c18.struts.action.exception.ActionException;

/**
 * 图书服务接口类
 * @author yuxd
 *
 */
public interface BookService {
	/**
	 * 得到所有图书列表，支持分页
	 * @param pageBean
	 * @return
	 * @throws ActionException
	 */
	public PageResult getBooks(PageBean pageBean) throws ActionException;
	
	/**
	 * 得到分类下图书列表，支持分页
	 * @param categoryNo
	 * @param pageBean
	 * @return
	 * @throws ActionException
	 */
	public PageResult getBooksByCategory(int categoryNo, PageBean pageBean) throws ActionException;
	
	/**
	 * 根据关键字查询图书
	 * @param findKey
	 * @param findType
	 * @param pageBean
	 * @return
	 * @throws ActionException
	 */
	public PageResult findBooksByKey(String findKey, int findType, PageBean pageBean) throws ActionException;
	
	/**
	 * 得到图书信息
	 * @param bookNo
	 * @return
	 * @throws ActionException
	 */
	public Book getBook(int bookNo) throws ActionException;
	
	/**
	 * 得到图书相关的分类号数组
	 * @param bookNo
	 * @return
	 * @throws ActionException
	 */
	public String[] getCategoryNosByBook(int bookNo) throws ActionException;
	
	/**
	 * 增加图书
	 * @param book
	 * @param imageFile
	 * @param appPath
	 * @param categoryNos
	 * @throws ActionException
	 */
	public void addBook(Book book, FormFile imageFile, String appPath, int[] categoryNos) throws ActionException;
	
	/**
	 * 修改图书
	 * @param book
	 * @param imageFile
	 * @param appPath
	 * @param categoryNos
	 * @throws ActionException
	 */
	public void modBook(Book book, FormFile imageFile, String appPath, int[] categoryNos) throws ActionException;
	
	/**
	 * 删除图书
	 * @param bookNo
	 * @throws ActionException
	 */
	public void delBook(int bookNo) throws ActionException;

	/**
	 * 得到所有分类列表
	 * @return
	 * @throws ActionException
	 */
	public List getCategorys() throws ActionException;

	/**
	 * 得到分类下分类列表
	 * @param categoryNo
	 * @return
	 * @throws ActionException
	 */
	public List getCategorys(int categoryNo) throws ActionException;
	
	/**
	 * 根据分类号得到分类
	 * @param categoryNo
	 * @return
	 * @throws ActionException
	 */
	public Category getCategory(int categoryNo) throws ActionException;
	
	/**
	 * 得到分类的全路径,如/历史/中国近代史
	 * @param categoryNo
	 * @return
	 * @throws ActionException
	 */
	public String getCategoryFullName(int categoryNo) throws ActionException;
	
	/**
	 * 增加分类
	 * @param category
	 * @throws ActionException
	 */
	public void addCategory(Category category) throws ActionException;
	
	/**
	 * 修改分类信息
	 * @param category
	 * @throws ActionException
	 */
	public void modCategory(Category category) throws ActionException;
	
	/**
	 * 删除分类信息
	 * @param categoryNo
	 * @throws ActionException
	 */
	public void delCategory(int categoryNo) throws ActionException;
	
	/**
	 * 得到排序好的所有分类
	 * @return
	 * @throws ActionException
	 */
	public List getSortCategorys() throws ActionException;

	/**
	 * 得到分类下分类列表(带图书数)
	 * @param categoryNo
	 * @return
	 * @throws ActionException
	 */
	public List getCategorysBooks(int categoryNo) throws ActionException;
}