Node.js后端框架设计构想(1)
后端的核心文件mass.js包含批量创建与删除文件夹,MD5加密,类型识别与模块加载等功能。现在网站名与网站的路径也还是混淆在里面,以后会独立到一个配置文件中。只要运行node mass.js这命令就立即从模板文件中构建一个样板网站出来。下面就是它建站的最主要代码:
- //--------开始创建网站---------
- //你想建立的网站的名字(请修正这里)
- mass.appname = "jslouvre";
- //在哪个目录下建立网站(请修正这里)
- mass.approot = process.cwd();
- //用于修正路径的方法,可以传N个参数
- mass.adjustPath = function(){
- [].unshift.call(arguments,mass.approot, mass.appname);
- return require("path").join.apply(null,arguments)
- }
- var dir = mass.adjustPath("")
- // mass.rmdirSync(dir);//......
- mass.require("http,fs,path,scaffold,intercepters",function(http,fs,path,scaffold,intercepters){
- mass.log("<code style="color:blue;">=========================</code>",true)
- if(path.existsSync(dir)){
- mass.log("<code style="color:red">此网站已存在</code>",true);
- }else{
- fs.mkdir(dir,0755)
- mass.log("<code style="color:green">开始利用内部模板建立您的网站……</code>",true);
- }
- global.mapper = scaffold(dir);//取得路由系统
- http.createServer(function(req, res) {
- var arr = intercepters.concat();
- //有关HTTP状态的解释 http://www.cnblogs.com/rubylouvre/archive/2011/05/18/2049989.html
- req.on("err500",function(err){
- res.writeHead(500, {
- "Content-Type": "text/html"
- });
- var html = fs.readFileSync(mass.adjustPath("public/500.html"))
- var arr = []
- for(var i in err){
- arr.push("<li>"+i+" : "+err[i]+" </li>")
- }
- res.write((html+"").replace("{{url}}",arr.join("")));
- res.end();
- });
- req.on("next_intercepter",function(){
- try{
- var next = arr.shift();
- next && next.apply(null,arguments)
- }catch(err){
- req.emit("err500",err);
- }
- });
- req.emit("next_intercepter",req, res);
- }).listen(8888);
- console.log("start server in 8888 port")
- });
只要运行mass.js,它会根据appname与approot判定目标路径是否存在此网站,没有就创建相应文件夹 fs.mkdir(dir,0755)。但更多的文件夹与文件是由scaffold.js完成的。scaffold里面个文件夹列表,用于让程序从templates把相应的文件夹拷贝到网站的路径下,并建立505.html, 404.html, favicon.ico, routes.js等文件。其中最重头的是routes,它是用来定义路由规则。
- //routes.js
- //最重要的部分,根据它生成controller, action, model, views
- mass.define("routes",function(){
- return function(map){
- //方法路由
- // map.get('/','site#index');
- // map.get('/get_comments/:post_id','site#get_comments');
- // map.post('/add_comment','site#add_comment');
- // //资源路由
- // map.resources('posts');
- // map.resources('users');
- // map.get('/view/:post_name','site#view_post');
- // map.get('/rss','site#rss');
- // map.resources('posts', {path: 'articles', as: 'stories'});
- //嵌套路由
- // map.resources('posts', function (post) {
- // post.resources('users');
- // });
- //命名空间路由
- map.namespace("tests",function(tests){
- tests.resources('comments');
- })
- // map.resources('users', {
- // only: ['index', 'show']
- // });
- //
- // map.resources('users', {
- // except: ['create', 'destroy']
- // });
- // map.resources('users', function (user) {
- // user.get('avatar', 'users#avatar');
- // });
- // map.root("home#index")
- }
- });
上面就是routes.js的所有内容。允许建立五种路由:根路由,资源路由,方法路由(get,delete,put,post),命名空间路由,嵌套路由。其实它们统统都会归化为资源路由,每个URL都对应一个控制器与其下的action。它会调用router.js,让里面的Router实例mapper调用router.js里面的内容,然后返回mapper。
- //scaffold.js
- var routes_url = mass.adjustPath('config/routes.js'),
- action_url = "app/controllers/",
- view_url = "app/views/",
- mapper = new Router
- mass.require("routes("+routes_url+")",function(fn){//读取routes.js配置文件
- fn(mapper)
- });
- //这里省掉,一会儿解说
- return mapper;
Router实例mapper在routes运行完毕后,那么它的几个属性就会添加了N多成员与元素,我们再利用它来进一步构建我们的控制器,视图与模型。
- //如 this.controllers = {};现在变为
- { comments:
- { actions: [ 'index', 'create', 'new', 'edit', 'destroy', 'update', 'show' ],
- views: [ 'index', 'new', 'edit', 'show' ],
- namespace: 'tests' } }
- // this.GET = [];现在变为
- [ { controller: 'comments',
- action: 'index',
- method: 'GET',
- namespace: '/tests/',
- url: '/tests/comments.:format?',
- helper: 'tests_comments',
- matcher: /^/tests/comments$/i },
- { controller: 'comments',
- action: 'new',
- method: 'GET',
- namespace: '/tests/',
- url: '/tests/comments/new.:format?',
- helper: 'new_tests_comments',
- matcher: /^/tests/comments/new$/i },
- { controller: 'comments',
- action: 'edit',
- method: 'GET',
- namespace: '/tests/',
- url: '/tests/comments/:id/edit.:format?',
- helper: 'edit_tests_comment',
- matcher: /^/tests/comments/d+/edit$/i },
- { controller: 'comments',
- action: 'show',
- method: 'GET',
- namespace: '/tests/',
- url: '/tests/comments/:id.:format?',
- helper: 'tests_comment',
- matcher: /^/tests/comments/d+$/i } ]
mapper有四个数组属性,GET,POST,DELETE,PUT,我称之为匹配栈,这些数组的元素都是一个个对象,对象都有一个matcher的正则属性,就是用来匹配请求过来的URL的pathname属性,当然首先我们先取得其method,让相应的匹配栈去处理它。
现在手脚架scaffold.js还很简鄙,以后它会结合热部署功能,当用户修改routes.js或其他配置文件时,它将会自动生成更多的视图与控制器等等。
然后我们就启动服务器了,由于req是EventEmitter的实例,因此我们可以随意在上面绑定自定义事件,这里有两个事件next_intercepter与err500。err500就不用说了,next_intercepter是用来启动拦截器群集。这里我们只需要启动第一个。它在回调中会自动启动下一个。这些拦截器是由intercepters.js 统一加载的。
- //intercepters.js
- mass.intercepter = function(fn){//拦截器的外壳
- return function(req, res, err){
- if(err ){
- req.emit("next_intercepter", req, res, err);
- }else if(fn(req,res) === true){
- req.emit("next_intercepter", req, res)
- }
- }
- }
- var deps = ["mime","postData","query","methodOverride","json","favicon","matcher","handle404"];//"more",
- mass.define("intercepters", deps.map(function(str){
- return "intercepters/"+str
- }).join(","), function(){
- console.log("取得一系列栏截器");
- return [].slice.call(arguments,0)
- });
每个拦截器都会对原始数据进行处理,并决定是继续启用下一个拦截器。比如mime拦截器:
- mass.define("intercepters/mime",function(){
- console.log("本模块用于取得MIME,并作为request.mime而存在");
- return mass.intercepter(function(req, res){
- console.log("进入MIME回调");
- var str = req.headers['content-type'] || '';
- req.mime = str.split(';')[0];
- return true;
- })
- })






