Введение
При разработке приложений, периодически возникают задачи, требующие одновременного выполнения нескольких процессов. В платформе 1С:Предприятие данная функциональность реализована при помощи механизма фоновых заданий. В стандартной поставке OneScript данная функциональность отсутствует, поэтому целью настоящей статьи является описание библиотеки, которая реализует механизм фоновых заданий в web-приложениях (http-сервисах) OneScript.
Описание
Библиотека реализует типы МенеджерФоновыхЗаданийWeb, СостояниеФоновогоЗадания и ФоновоеЗаданиеWeb, которым в платформе 1С:Предприятие соответствуют типы МенеджерФоновыхЗаданий и ФоновоеЗадание соответственно.
Реализованные типы
МенеджерФоновыхЗаданийWeb
Методы:
- Выполнить
- ОжидатьЗавершения
- ПолучитьФоновыеЗадания
ФоновоеЗаданиеWeb
Свойства:
- ИмяМетода
- ИнформацияОбОшибке
- Ключ
- Конец
- Наименование
- Начало
- РазделениеДанных
- РегламентноеЗадание
- Состояние
- УникальныйИдентификатор
Методы:
- ОжидатьЗавершения
- Отменить
- ПолучитьСообщенияПользователю
СостояниеФоновогоЗадания
Аналогичен соответствующему типу в 1С:Предприятие.
Отличия от платформы 1С:Предприятие
Библиотека практически полностью совместима с платформой 1С:Предприятие на уровне кода, однако все-же имеются незначительные отличия:
ФоновыеЗаданияWeb.ПолучитьФоновыеЗадания
В отличие от 1С:Предприятие, где фоновые задания хранятся в информационной базе и Вы можете получить примерно 1000 последних фоновых заданий, запущенных на выполнение, текущая реализация библиотеки имеет динамический список выполняемых заданий. Задания помещаются в список при вызове метода Выполнить и удаляются после завершения фонового задания. Таким образом, в отличие от 1С:Предприятие, метод возвращает фоновые задания, которые выполнялись на момент вызова метода или были завершены, но еще не удалены из списка.
ФоновоеЗаданиеWeb.РазделениеДанных
Всегда возвращает пустую структуру
ФоновоеЗаданиеWeb.РегламентноеЗадание
Ввиду отсутствия регламентных заданий, всегда возвращает Неопределено.
ФоновоеЗаданиеWeb.Отменить
Ввиду особенностей реализации, вызов этого метода не приводит к каким-либо действиям (задание продолжает выполнение и не отменяется).
ФоновоеЗаданиеWeb.ПолучитьСообщенияПользователю
Всегда возвращает пустой фиксированный массив.
Установка
Предварительные условия
Для использованиия настоящей библиотеки, необходимо установить обновление платформы OneScript, которое улучшает многопоточность http-сервисов OneScript.
Обновление для OneScript версии 1.0.19 можно скачать по нижеследующей ссылке: ASPNETHandler-v1.1-1.0.19.zip . Установка производится простым копированием содержимого архива, поверх файлов поставки OneScript.
Описание обновления, а также сопутствующих библиотек доступно по ссылке.
Установка библиотеки
Установка осуществляется копированием файлов dll в папку Bin веб-приложения. Затем, необходимо подключить библиотеку, добавив нижеследующую строку в секцию <appSettings>, файла web.config:
<add key="WebBackgroundJobs" value="attachAssembly" />
Настроить интервал проверки состояния фоновых заданий для метда ОжидатьЗавершения, можно добавив в раздел <appSettings>, файла web.config нижеследующий ключ:
<add key="jobsCheckInterval" value="5000" />
Интервал задается в миллисекундах. Интервал проверки по умолчанию (если ключ не установлен) составляет 1000 миллисекунд.
Использование
Ниже приведен фрагмент кода, иллюстрирующий работу библиотеки:
// Создаем объект менеджера фоновых заданий. Только для OneScript
//<OneScript>
ФоновыеЗадания = Новый МенеджерФоновыхЗаданийWeb;
//<!OneScript>
// Запускаем фоновые задания на выполнение
МассивПараметров = Новый Массив;
МассивПараметров.Добавить(1);
МассивПараметров.Добавить("1.txt");
ФоновыеЗадания.Execute("Тестовый.ТестовоеФЗ", МассивПараметров, "Ключ1", "Описание1");
МассивПараметров = Новый Массив;
МассивПараметров.Добавить(1);
МассивПараметров.Добавить("2.txt");
ФоновыеЗадания.Execute("Тестовый.ТестовоеФЗ", МассивПараметров);
// Получаем все выполняющиеся задания
МассивЗаданий = ФоновыеЗадания.ПолучитьФоновыеЗадания();
// Ожидаем завершения выполнения запущеных заданий
ФоновыеЗадания.ОжидатьЗавершения(МассивЗаданий);
// Продолжаем выполнение
Заключение
Надеюсь, что использование настоящей библиотеки, совместно с библиотеками обработки контента , работы с субд и кэширования данных, позволят вам создавать “взрослые” web-приложения на базе каркасной конфигурации, которые совместно с 1С:Предприятие, позволяют решать реальные бизнес-задачи ваших клиентов.
