美文网首页
车流量 Restful API

车流量 Restful API

作者: SodaSea | 来源:发表于2017-07-05 09:25 被阅读0次

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>

代码部分

  1. 数据库部分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);
  1. 路由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

相关文章

网友评论

      本文标题:车流量 Restful API

      本文链接:https://www.haomeiwen.com/subject/hznthxtx.html