articleservice.java

Jaoso新闻文章发布系统 0.9.1final 程序架构: Struts+Spring+Hibernate 主要功能： ·新闻采用在线编辑器,可以象使用word一样编辑新闻,可简繁

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 {
	/**
	 * ��ȡ��������
	 * 
	 * @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);
}