編輯“SPB-設(shè)計(jì)機(jī)制-任務(wù)機(jī)制”

<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>導(dǎo)航:</strong> [[SpaceBuilde二次開發(fā)手冊|上一頁]]</span>
<div style="clear:both;"></div>

'''任務(wù)'''是[[SpaceBuilder]]提供的一種基礎(chǔ)服務(wù)，可以在配置文件中對任務(wù)進(jìn)行配置，然后這些任務(wù)會(huì)按照一定的時(shí)間間隔自動(dòng)運(yùn)行。

SpaceBuilder很多功能都需要依賴任務(wù)來完成，比如：
#SpaceBuilder.Components.ViewsTask，用于對各種對象進(jìn)行計(jì)數(shù)，但是并不是每次計(jì)數(shù)的變更都修改[[數(shù)據(jù)庫]]，而是把這些計(jì)數(shù)先保存在內(nèi)存中，然后每隔一段時(shí)間批量對數(shù)據(jù)庫進(jìn)行更新；
#SpaceBuilder.LuceneSearch.UserSearch.PersonUserIndexTask、SpaceBuilder.LuceneSearch.PostSearch.PostIndexTask，用于把數(shù)據(jù)庫中的變更定期更新到全文檢索的文件中；
#SpaceBuilder.Components.EmailTask，用于定期的把Email隊(duì)列的Email批量發(fā)送出去； …

下面主要介紹一下如何定義自己的任務(wù)，定義一個(gè)任務(wù)一般分為兩個(gè)步驟：

*開發(fā)一個(gè)Task；

在SpaceBuilder.config中進(jìn)行配置。

'''一、開發(fā)Task'''

編寫一個(gè)自己的Task非常簡單，只需要實(shí)現(xiàn)ITask接口即可。每次Task執(zhí)行時(shí)會(huì)自動(dòng)調(diào)用Execute方法。

[[Image:Spacebuilder096.jpg]]

'''例如'''，F(xiàn)ileThreadIndexTask.cs代碼如下：
<pre>

/// <summary>
/// 定期把FileThread的變更情況更新到Lucene索引文件
/// </summary>
public class FileThreadIndexTask : ITask
{
    /// <summary>
    /// 每次更新索引的最大數(shù)目
    /// </summary>
    private int count = 1000;

    #region ITask Members
    public void Execute(System.Xml.XmlNode node)
    {
        XmlAttribute countNode = node.Attributes["count"];
        if (countNode != null)
        {
            int.TryParse(countNode.Value, out count);
        }
        IndexPosts(count);
    }
    #endregion
}
</pre>

'''二、配置Task'''

開發(fā)完Task以后，必須在SpaceBuilder.config中進(jìn)行配置，它才會(huì)自動(dòng)運(yùn)行。以下代碼是一個(gè)典型的Task配置：

開發(fā)完Task以后，必須在SpaceBuilder.config中進(jìn)行配置，它才會(huì)自動(dòng)運(yùn)行。以下代碼是一個(gè)典型的Task配置：
<pre>
<Tasks>
    <Threads>
        <Thread minutes="5">
            <task name="FileThreadIndexTask"
                  type="SpaceBuilder.LuceneSearch.FileThreadIndexTask, SpaceBuilder.File.Web"
                  enabled="true"
                  enableShutDown="false" />
        </Thread>
    </Threads>
</Tasks>
</pre>
SpaceBuilder中的所有Task都是在Tasks節(jié)點(diǎn)進(jìn)行配置的，其中Tasks/Threads/Thread代表一個(gè)線程。
#針對每個(gè)線程中可以設(shè)置一個(gè)統(tǒng)一的時(shí)間間隔來執(zhí)行其中的Task，可以用分鐘、秒兩種單位來進(jìn)行設(shè)置，例如<Thread minutes="5">或者<Thread seconds="5">；
#針對每個(gè)Task可以設(shè)置enabled（是否啟用該Task）、enableShutDown（如果執(zhí)行時(shí)出現(xiàn)錯(cuò)誤是否允許關(guān)閉該Task）兩個(gè)屬性，這兩個(gè)屬性都是bool類型所以可以用“true”或“false”進(jìn)行配置；
#針對每個(gè)Task除了enabled、enableShutDown兩個(gè)屬性外還可以配置任何其他的屬性，但是除這兩個(gè)屬性以外的屬性只能在自己的Task中進(jìn)行解析及使用.

'''例如''':EmailTask：
<pre>
int failureInterval = 15;   //如果發(fā)送失敗,下一次多長時(shí)間再此發(fā)送(用分鐘表示)
            int numberOfTries = 10;     //發(fā)送失敗后的重試次數(shù)
            // Get the failureInterval setting
            XmlAttribute failureIntervalNode = node.Attributes["failureInterval"];
            XmlAttribute numberOfTriesNode = node.Attributes["numberOfTries"];
</pre>
'''三、典型用途'''
#SpaceBuilder.Common.CounterTask，用于對各種對象進(jìn)行計(jì)數(shù)。為了提升性能，但是并不是每次計(jì)數(shù)的變更都修改[[數(shù)據(jù)庫]]，而是把這些計(jì)數(shù)先保存在內(nèi)存中，然后每隔一段時(shí)間批量對數(shù)據(jù)庫進(jìn)行計(jì)數(shù)更新；
#SpaceBuilder.LuceneSearch.FileThreadIndexTask等，用于把數(shù)據(jù)庫中的變更定期更新到全文檢索的文件中；
#SpaceBuilder.Common.EmailTask，用于定期的把Email隊(duì)列的Email批量發(fā)送出去；
#SpaceBuilder.Common.UserVisitsTask，用于把訪客記錄定期的更新到數(shù)據(jù)庫中；


==參考資料==
*[http://doc.spacebuilder.cn SpaceBuilder官方]

[[category:SpaceBuilder|S]]