Paypal开源nodejs框架研究(二)KrakenJs之Enrouten

原创 2013年12月02日 11:33:12

Enrouten:用于 Express 的路由(route)配置中间件(初始化与配置模块)https://github.com/paypal/express-enrouten


  我觉得这称不上一个中间件,为什么!express或者说connect的中间件,至少要有截获和转发request的功能吧,所以这个最多成的上是对express原有route功能的增强。其实看了他的代码,我觉得非常熟悉,因为我的route代码也是这么设计的,哈哈。

  我使用Nodejs的时候,有一点不爽就是,对于route的注册和实现是分离的,route的注册是在app.js里面,而route的实现是放在route.js里面的,很多时候,如果要添加一个route,就不得不同时修改2个文件,这不仅给开发,还给维护带来很大的不变,我觉得Enrouten这个小框架可能就是为了解决这个问题。先看看他的代码实例:

一、注册route,Enrouten支持2种注册route的方法,一个是指定一个目录,一个是指定一个route的定义集合。

// 第一种方法
enrouten(app).withRoutes({
    directory: 'controllers'
});


// 第二种方法
enrouten(app).withRoutes({
    routes: [
        { path: '/',    method: 'GET', handler: require('./controllers/index') },
        { path: '/foo', method: 'GET', handler: require('./controllers/foo') }
    ]
});

  对于第一种方法,Enrouten会遍历改目录下所有的js文件,假如那个js文件export出来的是一个函数且仅仅是一个函数,那么就调用那个函数,并且传入express的实例,那个,这个函数该怎么写呢:

module.exports = function (app) {
    app.get('/', function (req, res) {
        // ...
    });
};

明白了吧,这个函数就把原来在app.js代码,移到了route内部(在Enrouten里面应该叫做controller吧)


对于第二种方法,我再贴一遍代码:

// 第二种方法
enrouten(app).withRoutes({
    routes: [
        { path: '/',    method: 'GET', handler: require('./controllers/index') },
        { path: '/foo', method: 'GET', handler: require('./controllers/foo') }
    ]
});

  这个代码很有误导性,看上去,好像已/foo开头的route都定义在了./controllers/foo那个文件里面,通过这个定义,就可以把所有对foo的request都handle了。但可是,可但是实际上是什么呢?Enrouten只不过,遍历这个数组,对里面每个route定义,调用app[method](def.path, def.handler),说的再明白点,就是app.get("/foo", handler)。所以没什么大花头哦。


  好,再来看看我自己的设计,我有个名为AbstractRoute的基类,里面有一个公共的函数addRequestHandlers,这个函数需要你传入express实例,然后会调用受保护的_addRequestHandlers工具函数,这个工具函数和Enrouten做的差不多,挨个遍历定义,然后帮你注册routes。

"use restrict";
_ = require('underscore')
should = require('should')

module.exports = class AbstractRoute
#public:
    addRequestHandlers: (server)->
        @_addRequestHandlers(server, [])

#protected:
    _addRequestHandlers: (app, routeRequests)->
        should.exist(app, routeRequests)
        for routeRequest in routeRequests
            method = app[routeRequest.method] || app.get
            method.call(app, routeRequest.url, _.bind(routeRequest.handler, @))


这个是每个route的代码,从AbstractRoute继承,重写addRequestHandlers函数,把route定义传给_addRequestHandlers()函数。

module.exports = class CerRoute extends AbstractRoute
#public: 
    addRequestHandlers: (@m_app) ->
        should.exist(@m_app)
        routeRequests = [
            new RouteRequest("get", "/", @handleIndexPage)
            new RouteRequest("get", "/cer/:idType(group|product)/:id", @handleProductIndexPage)
            new RouteRequest("get", "/cer/:idType(group|product)/:id/index", @handleAjaxProductIndex)
            new RouteRequest("get", "/cer/:idType(group|product)/:id/topCrashCommands", @handleAjaxTopCrashCommands)
            new RouteRequest("get", "/cer/:idType(group|product)/:id/weeklyCrashCount", @handleAjaxWeeklyCrashCount)
            new RouteRequest("get", "/cer/:idType(group|product)/:id/weeklyCrashCountPerUser", @handleAjaxWeeklyCrashCountPerUser)
            new RouteRequest("get", "/cer/:idType(group|product)/:id/fixRate", @handleAjaxFixRate)
            new RouteRequest("get", "/cer/:idType(group|product)/:id/osBreakDown", @handleAjaxOsBreakDown)
            new RouteRequest("get", "/cer/:idType(group|product)/:id/bucket", @handleAjaxBucket)
            new RouteRequest("get", "/cer/:idType(group|product)/:id/realTimebucket", @handleAjaxRealTimebucket)
            #new RouteRequest("get", "/cer/:idType(group|product)/:id/dataMining", @handleAjaxDataMining)
            new RouteRequest("get", "/cer/:idType(group|product)/:id/sendReport", @handleAjaxSendReport)
            new RouteRequest("post", "/cer/:idType(group|product)/:id/postReport", @handleAjaxPostReport)

            new RouteRequest("get", "/cer/:idType(group|product)/:id/data/researchRate", @handleDataGetResearchRate)
            new RouteRequest("get", "/cer/:idType(group|product)/:id/data/fixRate", @handleDataGetFixRate)

        ]
        @_addRequestHandlers(@m_app, routeRequests)


RouteRequest又是一个类,很简单很简单:

should = require('should')

module.exports = class RouteRequest
    constructor: (@method, @url, @handler)->
        should.exist(@method, "parameter 'method' can not be null")
        should.exist(@url, "parameter 'url' can not be null")
        should.exist(@handler, "parameter 'handler' can not be null")

在app.js里面的调用也很简单:

cerRoute = new (require('./lib/route/CerRoute'))();
cerRoute.addRequestHandlers(server);

我这样设计有2个优点:

1. 面对对象

2. 把route的注册和实现放在一个类/文件里面,好管理,好维护。

缺点:

1. 没有考虑到,把这个AbstractRoute作为一个单独的module独立出来,变成一个框架 :)




版权声明:本文为博主原创文章,未经博主允许不得转载。

相关文章推荐

Paypal开源nodejs框架研究(一)KrakenJs

我一直说Nodejs是玩具,成不了大器。没想到著名的公司Paypal竟然开源了他们公司代码为Kraken的Nodejs框架。这款框架是基于TJ大神的Express框架的,这个是框架的官方网站:http...
  • puncha
  • puncha
  • 2013-12-02 10:58
  • 5927

国外支付(Paypal,Cybersource)

前言 Paypal是全球在线支付的领导者,2002年被eBay收购,2015年又戏剧性的从eBay分离,以500亿美元市值反超eBay。创始人 Elon Musk 同时是Paypal、空间探索技术公司...

为什么支付宝使用用户体验欠佳的安全控件,而国外 Paypal、Google Checkout 都没有这种的设计?

最大的差异来自:Paypal/Google CheckOut 以信用卡用户为主,国内支付网站用户以借记卡为主(所以必须有和银行通信的环节,而国内各家银行采用的方案几乎都是亲微软体系的...) 。借记卡...

Configure port forwarding with NAT

From: http://scriptogr.am/kevinshen/post/configure-port-forwarding-with-nat terminology: guest: v...

【Nodejs】Pomelo:网易开源基于游戏服务端框架安装

pomelo --help

nodeJs开源app后台开源框架集合

1、Horizon 项目地址:https://github.com/rethinkdb/horizon 网站主页:https://horizon.io/ Horizon是一个用Jav...

nodejs web应用服务器搭建(二):express 框架说明(应用)

介绍这里单纯说使用方式,不会说明任何原理性的东西。(我也没看过源码 or 资料 ╮( ̄▽ ̄”)╭)

AJAX研究及开源框架介绍

  • 2011-12-05 11:47
  • 189KB
  • 下载

[转帖]关于Pentaho开源BI框架的研究报告

1.1     背景 在开始的技术预研过程中,为了能够实现立项要求的分析、统计以及仪表盘等功能,需要预研在商业智能方面的技术框架,了解相关的实现方式和展现形式,其中Pentaho就是在BI领域用户群...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:深度学习:神经网络中的前向传播和反向传播算法推导
举报原因:
原因补充:

(最多只允许输入30个字)