Использование адаптеров 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.