Использование Cloud Pub / Sub на Node.js из Kotlin / JS

Почему Kotlin / JS?

Kotlin обычно используется для интерфейсной работы JVM, но, как показано в предыдущем посте о Kotlin и JVM , Kotlin также может неплохо работать на стороне сервера. Чтобы поддерживать полный стек Kotlin в веб-приложении, был разработан Kotlin / JS .

Kotlin / JS - это в основном стандартный компилятор Kotlin, но вместо записи в байт-код JVM он переносит * в JavaScript. В этой ситуации он служит почти той же цели, что и TypeScript, обеспечивая безопасность типов и синтаксический сахар для некоторых общих операций. Как и TypeScript, он также предоставляет концепцию внешней типизации для библиотек JavaScript. Используя утилиту Dukat, можно также преобразовать типизацию TypeScript в типизацию Kotlin, что упрощает обеспечение полной безопасности типов в приложении Kotlin / JS.

* Транспиляция похожа на компиляцию, но это преобразование с одного удобочитаемого языка на другой, а не с двоичного кода.

С Kotlin как на стороне клиента, так и на стороне сервера, обычно используя React и JVM, соответственно, можно напрямую совместно использовать некоторый код, например общую бизнес-логику и классы данных. Также можно использовать существующие компетенции в Kotlin для команды, разрабатывающей вертикальный стек приложений.

Kotlin / JS… на узле?

Да, это правда! Поскольку Kotlin / JS - это просто транспилятор, также можно запустить полученный код, используя среду выполнения Node.js. Это дает вам возможность создавать очень легкие серверные процессы с использованием всех существующих библиотек, совместимых с Node, из npm / yarn, оставаясь в Kotlin для всего приложения .

Предостережения

Эта статья проведет вас через создание приложения Kotlin / JS, которое работает в Node.js и использует библиотеки Node.js Pub / Sub для взаимодействия с Google Cloud Pub / Sub . Обратите внимание, что мы не рекомендуем делать это для вашей производственной работы в настоящее время ; эта статья в основном для любопытных!

Настройка проекта

Начните с установки новой версии Node.js . Вы также можете установить его с помощью nvm , но вам нужно будет указать путь к npm в настройках проекта ниже.

Откройте IntelliJ IDEA или Android Studio и создайте проект Kotlin / JS, ориентированный на Node.js. На данный момент новый компилятор IR все еще является экспериментальным, поэтому я рекомендую использовать LEGACY, чтобы упростить задачу. (К тому времени, когда вы это прочтете, это может быть не так.)

Чтобы работать с библиотеками Pub / Sub, мы должны добавить их в нашу конфигурацию сборки Gradle. Отредактируйте файл build.gradle.kts и добавьте следующую строку:

Как следует из комментария, вы обычно можете включить generateExternals, и он будет вызывать Dukat для автоматического преобразования любых типов TypeScript в @ google-cloud / pubsub . К сожалению, в настоящее время это не удается, поэтому мы сделаем наши собственные очень простые типы набора!

Типы Kotlin / JS

Чтобы вызвать библиотеку Pub / Sub типобезопасным способом, нам нужно добавить некоторые типы. Мне нравится создавать файлы с тем же соглашением об именах, что и TypeScript, например pubsub.d.kt , но ваши вкусы могут отличаться.

Начните файл pubsub.d.kt так:

Это сообщает компилятору несколько вещей:

  • Этот файл содержит типизацию для библиотеки @ google-cloud / pubsub.
  • Типизация может использоваться вне настроек модуля Kotlin / JS.
  • Описанные элементы должны иметь пространство имен Kotlin google.cloud.pubsub.

Наконец, собственно набор текста. Вы можете найти полный пример здесь , но, например, для класса PubSub:

Мне также нравится создавать идиоматический класс данных Kotlin для больших двоичных объектов JSON, которые мы обычно передаем. Они не могут находиться в одном файле - для этого вы должны создать отдельный невнешний файл.

В JavaScript это превратится в стандартный объект {projectId: null, apiEndpoint: null} .

Взаимодействие с Pub / Sub

Теперь мы можем вызывать библиотеку Pub / Sub Node.js более или менее обычным образом. В этом примере используется эмулятор:

Это очень мило! SubClient.on () вызов превратился в оператора Котлин , как «использование».

Котлин / JS и сопрограммы

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

К сожалению, это возвращает Promise <> , а не то значение, которое мы хотим. Вы можете взаимодействовать с этим обычным способом JavaScript:

И снова это выглядит неплохо благодаря синтаксису лямбда-параметра Kotlin. Но мы можем добиться большего.

В TypeScript вы просто используете async и ждете . Kotlin / JS в настоящее время не поддерживает собственный async и await для JavaScript . Однако он предоставляет сопрограммы Kotlin! И оказывается, что соединить эти два моста не так уж и сложно . Это обсуждение началось довольно давно, и с тех пор сопрограммы вышли из экспериментальной фазы, поэтому требуется немного поработать, чтобы обновить их.

Во-первых, нам нужен адаптер между сопрограммами JavaScript Promise <> и Kotlin. Эта функция расширения позволит вам вызывать .await () для любого Promise <> , и этот вызов становится вызовом функции приостановки :

А поскольку Kotlin / JS не работает на JVM, мы не можем использовать собственные операции JVM, такие как runBlocking . Таким образом , это орудие мост из непредставленных приостанавливает коду к приостановке функции, вроде вызова асинхронной функции в JavaScript без Await :

И теперь мы можем делать такие вещи:

Эй, вообще-то, выглядит неплохо! Мы вернулись к простоте использования TypeScript async и await , но мы также пишем Kotlin. Это будет изящно перенесено в приложение, которое вы можете запустить на Node.js без JVM.

Следующие шаги

Ознакомьтесь с полным рабочим примером, который работает в эмуляторе Pub / Sub .

Вы использовали Kotlin / JS на стороне сервера с Node.js? Вам это интересно и вы хотите услышать больше? Не стесняйтесь оставлять комментарии об этом посте или о том, что вы считаете интересным / многообещающим в отношении Kotlin и Kotlin / JS на Google Cloud Platform!

Suggested posts

Вложенные и внутренние классы в Котлине

Kotlin — это современный язык программирования, который используется для разработки приложений для Android и серверных приложений. Одной из интересных особенностей Kotlin является поддержка вложенных и внутренних классов.

Изменение цвета строки состояния в Jetpack Compose

Изменение цвета строки состояния в Jetpack Compose

Каждая решенная проблема — это усвоенный урок. #AndroidTips #SolvedProblemToday Изменение цвета строки состояния — распространенная задача при разработке приложений для Android.

Related posts

Как спасти планету и заработать деньги

Как спасти планету и заработать деньги

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

Опасные разговоры

Опасные разговоры

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

Сбор OSINT для поиска угроз

Сбор OSINT для поиска угроз

Привет, киберлюбители! Добро пожаловать обратно в серию OSINT по поиску угроз. В первой статье я рассказал вам об OSINT и его важности для поиска угроз.

Почему некоторые фрилансеры притворяются своей жизнью

Почему некоторые фрилансеры притворяются своей жизнью

Недавно я был в Linkedin, крупнейшей в мире профессиональной социальной сети, и нашел посты дизайнеров-фрилансеров, за которыми я следил и которые привлекли мое внимание. Все они публиковали фотографии из самолетов, на пляже со своими ноутбуками, из бассейнов и офисов с потрясающими видами.