Язык шаблонов для данных JSON
Когда большую часть работы вы выполняете преобразование JSON, вам может понадобиться этот язык шаблонов, чтобы быть эффективным.
Мотивация
Мы ( Rudderstack ) являемся интеграционной платформой и поддерживаем более 200 интеграций. Мы реализовали эту интеграцию, используя собственный код Javascript для преобразования входящих событий в целевую полезную нагрузку, поэтому в целом это манипулирование данными JSON. Поддерживать все эти интеграции сложно, поэтому мы использовали jsonata , чтобы писать меньше кода для преобразования данных JSON. Хотя эта библиотека превосходна, нам все еще нужно удовлетворить наши потребности в производительности. Например, JSONata анализирует данный шаблон, создает абстрактное синтаксическое дерево (AST) и интерпретирует AST для данного ввода. Поскольку нам нужно каждый раз проходить AST, это медленно, поэтому мы хотели создать механизм шаблонов, который генерирует код Javascript, чтобы во время выполнения было меньше накладных расходов.
Обзор
Библиотека для обработки данных JSON с использованием пользовательского синтаксиса на основе javascript и jspath . Благодарим авторов jspath за отличную работу, так как наша библиотека является расширением оригинальной библиотеки. Мы также хотим поблагодарить команду IBM за работу над jsonata , так как мы взяли несколько идей из библиотеки. Вы также можете рассмотреть нашу библиотеку как альтернативу jsonata .
Эта библиотека генерирует код функции javascript из шаблона, а затем использует функцию для оценки данных JSON. Он выводит код javascript на следующих этапах:
- Лексирование (токенизация)
- Парсинг (создание AST)
- Перевод (генерация кода)
- Класс Engine абстрагирует вышеуказанные шаги и предоставляет удобный способ использования шаблонов JSON для оценки входных данных.
Установить:npm install rudder-json-template-engine
const engine = new JsonTemplateEngine(`'Hello ' + .name`);
engine.evaluate({name: 'World'}); // => Hello World
Шаблон представляет собой набор операторов, а результат последнего оператора является выходом шаблона.
Переменные
const a = 1
let b = a + 2
a + b
Ввод относится к документу JSON, который мы хотели бы обработать с использованием шаблона. Привязки относятся к дополнительным данным или функциям, которые мы можем предоставить для эффективной обработки данных.
Примеры:
- Шаблон:
"Hello " + (.name ?? $.defaultName) - Оценка:
engine.evaluate({name: 'World'}, {defaultName: 'World'}); {name: 'World'}является входным.^.nameотносится к свойству «имя» ввода. Мы также можем использовать.nameдля обозначения того же.^всегда относится к корню ввода и.относится к текущему контексту. Обратитесь к примеру для большей ясности.{defaultName: 'World'}это привязки.$.defaultNameотносится к свойству defaultName привязки. Обратитесь к примеру для большей ясности.
let arr = [1, 2, 3, 4]
let a = arr[1, 2] // [2, 3]
let b = arr[0:2] // [1, 2]
let c = arr[-2:] // [3, 4]
Объекты
let key = "some key"
// { "a": 1, "b": 2, "c": 3, "some key": 4 }
let obj = {a: 1, b: 2, c: 3, [key]: 4 }
let a = obj["a"] // 1
let b = obj.a // 1
let c = obj{["a", "b"]} // { "a": 1, "b": 2}
let d = obj{~["a", "b"]} // { "c": 3, "some key": 4}
Функции
Нормальные функции
let fn = function(arg1, arg2){
arg1 + arg2
}
Лямбда/короткие функции
let fn = array.map(lambda 2 * ?0);
let fn = array.map(function(args) {
2 * args[0]
})
Асинхронные функции
let fn = async function(arg1, arg2){
const result = await doSomethingAsync(arg1, arg2)
doSomethingSync(result)
}
let result = await doSomething(.a, .b)
Пути используются для доступа к свойствам в input, bindingsи variables.
Простые пути
Простые пути поддерживают ограниченные функции пути и переводятся как операторы прямого доступа к свойствам в сгенерированном коде javascript. a.b.cпереводится, a?.b?.cпоэтому они очень быстрые по сравнению с расширенными путями . Простые пути идеальны, когда мы знаем структуру объекта.
Поддерживаемые функции:
- Простые селекторы
- Фильтры с одним индексом Обратитесь к примеру для большей ясности.
Расширенные пути преобразуются в сложный код для поддержки различных вариантов данных.
Если мы используем расширенный путь для выражения: a.b.c, он автоматически обрабатывает следующие варианты.
[{"a": { "b": [{"c": 2}]}}]{"a": { "b": [{"c": 2}]}}{"a": [{ "b": [{"c": 2}]}]}- Автоматически обрабатывает выбор из вложенных объектов и массивов.
let x = a.b.c;
let y = a."some key".c
Селекторы подстановочных знаков
a.*.c // selects c from any direct property of a
Селекторы потомков
// selects c from any child property of a
// a.b.c, a.b1.b2.c or a.b1.b2.b3.c
let x = a..c;
let y = a.."some key";
Отдельный индекс или фильтры свойств
let x = a[0].c;
let y = a[-1].c; // selects last element from array
let z = a["some key"].c
Мультииндексы или фильтры свойств
let x = a[0, 2, 5].c;
let y = a["some key1", "some key2"].c;
Фильтры диапазонов
let x = a[2:5].c;
let y = a[:-2].c;
let z = a[2:].c;
let x = obj{["a", "b"]}; // selects a and b
let y = obj{~["a", "b"]}; // selects all properties except a and b
Условные или объектные фильтры
let x = obj{.a > 1};
Блочные выражения
let x = obj.({
a: .a + 1,
b: .b + 2
});
let x = obj.([.a+1, .b+2]);
Контекстные переменные
.orders@order#idx.products.({
name: .name,
price: .price,
orderNum: idx,
orderId: order.id
})
Параметры пути
Мы можем указать defaultPathType при создании экземпляра движка.
// For using simple path as default path type
// a.b.c will be treated as simple path
JsonTemplateEngine.create(`a.b.c`, {defaultPathType: PathType.SIMPLE});
// For using rich path as default path type
// a.b.c will be treated as rich path
JsonTemplateEngine.create(`a.b.c`, {defaultPathType: PathType.RICH});
// Use ~s to treat a.b.c as simple path
~s a.b.c
// Use ~r to treat a.b.c as rich path
~r a.b.c
Компилировать выражения времени
Выражения времени компиляции оцениваются с использованием параметра привязки времени компиляции на этапе компиляции.
// {{$.a.b.c}} gets translated to 1 and
// final translated code will be "let a = 1;"
JsonTemplateEngine.create(`let a = {{$.a.b.c}};`, {
compileTimeBindings: {
a: {
b: {
c: 1
}
}
}
});
Заключение
Мы создали простой язык для эффективной обработки данных JSON и сделали его открытым . Было весело создавать язык, и я надеюсь, что сегодня вы узнали что-то новое.

![В любом случае, что такое связанный список? [Часть 1]](https://post.nghiatu.com/assets/images/m/max/724/1*Xokk6XOjWyIGCBujkJsCzQ.jpeg)



































