Использование адаптеров Qt D-Bus

Адаптеры — это специальные классы, которые прикрепляются к любому классу, производному от QObject, и обеспечивают интерфейс с внешним миром через D-Bus. Адаптеры предназначены для лёгких классов, основная задача которых — передавать вызовы к реальному объекту и от него, возможно, проверяя или преобразуя входные данные из внешнего мира, тем самым защищая реальный объект.

В отличие от множественного наследования, адаптеры можно добавлять к любому объекту в любое время (но не удалять), что обеспечивает большую гибкость при экспорте существующих классов. Ещё одно преимущество адаптеров — возможность предоставления сходной, но не идентичной функциональности в методах с одинаковыми именами в разных интерфейсах, что часто встречается при добавлении новой версии стандартного интерфейса к объекту.

Для использования адаптера необходимо создать класс, который наследуется от QDBusAbstractAdaptor. Поскольку это стандартный класс, производный от QObject, в объявлении должен присутствовать макрос Q_OBJECT, а исходный файл должен быть обработан инструментом moc. Класс также должен содержать одну запись Q_CLASSINFO с именем "D-Bus Interface" , указывающую, какой интерфейс он экспортирует. Поддерживается только одна запись на класс.

Любой публичный слот в классе будет доступен через шину через сообщения типа MethodCall. (См. Объявление слотов в адаптерах D-Bus для получения дополнительной информации). Сигналы в классе будут автоматически пересылаться по D-Bus. Однако не все типы разрешены в списке параметров сигналов или слотов: см. Системы типов Qt D-Bus для получения дополнительной информации.

Кроме того, любое свойство, объявленное с помощью Q_PROPERTY, будет автоматически экспонировано через интерфейс Свойства на D-Bus. Поскольку система свойств QObject не позволяет объявлять только для чтения свойства, невозможно объявить только для записи свойства, используя адаптеры.

Дополнительная информация:

• Объявление слотов в адаптерах D-Bus
• Объявление сигналов в адаптерах D-Bus
• Системы типов Qt D-Bus
• В примере D-Bus Complex Ping Pong, complexpong.h и complexpong.cpp демонстрируют реализацию QDBusAbstractAdaptor.

См. также QDBusAbstractAdaptor.