Corda Services 101

Я нахожусь в настроении, чтобы написать короткую и основную статью сегодня. Мне действительно любопытно, как быстро я могу опубликовать это. Итак, начнем.

Этот пост о Corda Services (используется Corda версии 3.2 ). Кто они такие? Как разработчик, который часто использует Spring, я бы сказал, что они похожи на Beans. Spring Beans может сделать больше, но на базовом уровне они очень похожи. В любом случае, давайте прекратим говорить о весне и сосредоточимся на Корде.

Минимум, который вам нужно знать

Сервисы Corda — это классы, внешние по отношению к потокам, которые в настоящее время могут вызываться только из исполняющего потока или из другой службы (которая, в свою очередь, вызывается потоком). Подобно subFlow , они позволяют повторно использовать код, но должны использоваться по разным причинам. Например, набор функций запроса хранилища или инициирование trackBy внутри узла. Это то, для чего я склонен пользоваться услугами в любом случае.

Сервисы Corda определяются с помощью аннотации @CordaService вместе с расширением SingletonSerializeAsToken . Как только это будет сделано, когда ваш Cordapp загружен и узел запускается, служба, которую вы только что определили, будет инициализирована:

serviceHub предоставляет доступ ко всему, что вам нужно. В этом примере служба обращается к vaultService для получения состояний из хранилища узла.

Теперь он готов к использованию из ваших потоков или других служб, если это необходимо. Фрагмент ниже взят из одного из моих потоков:

serviceHub доступен во всех потоках и обеспечивает функцию cordaService . Для ввода требуется класс службы, которую вы пытаетесь получить. В этом случае MessageRepository загружается.

Чуть-чуть больше информации

Это все, что вам нужно, чтобы начать пользоваться Corda Services. Но. Я дам вам немного больше информации, чтобы вы не повторяли те же ошибки, что и я.

Урок первый. При звонке на услугу из потока. Не вводите его внутрь конструктора потока. Вместо этого вызывайте его изнутри функции call или любых других, использованных с этой точки. Если вы этого не сделаете, вы увидите следующее сообщение об ошибке:

Выше ошибка, которую вы получите при вызове потока из теста. Если вы звоните из RPC, вы получите что-то вроде этого:

Вероятно, с длинной трассировкой стека в зависимости от выбранного веб-фреймворка.

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

Просто чтобы сделать это еще яснее, ниже приведен код, который сопровождал более ранний фрагмент кода, где я внедрил службу:

Как видите, сервис внедряется в функцию repository которая в свою очередь call . Следуя такой структуре, все будет работать нормально.

Урок второй Не забудьте включить serviceHub: AppServiceHub в конструктор вашей службы (вы можете вызывать serviceHub как угодно). Если вы этого не сделаете, служба не будет создана, и при попытке доступа к ней появится следующая ошибка:

Хотя в этой ситуации есть луч надежды … Маловероятно, что вы это сделаете. Потому что без экземпляра AppServiceHub вы мало что можете сделать с собственным сервисом. У вас не будет доступа к хранилищу или другим встроенным службам. Итак, в конце дня этот урок немного бессмысленный, но я все же попал в эту ловушку …

Это все?

Блин, я думаю, что на самом деле я написал короткий пост на этот раз! Это хорошо или плохо? Я не уверен на 100% …

Во всяком случае, я очень стараюсь придумать еще несколько фрагментов информации. Но я не могу. Минимум, чтобы заставить Corda Service работать, действительно хорош и прост.

Тем не менее, за последние несколько недель я узнал, что есть некоторые очень интересные и полезные вещи, которые вы можете делать в сервисах, которые нельзя сделать в Flows. Это тема, которую я надеюсь охватить в какой-то момент!

Вывод

Сервисы Corda позволяют вам создавать классы, внешние по отношению к потокам, где вы можете логически группировать код, который не имеет прямого отношения к выполнению потока. Мой любимый способ использовать сервис — это сгруппировать функции запросов хранилища в один класс (почти то же, что я делал бы в мире Spring). Есть несколько шагов, которые необходимо предпринять, чтобы убедиться, что вы правильно создали свой сервис. Во-первых, аннотируйте его с помощью @CordaService и @CordaService SingletonSerializeAsToken . Во-вторых, убедитесь, что вы правильно внедрили их в свои потоки, что практически везде, кроме конструктора (или init в Kotlin). Наконец, не забудьте включить AppServiceHub в конструктор службы. Как только вы сможете использовать сервисы Corda, вы сможете отделить код от ваших потоков. Это не только делает потоки короче, но и облегчает их понимание, увеличивая возможность повторного использования кода, на который вы потратили свое драгоценное время.

Код, используемый для этого поста, можно найти на моем GitHub . В этом хранилище есть еще много чего, чего не было в этом посте.

Если вы нашли этот пост полезным, вы можете подписаться на меня в Twitter на @LankyDanDev, чтобы не отставать от моих новых сообщений.