Гайдар Магдануров - ASP.NET MVC Framework

...

}

Чтобы упростить процесс, существует альтернатива прямому инкрементированию и декрементированию. С помощью стандартной части AsyncControllerметода AsyncManager.RegisterTaskможно использовать связку из паттернов IAsyncResultи Event. Рассмотрим на примере:

public void XXX(Guid? userId)

{

AsyncManager.RegisterTask(

callback => BeginXXX(userId, callback, null),

asyncResult =>

{

UserData userData = EndXXX(asyncResult);

AsyncManager.Parameters["userData"] = userData;

}

);

}

public ActionResult XXXCompleted(UserData userData)

{

// ...

}

Во фрагменте кода используется паттерн Event, согласно которому создается два метода: xxxи xxxCompleted. Метод xxxрегистрирует асинхронную задачу с помощью механизма AsyncManager.RegisterTask, который принимает два параметра: анонимные функции, осуществляющие логику паттерна IAsyncResult. Первая функция вызывает метод Beginxxx, который выполняет некую асинхронную операцию. Вторая анонимная функция выполняется тогда, когда асинхронная операция заканчивается и ей передаются результаты вызова Beginxxx. Задача второй анонимной функции состоит в том, чтобы, используя метод Endxxxпаттерна IAsyncResult, получить значения параметров для метода XXXCompleted.

Преимущество данной связки паттернов состоит в том, что разработчику предоставляется возможность создавать несколько следующих подряд вызовов механизма AsyncManager.RegisterTask , которые выполняют разные асинхронные операции и формируют результаты разных параметров для метода XXXCompleted. Так как механизм AsyncManager.RegisterTask самостоятельно отслеживает инкремент и декремент свойства AsyncManager.OutstandingOperations, разработчику предлагается более безопасный и простой механизм создания нескольких асинхронных операций в одном запросе.

Этот паттерн похож на паттерн Eventс одним существенным отличием: отсутствует метод xxxComplete. Вместо этого метод xxxсам занимается возвращением результата ActionResultна основании данных, полученных от асинхронных операций. Так выглядит определение метода действия при использовании паттерна Delegate :

public Func Foo(Guid? userId)

Для демонстрации реализации данного паттерна перепишем пример паттерна Event по-другому:

public Func XXX(Guid userId)

{

UserData userData = new UserData();

AsyncManager.RegisterTask(

callback => BeginXXX(userId, callback, null),

asyncResult =>

{

userData = EndXXX(asyncResult);

}

);

return () => {

ViewData["userData"] = userData;

return View() ;

};

}

Главное отличие реализации паттерна Delegateв приведенном фрагменте от паттерна Eventсостоит в том, что для возвращения результата выполнения действия используется не ActionResult, а Func,который представляет собой анонимную функцию, возвращающую результат в виде ActionResult. По сравнению с паттерном Eventданный паттерн имеет упрощенный единый механизм, не разделенный на несколько методов, и максимально напоминает работу действий в синхронных контроллерах. При использовании этого паттерна у разработчика нет необходимости заботиться ни об обработке AsyncManager.OutstandingOperations, ни о заполнении AsyncManager.Parameters.

Для асинхронных операций важно понятие времени исполнения запроса, поэтому в стандартный механизм класса AsyncControllerвходит свойство AsyncManager.Timeout, которое позволяет задавать максимальное время ожидания результата выполнения асинхронного действия. В случае, когда действие выполняется дольше, чем определено в AsyncManager.Timeoutмеханизмом, будет вызвано исключение TimeoutException. Для более гибкого управления максимальным периодом ожидания ответа от действия механизм асинхронных контроллеров предлагает два атрибута: AsyncTimeoutAttributeи NoAsyncTimeoutAttribute. Первый устанавливает время ожидания для конкретного действия или контроллера, второй указывает, что ожидания ответа не должно вызвать исключения и ожидать ответа от асинхронного действия требуется без ограничения по времени.

Одним из ограничений механизма асинхронных контроллеров является ограничение на именование методов действий. Вы не можете называть методы действий с префиксами Begin, Endи суффиксом Completed. Это ограничение призвано предотвратить прямой вызов методов типа BeginXXX, EndXXXили XXXCompletedвместо вызова XXX. Тем не менее вы можете воспользоваться атрибутом ActionNameAttributeдля того, чтобы задать необходимый псевдоним методу действия. Следующий фрагмент демонстрирует это: