Когда нужен Интерфейс ресурсного сервиса

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

Когда Интерфейс ресурсного сервиса не нужен

Если описывается общая логика работы сервиса, а не его внешний вид — брать «Интерфейс сервиса» Если речь идет о данных, а не о методах и сигналах — брать «Информационная модель» Если нужно описать бизнес-процесс целиком, а не технический контракт — брать «Использование процесса»

Типичные ошибки: Интерфейс ресурсного сервиса

Путать этот контракт с общим интерфейсом сервиса, который может включать и другие типы операций. Считать, что контракт определяет внутреннюю реализацию, тогда как он описывает только внешний вид. Игнорировать сигналы, полагая, что в контракте фигурируют только методы.

Интерфейс ресурсного сервиса ResourceServiceInterface

На какой вопрос отвечает «Какие методы и сигналы описаны в контракте данного ресурсного сервиса?»

Это контракт, который фиксирует набор операций и реакций на события, доступных для ресурсных сервисов. Он описывает, какие действия сервис может выполнять и на какие сигналы обязан отвечать. Документ служит основой для взаимодействия с сервисом.

Аналогия Это как спецификация разъема, где прописано, какие команды можно отправить и какие уведомления сервис обязан обрабатывать.

Разобраться

Зачем это нужно

Нужен для того, чтобы разработчики знали, как именно обращаться к сервису, и чтобы сервисы были взаимозаменяемы при соблюдении этого контракта.

Применить

Когда это нужно, а когда нет

Когда нужно

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

Когда не нужно

Если описывается общая логика работы сервиса, а не его внешний вид — брать «Интерфейс сервиса»
Если речь идет о данных, а не о методах и сигналах — брать «Информационная модель»
Если нужно описать бизнес-процесс целиком, а не технический контракт — брать «Использование процесса»

Типичные ошибки

01Путать этот контракт с общим интерфейсом сервиса, который может включать и другие типы операций.
02Считать, что контракт определяет внутреннюю реализацию, тогда как он описывает только внешний вид.
03Игнорировать сигналы, полагая, что в контракте фигурируют только методы.

Сверить с первоисточниками