使用 node-odata 轻松创建基于 OData 协议的 RESTful API
前言
OData, 相信身为.NET程序员应该不为陌生, 对于他的实现, 之前也有童鞋进行过介绍(见:这里1,这里2). 微软的WCF Data Service即采用的该协议来进行通信, ASP.NET WEB API目前也对OData进行了支持.
我在以前的.NET项目中也一直采用OData进行数据交换. 最近转去进行NodeJS的开发, 为了减少学习成本, 于是便有了noda-odata--一个基于 OData 协议的 RESTful API 库. 相较于Node Express, 它能使你更容易的开发和维护您的API. 其次是让你在NodeJS里面还能缅怀一下微软的东西:)
在线示例
OData最大的特点就是他完全暴露的数据接口, 服务端只需要几行代码就能让客户端实现随心所欲的查询, 您可以试试:
- GET [/books?$select=title, author](http://books.woshinidezhu.com/odata/books?$select=title, author)
- GET /books?$top=3&$skip=2
- GET [/books?$orderby=price desc](http://books.woshinidezhu.com/odata/books?$orderby=price desc)
- GET [/books?$filter=price gt 10](http://books.woshinidezhu.com/odata/books?$filter=price gt 10)
- ...
很酷炫, 是吗? 你还可以任意组合查询条件, 以实现复杂查询. 比如:
- 我想看看最贵的一本书是啥名字 GET [/books?$select=title&$top=1&orderby price desc](http://books.woshinidezhu.com/odata/books?$select=title, author)
- 我想看看包含'Microsoft'关键字中, 按最便宜的排序 GET [/books?$filter=indexof(title,'Microsoft') ge 0 &orderby price desc](http://books.woshinidezhu.com/odata/books?$filter=price gt 10)
- ...
下面让我们看看实现它需要多少代码.
安装
首先你需要有NodeJS环境, 点击此处安装
node-odata是需要运行在express之上的, 所以您还需要安装express以及其依赖项. (express是一个nodeJS的主流web开发框架)
npm install express --save
npm install body-parser
现在您可以安装node-odata
npm install node-odata
创建文件server.js, 输入以下代码:
var express = require('express'),
odata = require('node-odata');
bodyParser = require('body-parser')
var app = express();
app.use(bodyParser.urlencoded());
app.use(express.query());
odata.set('app', app);
odata.set('db', 'mongodb://localhost/my-app');
odata.resources.register({ url: '/books', model: { title: String, price: Number } });
app.listen(3000);
现在运行 node server
您即可访问http://localhost:3000/odata/books, 您可以使用以下方式亲自试试:
GET /odata/books
GET /odata/books/:id
POST /odata/books
PUT /odata/books/:id
DELETE /odata/books/:id
License
该项目完全开源并且基于MIT协议, 其源码托管于github node-odata, 喜欢的朋友希望能star一下:)
我使用node-odata构建了我自己个人站点的服务端, 地址戳这里.