Horizon — realtime JavaScript бэкэнд29.08.2016 17:33

eea5e3ce66b64f31995e6df4913622c0.png

Что такое Horizon?


Horizon — это продукт содержащий в себе NoSQL базу данных RethinkDB, консольную утилиту horizon (hz), авторизацию и ACL, клиентскую JS библиотеку horizon.js для работы с БД на клиенте.

Другими словами: Horizon — это тонкий бэкэнд: БД и правила доступа пользователей к базе на уровне запросов.

Что внутри?


RethinkDB
Удобная NoSQL БД, которая умеет рассылать уведомления о изменениях в коллекциях. На хабре уже писали о ней: «Строим real-time веб-приложения с RethinkDB».

Вкратце о NoSQL RethinkDB:

  • Умеет рассылать по WebSoket уведомления о изменениях (рассылку можно фильтровать сразу на уровне БД)
  • Умеет масштабироваться
  • Умеет Join-ы
  • Мощный язык запросов
  • Имеет встроенный web-интерфейс для мониторинга и быстрого доступа к данным

Консольная утилита
После уcтановки Horizon сразу становится доступной утилита horizon (или hz). С ее помощью можно:
  • Инициализировать новое Horizon-приложение
  • Запустить веб-сервер для Horizon-приложения
  • Сгенерировать SSL сертификат для разработки
  • Сгенерировать токен для юзера
  • Выгрузить или вгрузить схему для RethinkDB
  • Мигрировать со старой на новую версию

ACL (Access Control List)
В Horizon из коробки поддерживает OAuth авторизацию (стандарт JSON Web Tokens), доступны провайдеры Facebook, Github, Google, Slack, Twitch, Twitter, Auth0 (последний позволяет значительно расширить этот список).

Существует несколько групп пользователей по-умолчанию:

  • Не авторизованный
  • Анонимный
  • Авторизованный
  • Админ

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

Примеры ACL-правил для запросов

Не авторизованные пользователи, чтение профилей пользователя: 

[groups.unauthenticated.rules.read_profile]
template = "collection('users').anyRead()"

Чтение профиля авторизованным пользователем: 
[groups.authenticated.rules.read]
template = "collection('posts').anyRead()"

Нужно обратить внимание, что здесь используются функция-подстановка anyRead(), означающая возможность читать любые записи. Функция не используется в реальных запросах.

Обновление информации о профиле пользователя: 

[groups.authenticated.rules.upadate_profile]
template = "collection('users').upadate({id: userId(), username: any()})"

Здесь используются две функции-подстановки userId() и any(). userId() — подствляет ID текущего авторизованного пользователя. any() — подставляет любые данные.

Как это работает в теории? Например вы хотите сделать запрос к базе данных: update({id: 1, username: ‘Bob’}), на стороне БД происходит проверка всех правил, сверяются ключи. На входе БД видит id=1, по правилу БД строит объект с ключем id=userId(), пытается сравнить 1 и userId(). Такая же операция происходит и с ключем username: проверяется "Bob” и any(). Во втором случае, функция any() позволяет пропустить любые данные — просто здесь мы проверили, что ключ username присутствует во входных данных. Если все хорошо, запрос успешно выполнится.

horizon.js
После запуска веб-сервера приложения вам станет доступна клиентская библиотека /horizon/horizon.js. Она позволяет делать следующее:
  • Развернуть WebSoket-подключение к базе RethinkDB
  • Создавать запросы к БД и подписываться на изменения коллекции или списка коллекций
  • Произвести OAuth авторизацию и получить текущего пользователя

Взглянуть на полный список методов можно здесь: horizon.io/api/horizon, horizon.io/api/collection.

Как это работает?


Есть несколько официальных примеров, демонстрирующих работу Horizon на примере чата (React, Vue, все примеры).

Но приведенные примеры не демонстрируют авторизацию и настройку прав доступа к записям, поэтому я собрал собственный пример Social Feed на Vanilla.

Как развернуть?


Разворачивается все просто: 
npm install -g horizon
hz init hz-app
cd hz-app
hz serve --dev

Все нюансы установки вы можете найти здесь: horizon.io/install и здесь: horizon.io/docs/getting-started.

Для кого?


Этот продукт определенно понравится тем, кто хорошо знает JavaScript и не хочет тратить время на бэкэнд. Horizon идеально подойдет для любителей делать прототипы.

Если говорить о сферах применения, то Horizon возможно будет интересен:

  • Разработчикам мобильных приложений / игр
  • Разработчикам PhoneGap приложений
  • Для создания интерактивных SPA-приложений (чаты, форумы)

Выводы


Плюсы
  • Очень просто установить и начать работать
  • Простая и понятная документация
  • Понятный API
  • Подписка на обновления коллекций / агрегированных запросов
  • WebSoket
  • Продукт динамично развивается

Минусы
  • Нет успешных примеров из жизни
  • Достаточно молод, не так много информации и решенных проблем
  • Есть вопросы к поддержке старыми браузерами

В остатке

Неплохой продукт для прототипирования и быстрого старта. Удобный API доступа к базе. Есть возможность настроить доступ к записям. Много внимания уделено HTTPS и защите, масштабированию. Все же не ясно как Horizon работает в реальной жизни, нет успешных примеров. Однако видно, что проект успел собрать много звезд и положительных отзывов. Может стоит пробовать в продакшине?

» Веб-сайт Horizon: horizon.io
» Github: github.com/rethinkdb/horizon

Спасибо за чтение!

Комментарии (0)

© Habrahabr.ru