Как и где найти модули для Node.js для организации кошерного REST API?

Question

[Alex Kheben]

Дурацкое ограничение на заголовок вопроса... Оригинальный вопрос звучит так: "Какие есть модули для Node.js для организации кошерного REST API?"

Чтобы код ответов отличался от 200 при разных методах запросов (POST, GET, PUT, DELETE).
Чтобы поддерживался Range из коробки.
Желательно ещё и фильтры, но не критично.

Пробовал Sails.js и не нашёл способа реализации поддержки Range без переписывания контроллера.
Ещё пробовал Loopback, там вообще даже не получилось найти быстрое решение для поддержки разных статусов при разных запросах.

Пока из испробованных вариантов где можно сделать все так как я хочу это: express.js и restify. Но они более низкоуровневые, чем sails.js и loopback. Поэтому приходится многое писать самому...

Может есть ещё варианты?

Comments

[Sergey Romanov]

Что имеете в видо под рэйндж?

[Alex Kheben]

Range - заголовок, через него нужно организовать пагинацию.
Пример:
[Request] Range: items=10-19;
[Response] Accept-Ranges: items;
[Response] Content-Range: items 10-19/899;
Запросили элементы с 10 по 19, в ответе получили инфу о текущем состоянии и количестве существующих элементов.

[Тимур Шемсединов]

Это же не кошерно, по RESTу пагинация должны быть в урле, урл определяет ресурс уникально. А с range, если с разными заголовками присылать, то будут разные данные, это не хорошо.

Answer 1

[Олег Серых]

Извиняюсь за оффтоп, но я бы посоветовал использовать JSON RPC API ( www.jsonrpc.org/specification ), для ноды он более родной. Да и субъективно более удобен чем REST

Comments

[Alex Kheben]

Субъективно :)
Работал с RPC, только не на ноде и субъективно он бы менее удобен, чем REST API.

Answer 2

[Тимур Шемсединов]

REST есть величайшее мракобесие и маразм всех времен и народов. Берите RPC, как советуют. На голом примитивном механизме HTTP с его недоразвитым набором глаголов POST, GET, PUT, DELETE, которые невозможно расширить и кастомизировать, сложно разработать что-то более сложное, чем работа с файлами или с записями базы данных по принципу CRUD (CREATE, READ, UPDATE, DELETE). Когда же нужно сделать хоть что-то большее, над ресурсом, ввести свой глагол, то вся идеология рушится. Например, у меня есть нефтепровод с магистральными насосными агрегатами, и нужно управлять закрытием и открытием задвижек, параметрами регуляторов давления, мониторингом катодной защиты, другими подсистемами. Эти команды через POST или PUT посылать? Смешно, да? Тут нужно 5000 глаголов/методов ввести над 20ю ресурсами, а не 4 несчастных глагола над несчетным кол-вом ресурсов. Или даже над данными в БД мне нужно новые глаголы, например, хочу создать связь между двумя объектами или дать права пользователю на изменение параметра объекта или запустить отложенную задачу генерации отчетов на сервере, просто запустить и получить в ответ прогнозируемое время завершения, как это сделать на REST? Я уже не говорю о том, что операции могут быть вообще не над ресурсами. Операции могут быть над множествами, запросами (фильтрами, выборками, курсорами), над машиной состояний, над связями между несколькими ресурсами, над системой в целом или вообще над потоками данных, событий или технологическим оборудованием.

Comments

[Alex Kheben]

Везёт вам, у вас есть нефтепровод, а у нас его нет...
Мне нужен просто CRUD с кошерными статусами и плюшечками в виде фильтров, пагинацией через range и т.п.

[Юрий Пузыня]

Ну пытаться написать SCADA используя REST это еще хорошо покурить нужно.

[Тимур Шемсединов]

Это только пример того, подтверждающий, что подход REST не универсален, а RPC решает эти задачи.

[Alex Kheben]

@MarcusAurelius мне не нужен универсальный подход, мне нужен удобный подход :)

[Тимур Шемсединов]

Если надоест писать роутинги руками или упретесь в производительность, то посмотрите impress, поддерживает и RPC и REST стиль:

В стиле RPC
Файл /api/rpc/method.json/get.js

module.exports = function(client, callback) {
	callback({ field: "value" });
}

Запрос: GET /api/rpc/method.json
Ответ: { "field": "value" }

В стиле REST
Файл /api/rest/access.js

module.exports = { guests:true, logged:true, http:true, virtual:true };

Файл /api/rest/building.json/get.js

module.exports = function(client, callback) {
	var num = path.basename(client.path);
	dbCity.buildings.findOne({ num: num }, function(err, building) {
		callback({ success: !err, building: building });
	});
}

Запрос: GET /api/rest/building.json/123/
Ответ:

{
	"success": true,
	"building": {
		"_id": "53f669b438823d2c21000001",
		"caption": "text",
		"num": "1"
	}
}

Файл /api/rest/building.json/post.js

module.exports = function(client, callback) {
	var num = path.basename(client.path);
	dbCity.buildings.update(
		{ num: num },
		JSON.parse(client.fields.building),
		function(err) {
			callback({ success: !err });
		}
	);
}

Ответ: { "success": true }

Answer 3

[Юрий Пузыня]

Можете посмотреть в сторону loopback. Вот уж где плюшек в достатке.

Comments

[Alex Kheben]

Возможно, я не умею его готовить... Из коробки на все возвращает ответ 200, перевоспитать с ходу не получилось...
А генераторы там удобные, это факт! :)

Answer 4

[Сергей Краснодемский]

connect-rest