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 edgeloner@163.com
 * @since 2004-7-2
 */
public interface CatalogService extends IService {

    //~ Methods ================================================================

    /**
     * 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;
}