Express 是一种保持最低程度规模的灵活 Node.js Web 应用程序框架,为 Web 和移动应用程序提供一组强大的功能。详见:官网中文网站

一、准备工作

首先你需要安装NodeJS环境 这里不再做介绍。

1.1 安装Express

npm install express -g //安装全局的express
npm install express-generator -g //安装全局的express命令行工具

1.2 初始化项目

cd code //项目空间
express todo (-e) //项目名称(添加参数是使用ejs模板,默认使用jade),生成一个express脚手架项目

项目目录如下:

todo
bin
www //用来启动应用(服务器)
public //存放静态资源目录
images
javascript
stylesheets
routes //路由用于确定应用程序如何响应对特定端点的客户机请求,包含一个URI(或路径)和一个特定的 HTTP 请求方法(GET、POST等)。每个路由可以具有一个或多个处理程序函数,这些函数在路由匹配时执行。
index.js
users.js
views //模板文件所在目录 默认文件格式为.jade,这里我们使用的是ejs
error.ejs
index.ejs
app.js //程序main文件 这个是服务器启动的入口
package.json //项目的配置文件

1.3 添加gitignore

在根目录上添加gitignore,排除一些文件,方便之后的git使用。

.DS_Store
node_modules

1.4 在package中添加依赖

根据自身项目的特殊要求,添加不同的依赖。

{
"name": "todo",
"version": "0.0.0",
"private": true,
"scripts": {
"start": "node ./bin/www"
},
"dependencies": {
"body-parser": "~1.15.1",
"cookie-parser": "~1.4.3",
"debug": "~2.2.0",
"ejs": "~2.4.1",
"express": "~4.13.4",
"morgan": "~1.7.0",
"serve-favicon": "~2.3.0"
//在这里根据自身项目添加依赖
}
}

1.5 初始化项目

根据终端最后两行提示:

执行下面代码,初始化项目,安装所有依赖。

cd todo && npm install //进入todo项目目录,安装相关依赖

在文件目录中会多出一个文件夹node_modules 即依赖模块的文件夹。

二、启动服务

2.1 启动服务器

npm start   //启动服务器

显示上面图片,表示服务器已启动。

2.2 浏览器访问

打开浏览器,在浏览器中访问 http://localhost:3000/或http://127.0.0.1:3000/ 浏览器输出:

三、基本使用

以下是app.js的相关代码解释,如有什么不对,请批评指正。

3.1 实现逻辑

// 引入对象
var express = require('express');
var path = require('path'); //path对象,规范连接和解析路径
var favicon = require('serve-favicon'); //页面图标
var logger = require('morgan'); //http请求日志记录器
var cookieParser = require('cookie-parser'); //解析cookie
var bodyParser = require('body-parser'); //处理请求body的中间件
var app = express();
var routes = require('./routes/index'); //home page接口
var users = require('./routes/users'); //用户接口

///======= view engine setup 模板 开始===========//
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'ejs');
///======= view engine setup 模板 结束===========//

///======= 使用中间件 开始===========//
// uncomment after placing your favicon in /public (需要显示favicon时,取消注释)
//app.use(favicon(path.join(__dirname, 'public', 'favicon.ico')));

app.use(logger('dev')); //以开发者模式,使用log
app.use(bodyParser.urlencoded({ extended: false })); //解析 application/x-www-form-urlencoded类型
app.use(bodyParser.json()); //解析 application/json类型
app.use(cookieParser()); //cookie中间件
app.use(express.static(path.join(__dirname, 'public'))); //静态文件夹方法
///======= 使用中间件 结束===========//


///=======路由信息 (接口地址)开始 ===========//
//存放在./routes目录下
app.use('/', routes); //在app中注册routes该接口
app.use('/users', users); //在app中注册users接口
///=======路由信息 (接口地址) 介绍===========//

// catch 404 and forward to error handler(捕获404错误,并转向错误处理程序)
app.use(function(req, res, next) {
var err = new Error('Not Found');
err.status = 404;
next(err);
});

///======= error handlers 错误处理程序 开始========//

// development error handler(开发者错误处理程序)
// will print stacktrace(将会打印堆栈跟踪)
if (app.get('env') === 'development') {
app.use(function(err, req, res, next) {
res.status(err.status || 500); //返回错误状态码
res.render('error', { //渲染error视图模板
message: err.message,
error: err
});
});
}
// production error handler(生产环境下的处理程序)
// no stacktraces leaked to user(不会泄露堆栈跟踪给用户)
app.use(function(err, req, res, next) {
res.status(err.status || 500);
res.render('error', {
message: err.message,
error: {}
});
});
///======= error handlers 错误处理程序 结束========//
module.exports = app;

当我们在浏览器中 访问 http://localhost:3000/ 时通过app.js中的代码:

app.use('/', routes); //在app中注册routes该接口

调用 routes/index.js ,即:

var express = require('express');
var router = express.Router();//使用 express.Router 类创建模块化、可挂载的路由句柄

//定义一个get请求 path为根目录'/'
/* GET home page. */
router.get('/', function(req, res, next) {
res.render('index', { title: 'Express' });//渲染index视图模板。
});

module.exports = router;//暴露外部接口router

所以当我们在浏览器中 访问 http://localhost:3000/users 时通过app.js中的代码:app.use('/users', users); //在app中注册routes该接口
调用 routes/users.js

3.2 路由定义

定义一个路由的基本格式为:

app.METHOD(PATH, HANDLER)//PATH 是服务器上的路径。HANDLER 是在路由匹配时执行的函数。

METHOD是HTTP 请求对应的路由方法:get, post, put, head, delete等。其中app.all()是一个特殊的路由方法,没有任何 HTTP 方法与其对应,它的作用是对于一个路径上的所有请求加载中间件。

3.3 响应方法

方法 描述
res.download() 提示下载文件。
res.end() 终结响应处理流程。
res.json() 发送一个 JSON 格式的响应。
res.jsonp() 发送一个支持 JSONP 的 JSON 格式的响应。
res.redirect() 重定向请求。
res.render() 渲染视图模板。
res.send() 发送各种类型的响应。
res.sendFile 以八位字节流的形式发送文件。
res.sendStatus() 设置响应状态代码,并将其以字符串形式作为响应体的一部分发送。

3.4 接口实例

下面我们来实现一个获取用户信息接口:

3.4.1 创建模型

在routes文件夹内创建model.js,定义一个User模型。

function User() {
this.name;
this.city;
this.age;
}
module.exports = User;

3.4.2 添加方法

在routes/users.js文件中添加引用:

var URL = require('url'); //引入URL中间件
var User = require('./model'); //引入数据模型

并继续添加如下方法:

router.get('/getUserInfo', function(req, res, next) {
var user = new User(); //实例化对象
var params = URL.parse(req.url, true).query;//获取url参数
console.log('params', params);
if (params.id == '1') { //根据参数赋值
user.name = "luo";
user.age = "11";
user.city = "北京市";
} else {
user.name = "lion";
user.age = "22";
user.city = "杭州市";
}
//这里我们写死了返回数据,并没有查询数据库。
var response = { status: 200, data: user }; //定义返回数据
res.send(JSON.stringify(response)); //发送请求
});

由于users.js路由信息已经在app.js注册,所以不要重新注册,只要停止服务器 重新start服务器即可直接访问

3.4.3 调用接口

访问:

http://localhost:3000/users/getUserInfo?id=1

http://localhost:3000/users/getUserInfo?id=2

转载请标注原文地址