/* 
 * IArticleTask.cs @Microsoft Visual Studio 2008 <.NET Framework 3.5>
 * AfritXia
 * 2007-12-05
 * 
 * Copyright(c) http://www.AfritXia.NET/
 * 
 */

using System;
using System.Collections.Generic;

using NET.AfritXia.MyHome.Model.Message;

namespace NET.AfritXia.MyHome.DBTask.Definition
{
	/// <summary>
	/// 文章任務(wù)接口
	/// </summary>
	public interface IArticleTask : IDBTask
	{
		/// <summary>
		/// 添加新文章
		/// </summary>
		/// <param name="newArticle">新文章</param>
		void Append(Article newArticle);

		/// <summary>
		/// 刪除文章
		/// </summary>
		/// <param name="articleUID">要?jiǎng)h除的文章 ID</param>
		void Delete(int articleUID);

		/// <summary>
		/// 更新文章
		/// </summary>
		/// <param name="newArticle">新文章</param>
		void Update(Article newArticle);

		/// <summary>
		/// 獲取文章列表
		/// </summary>
		/// <param name="orderGistValue">排序依據(jù)</param>
		/// <param name="startRecord">開(kāi)始記錄位置</param>
		/// <param name="maxRecords">返回結(jié)果的最大記錄個(gè)數(shù)</param>
		/// <param name="allRecordCount">總記錄個(gè)數(shù)</param>
		/// <returns></returns>
		IList<Article> GetArticleList(int orderGistValue, int startRecord, int maxRecords, out int allRecordCount);

		/// <summary>
		/// 瀏覽文章信息
		/// </summary>
		/// <param name="articleUID">要瀏覽的文章 ID</param>
		/// <returns></returns>
		Article ViewArticle(int articleUID);
	}
}