catalogservice.java

来自「Jaoso新闻文章发布系统 0.9.1final 程序架构: Struts」· Java 代码 · 共 99 行

package jaoso.guestbook.service;

import jaoso.framework.service.IService;

import jaoso.guestbook.domain.GbCatalog;
import jaoso.guestbook.domain.Message;

import jaoso.news.exception.CatalogExistException;

import java.io.Serializable;

/**
 * @author Edgeloner [e-mail]
 * @since 2004-7-2
 */
public interface CatalogService extends IService {
	/**
	 * get a catalog by id
	 * 
	 * @param id
	 *            catalog id
	 * 
	 * @return catalog
	 */
	GbCatalog getCatalog(Serializable id);

	/**
	 * get Messages
	 * 
	 * @param args
	 *            String array {query parameter,catalog id, order by, sort,
	 *            page}
	 * 
	 * @return DOCUMENT ME!
	 */
	Message[] getMessages(String[] args);

	/**
	 * get query result count
	 * 
	 * @param args
	 *            String array {query parameter,catalog id, order by, sort,
	 *            page}
	 * 
	 * @return integer,result count
	 */
	Integer getResultCount(String[] args);

	/**
	 * add message to catalog
	 * 
	 * @param arg0
	 *            catalog id
	 * @param arg1
	 *            message
	 * @param arg2
	 *            parent message id
	 */
	void addMessage(Serializable arg0, Message arg1, Serializable arg2);

	/**
	 * create new catalog
	 * 
	 * @param arg0
	 *            catalog
	 */
	void createCatalog(GbCatalog arg0) throws CatalogExistException;

	/**
	 * find all catalog
	 * 
	 * @return DOCUMENT ME!
	 */
	GbCatalog[] findAll();

	/**
	 * remove catalog by id
	 * 
	 * @param id
	 *            catalog id
	 */
	void removeCatalog(Serializable id);

	/**
	 * remove message
	 * 
	 * @param arg0
	 *            message id
	 */
	void removeMessage(Serializable arg0);

	/**
	 * update catalog
	 * 
	 * @param arg0
	 *            catalog
	 */
	void updateCatalog(GbCatalog arg0) throws CatalogExistException;
}