当年Android选用最流行的java写的时候,很多熟悉服务器开发的人都转为android开发,为了表示和android彻底划清界限的决心,服务器代码决定用nodejs开发(开玩笑的,nodejs适用于中小型企业的快速开发的技术选型)。笔者这里不去比较nodejs和java做服务器开发的优劣,仅仅换个角度为了实现我们最新项目的时候,服务器开发技术选型,讲解nodejs的一个核心的网络框架,甚至曾经一度让笔者大呼还可以这么简单高效,作为科技行业的从业者,我们要铭记在心的一个铁规就是要拥抱变化。虽然写过JavaScript,也写过服务器代码,重新带大家走一遍Nodejs服务器开发。
Express框架
我们可以简单的搭建一下express的使用
var express = require('express');
var app = express();
app.use(express.static(__dirname + '/public'));
app.listen(3000);
现在就可以访问http://localhost:3000,它会在浏览器中打开当前目录的public子目录(严格来说,是打开public目录的index.html文件)。如果public目录之中有一个图片文件myimg.jpg,那么可以用http://localhost:3000/myimg.jpg访问该文件。
当然你也可以再index.js之中。生成动态网页
var express = require('express');
var app = express();
app.get('/', function (req, res) {
res.send('Hello world!');
});
app.listen(3000);
然后,运行上面的启动脚本。
然后在浏览器中输入
http://localhost:3000/
就能看到界面有Hello world!
启动index.js的app.get方法,用于指定不同访问路径对应的回调函数,这叫做“路由”,上面的代码只是指定了根目录的回调函数,因此只有一个路由记录,实际应用中可能会有多个路由记录。
比如当我们启动
var express = require('express');
var app = express();
app.get('/', function (req, res) {
res.send('Hello world!');
});
app.get('/customer', function(req, res){
res.send('customer page');
});
app.get('/admin', function(req, res){
res.send('admin page');
});
app.listen(3000);
然后重新执行脚本node express.js。打开浏览器输入http://localhost:3000/,显示的是Hello world!
打开浏览器输入http://localhost:3000/customer,显示的是customer page
打开浏览器输入http://localhost:3000/admin,显示的是admin page
这样的话最好把路由都放到一个单独的文件中,比如新建一个routes子目录
// routes/index.js
module.exports = function (app) {
app.get('/', function (req, res) {
res.send('Hello world');
});
app.get('/customer', function(req, res){
res.send('customer page');
});
app.get('/admin', function(req, res){
res.send('admin page');
});
};
然后,原来的index.js就变成下面这样。
// index.js
var express = require('express');
var app = express();
var routes = require('./routes')(app);
app.listen(3000);
既然这么简单,既然我们要使用它就得知道它的原理到底是什么呢?
运行原理
Express框架建立在node.js内置的http模块上。http模块生成服务器的原始代码如下。
var http = require("http");
var app = http.createServer(function(request, response) {
response.writeHead(200, {"Content-Type": "text/plain"});
response.end("Hello world!");
});
app.listen(3000, "localhost");
然后执行这段脚本的时候运行,浏览器显示也是Hello world!
上面代码的关键是http模块的createServer方法,表示生成一个HTTP服务器实例。该方法接受一个回调函数,该回调函数的参数,分别为代表HTTP请求和HTTP回应的request对象和response对象。
Express框架的核心是对http模块的再包装。上面的代码用Express改写如下。
var express = require('express');
var app = express();
app.get('/', function (req, res) {
res.send('Hello world!');
});
app.listen(3000);
比较两段代码,可以看到它们非常接近。原来是用http.createServer方法新建一个app实例,现在则是用Express的构造方法,生成一个Epress实例。两者的回调函数都是相同的。Express框架等于在http模块之上,加了一个中间层。
什么是中间件
每个中间件可以从App实例,接收三个参数,依次为request对象(代表HTTP请求)、response对象(代表HTTP回应),next回调函数(代表下一个中间件)。每个中间件都可以对HTTP请求(request对象)进行加工,并且决定是否调用next方法,将request对象再传给下一个中间件。
一个不进行任何操作、只传递request对象的中间件,就是下面这样。
function uselessMiddleware(req, res, next) {
next();
}
上面代码的next就是下一个中间件。如果它带有参数,则代表抛出一个错误,参数为错误文本。
function uselessMiddleware(req, res, next) {
next('出错了!');
}
抛出错误以后,后面的中间件将不再执行,直到发现一个错误处理函数为止。
那么如何注册中间件呢?这就是用到了一个use方法
use是express注册中间件的方法,它返回一个函数。下面是一个连续调用两个中间件的例子。
var express = require("express");
var http = require("http");
var app = express();
app.use(function(request, response, next) {
console.log("In comes a " + request.method + " to " + request.url);
next();
});
app.use(function(request, response) {
response.writeHead(200, { "Content-Type": "text/plain" });
response.end("Hello world!\n");
});
http.createServer(app).listen(3000);
上面代码使用app.use方法,注册了两个中间件。收到HTTP请求后,先调用第一个中间件,在控制台输出一行信息,然后通过next方法,将执行权传给第二个中间件,输出HTTP回应。由于第二个中间件没有调用next方法,所以request对象就不再向后传递了。
比如我们执行脚本打印结果是:
那么哪个是第一个哪个是第二个中间件呢?其实就是根据从上到下的顺序,谁先谁就是第一个,比如我们换一下顺序执行这段代码
app.use(function (request, response, next) {
console.log("第二个");
response.writeHead(200, {"Content-Type": "text/plain"});
response.end("Hello world!\n");
next();
});
app.use(function (request, response, next) {
console.log("In comes a " + request.method + " to " + request.url);
next();
});
http.createServer(app).listen(3000);
就会发现打印的结果就是:
use方法内部可以对访问路径进行判断,据此就能实现简单的路由,根据不同的请求网址,返回不同的网页内容。
pp.use(function (request, response, next) {
if (request.url == "/") {
response.writeHead(200, {"Content-Type": "text/plain"});
response.end("Welcome to the homepage!\n");
} else {
next();
}
});
app.use(function (request, response, next) {
if (request.url == "/about") {
response.writeHead(200, {"Content-Type": "text/plain"});
} else {
next();
}
});
app.use(function (request, response) {
response.writeHead(404, {"Content-Type": "text/plain"});
response.end("404 error!\n");
});
http.createServer(app).listen(3000);
上面代码通过request.url属性,判断请求的网址,从而返回不同的内容。注意,app.use方法一共登记了三个中间件,只要请求路径匹配,就不会将执行权交给下一个中间件。因此,最后一个中间件会返回404错误,即前面的中间件都没匹配请求路径,找不到所要请求的资源。
除了在回调函数内部判断请求的网址,use方法也允许将请求网址写在第一个参数。这代表,只有请求路径匹配这个参数,后面的中间件才会生效。无疑,这样写更加清晰和方便。
app.use('/path', someMiddleware);
上面代码表示,只对根目录的请求,调用某个中间件。
因此,上面的代码可以写成下面的样子。
var express = require("express");
var http = require("http");
var app = express();
app.use("/home", function (request, response, next) {
response.writeHead(200, {"Content-Type": "text/plain"});
response.end("Welcome to the homepage!\n");
});
app.use("/about", function (request, response, next) {
response.writeHead(200, {"Content-Type": "text/plain"});
response.end("Welcome to the about page!\n");
});
app.use(function (request, response) {
response.writeHead(404, {"Content-Type": "text/plain"});
response.end("404 error!\n");
});
http.createServer(app).listen(3000);
在浏览器输入不同结果效果分别是:
all方法和HTTP动词方法
针对不同的请求,Express提供了use方法的一些别名。比如,上面代码也可以用别名的形式来写。
var express = require("express");
var http = require("http");
var app = express();
app.all("*", function(request, response, next) {
console.log("*");
response.writeHead(200, { "Content-Type": "text/plain" });
next();
});
app.get("/", function(request, response) {
console.log("/");
response.end("Welcome to the homepage!");
});
app.get("/about", function(request, response) {
console.log("about");
response.end("Welcome to the about page!");
});
app.get("*", function(request, response) {
console.log("*");
response.end("404!");
});
http.createServer(app).listen(3000);
当我们在浏览器输入http://localhost:3000/
打印:
*
/
浏览器输入:http://localhost:3000/about
打印
*
about
上面代码的all方法表示,所有请求都必须通过该中间件,参数中的“*”表示对所有路径有效。get方法则是只有GET动词的HTTP请求通过该中间件,它的第一个参数是请求的路径。由于这里的get方法的回调函数没有调用next方法,所以只要有一个中间件被调用了,后面的中间件就不会再被调用了。
除了get方法以外,Express还提供post、put、delete方法,即HTTP动词都是Express的方法。
这些方法的第一个参数,都是请求的路径。除了绝对匹配以外,Express允许模式匹配。
如果代码是这种格式:
app.get("/hello/:who", function(req, res) {
res.end("Hello, " + req.params.who + ".");
});
上面代码将匹配“/hello/alice”网址,网址中的alice将被捕获,作为req.params.who属性的值。需要注意的是,捕获后需要对网址进行检查,过滤不安全字符,上面的写法只是为了演示,生产中不应这样直接使用用户提供的值。
这里的alice可以随便换,但是那个:who是关键词
如果在模式参数后面加上问号,表示该参数可选。
下面是一些更复杂的模式匹配的例子。
app.get('/forum/:fid/thread/:tid', middleware)
// 匹配/commits/71dbb9c
// 或/commits/71dbb9c..4c084f9这样的git格式的网址
app.get(/^\/commits\/(\w+)(?:\.\.(\w+))?$/, function(req, res){
var from = req.params[0];
var to = req.params[1] || 'HEAD';
res.send('commit range ' + from + '..' + to);
});
后面这两个我都没试过,只是参考
set方法
set方法用于指定变量的值。
set方法用于指定变量的值。
app.set("views", __dirname + "/views");
app.set("view engine", "jade");
上面代码使用set方法,为系统变量“views”和“view engine”指定值。
比如我们现在设置一个属性
app.get("*", function (request, response) {
console.log("*");
response.end("404!");
});
app.set('title', 'My Site');
var title = app.get('title');
console.log(title)
http.createServer(app).listen(3000);
运行脚本打印结果:
My Site
response对象
1)response.redirect方法
response.redirect方法允许网址的重定向。
response.redirect("/hello/anime");
response.redirect("http://www.example.com");
response.redirect(301, "http://www.example.com");
(2)response.sendFile方法
response.sendFile方法用于发送文件。
response.sendFile("/path/to/anime.mp4");
(3)response.render方法
response.render方法用于渲染网页模板。
app.get("/", function(request, response) {
response.render("index", { message: "Hello World" });
});
上面代码使用render方法,将message变量传入index模板,渲染成HTML网页。
如果你修改了stf源码,关闭当前运行的stf,执行命令gulp clean && gulp webpack:build && stf local,修改会生效