node+express入门系列二——使用应用生成器工具express-generator快速构建node后端项目
express-generator是express官方团队开发者准备的一个快速生成工具,可以非常快速的生成一个基于express开发的框架基础应用。
npm安装
npm install express-generator -g
npx安装(Node.js 8.2.0 及更高版本可用)
npx express-generator
初始化应用
express myapp
创建了一个名为myapp的express骨架项目
通过 Express 应用生成器创建的应用一般都有如下目录结构:
.
├── app.js
├── bin
│ └── www
├── package.json
├── public
│ ├── images
│ ├── javascripts
│ └── stylesheets
│ └── style.css
├── routes
│ ├── index.js
│ └── users.js
└── views
├── error.jade
├── index.jade
└── layout.jade
个文件含义及用途
app.js 是项目的主文件(入口文件),相当于vue项目的main.js
bin: 启动目录 里面包含了一个启动文件
bin/www 一个启动文件,配置了项目运行的端口信息 默认监听端口是 3000
package.json 包描述文件 最重要的是 依赖的模板列表 dependencies
依赖列表里面的所有模板 可以通过 npm i / cnpm i 一次性全部安装
public: 所有的前端静态资源 html css image js
views: 主要放置 ejs 后端模板文件
routes: 放的是 路由 文件 (默认有两个),主要在这个目录下开发接口
路由主要定义 url 和 资源 的映射关系 ( 一一对应关系 )
主要用来接收前端发送的请求 响应数据给前端
安装依赖并
cd myapp
npm install 或 cnpm i 或 npm i
启动项目
SET DEBUG=myapp:* & npm start
或者 npm start (非debug模式启动)
运行成功,控制台输出服务运行端口 3000
myapp:server Listening on port 3000 +0ms
通过浏览器访问 :http://localhost:3000
如何修改服务监听端口
打开bin目录下的www文件,找到这行代码(一般在15行)
var port = normalizePort(process.env.PORT || '3000');
这里我们还没有配置项目的环境变量,直接修改
例如: var port = normalizePort(process.env.PORT || '9000'); //9000端口
修改后需要重启项目才能生效
接口的开发与引用
在项目的routes目录下写接口,app.js中引用
example:
routes/index.js
var express = require('express');
var router = express.Router();
// test api
router.get('/test',(req, res, next)=>{
res.send({
code: 10000,
msg: '访问成功',
data: {
msg: '这是一个测试接口'
}
})
});
module.exports = router;
app.js引用
app.use('/', require('./routes/index.js'));
重启项目(每次改动都要重启项目)
调用接口完整url
http://localhost:3000/test
这里我直接在浏览器中访问接口,看到调用结果
在浏览器输入url只能访问get方法的接口,其他类型接口在浏览器中的访问请看下: 浏览器世界请求接口示例
流程总结
//前提: 已安装node 、 express 、express-generator环境
1.在要创建项目的文件目录下打开cmd => win + r 输入cmd
2. express myapp 创建项目myapp
3. cd myapp 进入项目目录
4. npm install 安装项目依赖
5. SET DEBUG=myapp:* & npm start 启动项目