Объект
CashMaticRequest является средством управления выполнением асинхронного запроса (в текущей версии асинхронные запросы создаются методами создаются методами
GetDeviceProtocol() и
GetDeviceIdentification() объекта
CashMaticCash, в дальнейшем предполагается расширение применения этого механизма в
NDemia CashMatic).
Объект создаётся в результате запуска асинхронного запроса (см.
Примеры опроса идентификации купюроприёмника).
Удаление объекта приводит к отмене запроса. Однако используемый в javascript механизм "сборки мусора" (garbage collection) может при освобождении всех ссылок на объект задерживать удаление объекта на неопределённое время, поэтому для отмены (досрочного завершения) запроса предусмотрен метод
CancelRequest().
Свойство
RequestCompleted является логическим флагом (признаком) завершения запроса, значение меняется с ложного на истинное при завершении запроса (с любым результатом, по любой причине).
Свойство
ResultHandler содержит ссылку на указанный при запуске асинхронного запроса обработчик результата запроса (интерфейс
CashMaticResultHandler). После запуска запроса обработчик не может быть удалён или заменён до завершения запроса. При завершении запроса результат выполнения запроса передаётся этому обработчику.
Имя | Тип результата | Тип обращения | Назначение |
CancelRequest() | Пустой | Метод | Прервать или отменить выполнение запроса.
Выполняется нормальная обработка завершения запроса:
обработчик ResultHandler вызывается (с результатом, соответствующим отмене - в зависимости от спецификации запроса);
свойство RequestCompleted принимает истинное значение.
|
RequestCompleted | Логический | Свойство, только чтение | Флаг завершения запроса.
ложное значение: запрос не завершён (выполняется);
истинное значение: запрос завершён (выполнен).
|
RequestId | Число | Свойство, только чтение | Идентификатор запроса.
Каждый запрос (объект CashMaticRequest) имеет постоянный во времени ненулевой идентификатор, уникальный среди одновременно существующих запросов.
|
RequestSubject | Строка | Свойство, только чтение | Кратко сформулированный предмет запроса (в человекочитаемом виде, для отладочных целей). |
ResultHandler | Объект CashMaticResultHandler | Свойство, только чтение | Обработчик результата запроса - объект CashMaticResultHandler. |
Совместимость: объект CashMaticRequest поддерживается в NDemia CashMatic, начиная с версии 2.6.0