Статья описывает трансляцию кода TypeScript в OData запросы во время компиляции программы.
Плагин babel-plugin-ts2odata выполняет разбор JavaScript AST с помощью библиотеки TsToOdata описание которой в моей предыдущей статье Типизированные запросы OData в TypeScript.
Недостатком первой версии библиотеки TsToOdata являлось наличие зависимостей на пакеты babel/parser, babel/traverse, разбор JavaScript кода во время выполнения тоже было достаточно затратным. Теперь эти зависимости и разбор кода вынесены в отдельный пакет ts2odata-babel. Для разработки можно использовать пакет ts2odata который имеет devDependencies на ts2odata-babel и выполняет трансляцию запросов во время выполнения, а для релиза можно использовать сборку с подключением плагина, который выполнит всю работу во время компиляции вашего проекта. В результате работы плагина в вашей программе останутся только две зависимости на пакеты ts2odata и cross-fetch.
Для начала работы нужно установить пакеты:
npm install --save-dev @babel/core @babel/cli
npm install ts2odata
npm install --save-dev babel-plugin-ts2odata
Добавить в корень проекта файл babel.config.js:
module.exports = {
plugins: [
[
'babel-plugin-ts2odata',
{
odataNamespace: 'OdataToEntity.Test.Model'
}
]
]
};
ключ odataNamespace необходим для правильной трансляции запросов если ваш OData сервис не поддерживает перечисления без пространства имен (Namespace).
Добавить в секцию scripts файла package.json:
"build": "tsc --build && npx babel ./source --out-dir ./lib"
где source папка с исходным кодом TypeScript, lib папка с обработанным плагином JavaScript кодом.
Например код на TypeScript:
let price = 2.1;
let orders = context.Orders.filter(o => o.Items.every(i => i.Price >= price), { price })
.select(i => { return { orderYear: i.Date.getFullYear() } }).toArrayAsync();
Транслируется в:
let price = 2.1;
let orders = context.Orders.filter("Items/all(d:d/Price ge {price})", {
price
}).select("[{\"expression\":\"year(Date)\",\"alias\":\"orderYear\",\"kind\":1}]").toArrayAsync();
В результате выполнения кода выше выполняется OData запрос:
http://localhost:5000/Orders?$filter=Items/all(d:d/Price+ge+2.1)&$compute=year(Date)+as+orderYear
Другие примеры работы плагина можно посмотреть в папке с тестами, где файл code.js результат компиляции файла QueryTests.ts, а файл output.js результат работы плагина.
Работа плагина была проверена на проекте vue.js.
Это мой первый проект на TypeScript, поэтому буду признателен замечаниям и комментариям к коду, возможно, что-то можно было сделать проще или правильнее.