articleservice.java

版本信息：Jaoso新闻文章发布系统 0.9.1beta1 原POPTEN新闻发布系统现更名为Jaoso,不兼容popten,目前不提供popten升级Jaoso的程序.

package jaoso.news.service;

import jaoso.news.domain.Article;
import jaoso.news.domain.Critic;

import jaoso.news.exception.ArticleExistException;

import java.io.Serializable;

import java.util.Collection;


/**
 * @author chen_jian
 * @since 2004/6/23
 *
 */
public interface ArticleService {

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

    /**
     * 获取文章总数
     *
     * @return 文章总数
     */
    int getAllArticleCount();

    /**
     * DOCUMENT ME!
     *
     * @param args DOCUMENT ME!
     *
     * @return DOCUMENT ME!
     */
    Integer getArtCount(String[] args);

    /**
     * DOCUMENT ME!
     *
     * @param id DOCUMENT ME!
     *
     * @return DOCUMENT ME!
     */
    Article getArticle(final Serializable id);

    /**
     * 获取头条文章(置顶)
     *
     * @return 文章数组
     */
    Article[] getHotArticle();

    /**
     * 获取图片文章,放在首页显示的.
     *
     * @return 文章数组
     */
    Article[] getImageArticle();

    /**
     * 按目录获取最新更新的文章
     *
     * @param arg0 目录id
     *
     * @return 文章对象数组
     */
    Article[] getLastUpdate(Serializable arg0);

    /**
     * 获取首层目录及其子目录的最新更新文章
     *
     * @return map的集合每个map包含目录名及其文章数组
     */
    Collection getLastUpdate();

    /**
     * get top new articles
     *
     * @return article array
     */
    Article[] getTopNew();

    /**
     * get top read articles
     *
     * @return article array
     */
    Article[] getTopRead();

    /**
     * add a critic to article
     *
     * @param arg0 article id
     * @param arg1 critic
     */
    void addCritic(Serializable arg0, Critic arg1);

    /**
     * DOCUMENT ME!
     *
     * @param ids DOCUMENT ME!
     */
    void approveArticle(Serializable[] ids);

    /**
     * DOCUMENT ME!
     *
     * @param ids DOCUMENT ME!
     */
    void cancelArticle(Serializable[] ids);

    /**
     * DOCUMENT ME!
     *
     * @param article DOCUMENT ME!
     * @param upLoadFiles DOCUMENT ME!
     */
    void createArticle(final Article article, final Collection upLoadFiles)
        throws ArticleExistException;

    /**
     * DOCUMENT ME!
     *
     * @param args DOCUMENT ME!
     *
     * @return DOCUMENT ME!
     */
    Article[] find(String[] args);

    /**
     * DOCUMENT ME!
     *
     * @return DOCUMENT ME!
     */
    Article[] findAll();

    /**
     * Load a Article by name from Database
     * @return a Article instance
     * @param name String
     */
    Article findByName(final String name);

    /**
     * Remove a Article from Database
     *
     * @param ids article id array
     */
    void removeArticle(Serializable[] ids);

    /**
     * remove critic from article
     *
     * @param arg critic id array
     */
    void removeCritic(Serializable[] arg);

    /**
     * index search
     *
     * @param query search query and offset page num
     *
     * @return article array
     */
    Article[] search(String[] query);

    /**
     * DOCUMENT ME!
     *
     * @param article DOCUMENT ME!
     * @param upLoadFiles DOCUMENT ME!
     */
    void updateArticle(final Article article, final Collection upLoadFiles)
        throws ArticleExistException;

    /**
     * view article
     *
     * @param id article id
     *
     * @return article
     */
    Article viewArticle(Serializable id);
}