структура ara::com::FindServiceHandle

Структура ara::com::FindServiceHandle служит уникальным управляющим токеном для управления фоновым мониторингом сервисов (AUTOSAR_AP_EXP_ARAComAPI с. 34). Поскольку конструктор по умолчанию удален ([SWS_CM_00353]), дескриптор создается исключительно с помощью StartFindService и после получения асинхронных колбэков состояния обеспечивает направленное завершение поиска через StopFindService (AUTOSAR_AP_EXP_ARAComAPI с. 30). Поддерживаемые операторы сравнения гарантируют, кроме того, возможность сохранения и управления несколькими поисковыми запросами в стандартных контейнерах ([SWS_CM_11526], [SWS_CM_11527]).

больше ›

Контекст

Структура ara::com::FindServiceHandle функционирует в модуле com Adaptive Platform как уникальный идентификатор и управляющий токен для асинхронного непрерывного поиска сервисов. В то время как синхронный запрос через FindService выполняет однократный поиск подходящих экземпляров сервисов и непосредственно возвращает контейнеры дескрипторов, StartFindService инициирует постоянный мониторинг доступности сервисов в фоновом режиме (AUTOSAR_AP_EXP_ARAComAPI с. 34). В этом процессе обычно участвуют экземпляр приложения, типоспецифичный прокси-класс (например, RadarServiceProxy), а также пользовательская функция обратного вызова типа FindServiceHandler (AUTOSAR_AP_EXP_ARAComAPI с. 30). Конкретное внутреннее представление ara::com::FindServiceHandle выполнено специфичным для реализации соответствующего Communication Management, однако предоставляет стандартизированные C++-интерфейсы для обращения с ним.

Жизненный цикл

Жизненный цикл ara::com::FindServiceHandle жестко связан с активным процессом поиска в Communication Management:

• Создание: конструктор по умолчанию явно удален ([SWS_CM_00353]). Таким образом, приложение не может создавать экземпляры дескриптора неинициализированными или самовольно. Вместо этого валидный дескриптор генерируется исключительно как полезная нагрузка ara::core::Result статическим методом StartFindService (AUTOSAR_AP_EXP_ARAComAPI с. 30).
• Управление и владение: дескриптор поддерживает присваивание через оператор копирующего присваивания [SWS_CM_11528]. Чтобы позволить приложению сохранять и организовывать несколько поисковых запросов в стандартных контейнерах (таких как упорядоченные множества или ассоциативные массивы), данный тип удовлетворяет концепциям C++ [equalitycomparable] и [lessthancomparable] через операторы operator== ([SWS_CM_11526]) и operator< ([SWS_CM_11527]).
• Завершение и уничтожение: дескриптор сохраняет свою валидность до тех пор, пока активен фоновый мониторинг. Завершение поиска происходит путем передачи дескриптора в StopFindService (AUTOSAR_AP_EXP_ARAComAPI с. 30, AUTOSAR_AP_EXP_ARAComAPI с. 34). После этого вызова дескриптор больше не представляет выполняющийся процесс поиска.

Путь использования

Штатная последовательность включает регистрацию поискового запроса, непрерывное получение обновлений доступности и упорядоченную остановку процесса мониторинга:

1. Запуск поиска: приложение регистрирует FindServiceHandler через StartFindService, чтобы получать уведомления о вновь доступных или прекративших существование экземплярах сервисов (AUTOSAR_AP_EXP_ARAComAPI с. 30, AUTOSAR_AP_EXP_ARAComAPI с. 34).
2. Получение дескриптора: при успешном запуске вызов возвращает ara::core::Result с FindServiceHandle (AUTOSAR_AP_EXP_ARAComAPI с. 30), который приложение сохраняет для последующих управляющих вызовов.
3. Асинхронное уведомление: Communication Management выполняет фоновый поиск и при изменениях состояния вызывает предоставленный обработчик (AUTOSAR_AP_EXP_ARAComAPI с. 34).
4. Остановка поиска: как только экземпляры найдены или мониторинг больше не требуется, приложение передает дескриптор в StopFindService (AUTOSAR_AP_EXP_ARAComAPI с. 30, AUTOSAR_AP_EXP_ARAComAPI с. 34).

Диаграмма последовательности: типичный процесс асинхронного поиска сервисов от регистрации и уведомлений до завершения через FindServiceHandle. Источники: AUTOSAR_AP_EXP_ARAComAPI с. 30, AUTOSAR_AP_EXP_ARAComAPI с. 34.

Сценарии ошибок

При использовании ara::com::FindServiceHandle необходимо учитывать следующие системные граничные условия:

• Неудачный запуск поиска: если технические привязки недоступны или конфигурация развертывания сервиса ошибочна (AUTOSAR_AP_EXP_ARAComAPI с. 34), StartFindService завершается сбоем. Возвращаемый ara::core::Result в этом случае содержит не валидный дескриптор, а код ошибки (AUTOSAR_AP_EXP_ARAComAPI с. 30).
• Безопасность исключений: реализованные операторы сравнения и присваивания operator== ([SWS_CM_11526]), operator< ([SWS_CM_11527]) и operator= ([SWS_CM_11528]) в спецификации явно объявлены как небезопасные относительно исключений (not exception safe).
• Многократная остановка: повторный вызов StopFindService с тем же дескриптором, по-видимому, останется безрезультатным или приведет к ошибке времени выполнения, поскольку базовая активность мониторинга уже была удалена. Вопрос Q-f44130c33fa1caea (открытый)