view Implab/IPromise.cs @ 105:4d308952fd5e v2

minor fixes
author cin
date Mon, 10 Nov 2014 10:17:54 +0300
parents 5f10d54b45df
children 2573b562e328
line wrap: on
line source

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace Implab {
    public interface IPromise: ICancellable {
        /// <summary>
        /// Check whereather the promise has no more than one dependent promise.
        /// </summary>
        bool IsExclusive {
            get;
        }

        /// <summary>
        /// Тип результата, получаемого через данное обещание.
        /// </summary>
        Type PromiseType { get; }

        /// <summary>
        /// Обещание является выполненым, либо успешно, либо с ошибкой, либо отменено.
        /// </summary>
        bool IsResolved { get; }

        /// <summary>
        /// Обещание было отменено.
        /// </summary>
        bool IsCancelled { get; }

        IPromise Then(Action success, Action<Exception> error, Action cancel);
        IPromise Then(Action success, Action<Exception> error);
        IPromise Then(Action success);

        IPromise Chain(Func<IPromise> chained, Func<Exception, IPromise> error, Action cancel);
        IPromise Chain(Func<IPromise> chained, Func<Exception, IPromise> error);
        IPromise Chain(Func<IPromise> chained);

        /// <summary>
        /// Добавляет последнй обработчик в цепочку обещаний, не создает промежуточных обещаний.
        /// </summary>
        /// <param name="success">Success.</param>
        /// <param name="error">Error.</param>
        /// <param name="cancel">Cancel.</param>
        void On(Action success, Action<Exception> error, Action cancel);
        void On(Action success, Action<Exception> error);
        void On(Action success);
        void On(Action success, PromiseEventType events);

        IPromise Error(Action<Exception> error);
        /// <summary>
        /// Обрабатывает либо ошибку, либо результат, либо отмену.
        /// </summary>
        /// <param name="handler">Обработчик.</param>
        /// <remarks>После обработке ошибки, она передается дальше.</remarks>
        /// <summary>
        /// Обрабатывает либо ошибку, либо результат, либо отмену обещания.
        /// </summary>
        /// <param name="handler">Обработчик.</param>
        /// <remarks>После обработке ошибки, она передается дальше.</remarks>
        IPromise Anyway(Action handler);
        /// <summary>
        /// Обработчик для регистрации отмены обещания.
        /// </summary>
        /// <returns>Новое обещание, связанное с текущим, выполнится после указанного обработчика.</returns>
        /// <param name="handler">Обработчик события.</param>
        /// <remarks>Если обработчик вызывает исключение, то оно передается обработчику ошибки, результат работы
        /// которого будет передан связанному обещанию</remarks>
        IPromise Cancelled(Action handler);

        /// <summary>
        /// Преобразует результат обещания к заданному типу и возвращает новое обещание.
        /// </summary>
        IPromise<T> Cast<T>();

        /// <summary>
        /// Синхронизирует текущий поток с обещанием.
        /// </summary>
        void Join();
        /// <summary>
        /// Синхронизирует текущий поток с обещанием.
        /// </summary>
        /// <param name="timeout">Время ожидания, по его истечению возникнет исключение.</param>
        /// <exception cref="TimeoutException">Превышено время ожидания.</exception>
        void Join(int timeout);

    }
}