191
Pp
particle-play / files
particle-play / node_modules / connect / lib / http.js
5.0 KB
1 2/*! 3 * Connect - HTTPServer 4 * Copyright(c) 2010 Sencha Inc. 5 * Copyright(c) 2011 TJ Holowaychuk 6 * MIT Licensed 7 */ 8 9/** 10 * Module dependencies. 11 */ 12 13var http = require('http') 14 , parse = require('url').parse 15 , assert = require('assert'); 16 17// environment 18 19var env = process.env.NODE_ENV || 'development'; 20 21/** 22 * Initialize a new `Server` with the given `middleware`. 23 * 24 * Examples: 25 * 26 * var server = connect.createServer( 27 * connect.favicon() 28 * , connect.logger() 29 * , connect.static(__dirname + '/public') 30 * ); 31 * 32 * @params {Array} middleware 33 * @return {Server} 34 * @api public 35 */ 36 37var Server = exports.Server = function HTTPServer(middleware) { 38 this.stack = []; 39 middleware.forEach(function(fn){ 40 this.use(fn); 41 }, this); 42 http.Server.call(this, this.handle); 43}; 44 45/** 46 * Inherit from `http.Server.prototype`. 47 */ 48 49Server.prototype.__proto__ = http.Server.prototype; 50 51/** 52 * Utilize the given middleware `handle` to the given `route`, 53 * defaulting to _/_. This "route" is the mount-point for the 54 * middleware, when given a value other than _/_ the middleware 55 * is only effective when that segment is present in the request's 56 * pathname. 57 * 58 * For example if we were to mount a function at _/admin_, it would 59 * be invoked on _/admin_, and _/admin/settings_, however it would 60 * not be invoked for _/_, or _/posts_. 61 * 62 * This is effectively the same as passing middleware to `connect.createServer()`, 63 * however provides a progressive api. 64 * 65 * Examples: 66 * 67 * var server = connect.createServer(); 68 * server.use(connect.favicon()); 69 * server.use(connect.logger()); 70 * server.use(connect.static(__dirname + '/public')); 71 * 72 * If we wanted to prefix static files with _/public_, we could 73 * "mount" the `static()` middleware: 74 * 75 * server.use('/public', connect.static(__dirname + '/public')); 76 * 77 * This api is chainable, meaning the following is valid: 78 * 79 * connect.createServer() 80 * .use(connect.favicon()) 81 * .use(connect.logger()) 82 * .use(connect.static(__dirname + '/public')) 83 * .listen(3000); 84 * 85 * @param {String|Function} route or handle 86 * @param {Function} handle 87 * @return {Server} 88 * @api public 89 */ 90 91Server.prototype.use = function(route, handle){ 92 this.route = '/'; 93 94 // default route to '/' 95 if ('string' != typeof route) { 96 handle = route; 97 route = '/'; 98 } 99 100 // wrap sub-apps 101 if ('function' == typeof handle.handle) { 102 var server = handle; 103 server.route = route; 104 handle = function(req, res, next) { 105 server.handle(req, res, next); 106 }; 107 } 108 109 // wrap vanilla http.Servers 110 if (handle instanceof http.Server) { 111 handle = handle.listeners('request')[0]; 112 } 113 114 // normalize route to not trail with slash 115 if ('/' == route[route.length - 1]) { 116 route = route.substr(0, route.length - 1); 117 } 118 119 // add the middleware 120 this.stack.push({ route: route, handle: handle }); 121 122 // allow chaining 123 return this; 124}; 125 126/** 127 * Handle server requests, punting them down 128 * the middleware stack. 129 * 130 * @api private 131 */ 132 133Server.prototype.handle = function(req, res, out) { 134 var writeHead = res.writeHead 135 , stack = this.stack 136 , removed = '' 137 , index = 0; 138 139 function next(err) { 140 var layer, path, c; 141 req.url = removed + req.url; 142 req.originalUrl = req.originalUrl || req.url; 143 removed = ''; 144 145 layer = stack[index++]; 146 147 // all done 148 if (!layer) { 149 // but wait! we have a parent 150 if (out) return out(err); 151 152 // otherwise send a proper error message to the browser. 153 if (err) { 154 var msg = 'production' == env 155 ? 'Internal Server Error' 156 : err.stack || err.toString(); 157 158 // output to stderr in a non-test env 159 if ('test' != env) console.error(err.stack || err.toString()); 160 161 res.statusCode = 500; 162 res.setHeader('Content-Type', 'text/plain'); 163 res.end(msg); 164 } else { 165 res.statusCode = 404; 166 res.setHeader('Content-Type', 'text/plain'); 167 res.end('Cannot ' + req.method + ' ' + req.url); 168 } 169 return; 170 } 171 172 try { 173 path = parse(req.url).pathname; 174 if (undefined == path) path = '/'; 175 176 // skip this layer if the route doesn't match. 177 if (0 != path.indexOf(layer.route)) return next(err); 178 179 c = path[layer.route.length]; 180 if (c && '/' != c && '.' != c) return next(err); 181 182 // Call the layer handler 183 // Trim off the part of the url that matches the route 184 removed = layer.route; 185 req.url = req.url.substr(removed.length); 186 187 // Ensure leading slash 188 if ('/' != req.url[0]) req.url = '/' + req.url; 189 190 var arity = layer.handle.length; 191 if (err) { 192 if (arity === 4) { 193 layer.handle(err, req, res, next); 194 } else { 195 next(err); 196 } 197 } else if (arity < 4) { 198 layer.handle(req, res, next); 199 } else { 200 next(); 201 } 202 } catch (e) { 203 if (e instanceof assert.AssertionError) { 204 console.error(e.stack + '\n'); 205 next(e); 206 } else { 207 next(e); 208 } 209 } 210 } 211 next(); 212};