RESTful是什么
RESTful，是目前最为流行的一种互联网软件架构。因为它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用。学习RESTful，首先要学习REST。
REST
资源（Resources） REST是"表现层状态转化"，其实REST省略了主语。"表现层"其实指的是"资源"的"表现层"。一张图片、一个文档、一个视频等。这些资源我们通过URI来定位，也就是一个URI表示一个资源。
表现层（Representation）
资源是做一个具体的实体信息，他可以有多种的展现方式。例如一个txt文本信息，他可以输出成html、json、xml等格式，一个图片他可以jpg、png等方式展现
URI确定一个资源，但是如何确定它的具体表现形式呢？应该在HTTP请求的头信息中用Accept和Content-Type字段指定，这两个字段才是对"表现层"的描述。状态转化（State Transfer）
访问一个网站，就代表了客户端和服务器的一个互动过程。在这个过程中，肯定涉及到数据和状态的变化。而HTTP协议是无状态的，那么这些状态肯定保存在服务器端，所以如果客户端想要通知服务器端改变数据和状态的变化，肯定要通过HTTP来通知它。具体来说，就是HTTP协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源。
RESTful API
符合REST设计风格的Web API称为RESTful API。也就是说，RESTful是REST架构风格在WEB上的应用
实现功能
访问所有车流量数据
GET: /api/<Authen>/all访问近一周车流量数据
GET: /api/<Authen>/near访问指定路口(crossID)即指定网关所有车流量数据
GET: /api/<Authen>/cross/<crossID>访问指定路口(crossID)即指定网关近3分钟实时车流量数据
GET: /api/<Authen>/cross/<crossID>/last3min访问指定路口(crossID)即指定网关一段时间车流量数据
GET: /api/<Authen>/cross/<crossID>/start=<startTime>&end=<endTime>
代码部分
- 数据库部分Flow.js
建立Schema：创建
var FlowSchema = new Schema({
CrossTrafficData:{
CrossID: String,
DeviceType: String,
DateTime: String,
Interval: Number,
DataList:{
Data:{
LaneNo: String,
Volume: Number,
AvgOccupancy: Number,
AvgHeadTime: Number,
AvgLength: Number,
AvgSpeed: Number,
Saturation: Number,
Density: Number,
Pcu: Number,
AveQueueLength: Number,
Volume1: Number,
Volume2: Number,
Volume3: Number,
Volume4: Number,
Volume5: Number
}
}
}
});
//exports对象：
var FlowOp = function(){};
//定义各种函数。prototype表示是给FlowOp对象用的,通过callback返回数据
FlowOp.prototype.<name_function> = function([parametres],callback){}
//定义一个Model对象方便使用Model封装的方法
var FlowModel = mongodb.mongoose.model('flowCar',FlowSchema);
//Model对象的find方法，参数：条件，投射，CB
//下面这句表示筛选出参数id值和时间段的文件，并且提取后去除_id和__v属性。查询结果返回给data_id_p，进入回调函数
FlowModel.find({'CrossTrafficData.CrossID': id,'CrossTrafficData.DateTime': {"$gt": start, "$lte": end}},'-_id -__v',(err,data_id_p)=>{});
//回调函数，将js的obj转换为json，然后给callback赋值，传递json数值
var data_p_json= JSON.stringify({data_p});
callback(err,data_p_json);
- 路由routedata.js
//Json转XML，借助jsontoxml包并加入xml声明，之前传递的json就是obj
router.get('/cross/:id/start=:timestart&end=:timeend', (req, res) => {
CarFlow.findByCrossByPeriod(req.params.id, req.params.timestart, req.params.timeend, (err, obj) => {
var data_xml = jsontoxml(obj);
res.set('Content-Type', 'text/xml');
var d = '<?xml version="1.0" encoding="utf-8"?>';
res.send(d + data_xml);
});
});
反思
可以在Schema建立函数，并且导出一个Model对象是否封装更好？
mySchema.methods.findByCByP = function(paras, cb){
return this.find({type: this.type}, cb);
}```
##Reference
Rest：https://github.com/astaxie/build-web-application-with-golang/blob/master/zh/08.3.md