1) 首先安装node
可以参考菜鸟教程node.js安装配置,或者自行搜索安装教程,访问官网下载慢的这里提供node-v8.40.msi安装包下载,百度网盘地址链接:https://pan.baidu.com/s/1boWTBQn密码: w32w;
安装node 会自动安装npm包管理工具;
检查是否有安装node和 npm包管理工具,打开cmd命令行工具,输入node -v和npm -v,会输出对应的版本号,如下所示:
C:\Users\liuzk$ node -vv8.4.0C:\Users\liuzk$ npm -v5.3.0
全局安装 npm ,最好同时安装cnpm 淘宝npm镜像,如果npm 安装依赖包的时候报错,有时候是网络不好,可以使用淘宝镜像cnpm来安装;
npm install -g npm
npm install -g cnpm
2)安装express应用程序生成器
全局安装express-generator;
npm install -g express-generator
有安装Git Bash Here等第三方命令行工具,我们打开文件管理,进入到想要生成项目的位置后,右键打开Git Bash Here 就可以在当前位置启动命令行工具了;
如果没有安装git等第三方cmd命令行工具,我们打开文件管理,进入到想要生成项目的位置后,直接在地址栏输入cmd,会在当前目录打开cdm命令行工具;
在我们想要的位置打开命令行工具之后,就可以开始以下步骤:
创建一个名为myapp的express应用程序
express --view=pug myapp
成功后会自动在目标位置创建一个名为myapp的项目并生成很多文件,
在命令行最下面有提示,install dependencies: cd myapp && npm install然后run the app: npm start,我们按照提示来;
进入myapp项目;
cdmyapp
安装package.json文件中的依赖;
npm install
网络不好可以用cnpm安装
cnpm install
运行项目
npm start
在浏览器输入localhost:3000,会打开一个页面显示Welcome to Express,说明已经成功启动服务了。
3)配置
打开myapp项目,可以看到目录是下面这样的;
这个时候,浏览器打开localhost:3000/users,可以看到页面显示respond with a resource
打开routes 文件夹下的users看到以下代码:
// routes/users.js文件varexpress =require('express');varrouter = express.Router();/* GET users listing. */router.get('/',function(req, res, next){ res.send('respond with a resource');});module.exports = router;
可以看到页面显示的内容就是users.js文件中返回的内容,我们定义自己想要返回的内容。
var express = require('express');
var router = express.Router();
/* GET users listing. */
var data = {
'code':'000',
'message':'message消息',
'lists':[
{
'naem':'小明',
'age': '12',
'sex':'男'
},{
'naem':'小红',
'age': '12',
'sex':'女'
}
]
}
router.get('/', function(req, res, next) {
res.send(data);
});
module.exports = router;
改了之后再请求没有改变,查看命令行信息,304发现我们的请求给我们缓存了;
GET /users 304 2.543 ms - -
我们重新启动一下试试,刷新页面返回:
{"code":"000","message":"message消息","lists": [ {"naem":"小明","age":"12","sex":"男"}, {"naem":"小红","age":"12","sex":"女"} ]}
这样虽然可以请求,但是有缓存问题,而且接口多的话每次都得配置一个路径,太复杂,所以要封装一下,重复使用,每次请求重新请求不加载缓存。
在项目下新建一个config文件夹并新建一个api.js,配置一下:
var fs = require('fs');
/**
* 检查请求的路径是否存在
* @param apiName 请求路径
* @param method 请求方式
* @param params 请求参数
* @param res 返回请求
*/
function getDataFromPath (apiName,method,params,res){
if(apiName){
fs.access(
// 提取请求路径中的js文件
apiName.substring(1)+'.js',
// 回调函数,检查请求的路径是否有效失败返回一个错误参数
function(err){
if(!err){
// 每次请求都清除模块缓存重新请求
delete require.cache[require.resolve('..'+apiName)];
try{
addApiResult(res,require('..'+apiName).getData(method,params));
}catch(e){
console.error(e.stack);
res.status(500).send(apiName+' has an error,please check the code.');
}
}else{
addApiResult(res);
}
}
);
}else{
addApiResult(res);
}
};
/**
* 响应头
* @param res
*/
function addApiHead(res){
res.setHeader('Content-Type', 'application/json;charset=utf-8');
// 跨域
res.header('Access-Control-Allow-Origin', '*');
res.header('Access-Control-Allow-Headers', 'Content-Type, Content-Length, Authorization, Accept, X-Requested-With , yourHeaderFeild');
res.header('Access-Control-Allow-Methods', 'PUT, POST, GET, DELETE, OPTIONS');
// 控制http缓存
res.header("Cache-Control", "no-cache, no-store, must-revalidate");
res.header("Pragma", "no-cache");
res.header("Expires", 0);
}
/**
* 返回参数,如无返回参数返回404
* @param res
* @param result
*/
function addApiResult(res,result){
if(result){
res.send(result);
}else{
res.status(404).send();
}
}
/*请求方式*/
// get
exports.get = function(req, res){
addApiHead(res);
getDataFromPath(req.path,'GET',req.query,res);
};
// post
exports.post = function(req, res){
addApiHead(res);
getDataFromPath(req.path,'POST',req.body,res);
};
打开根目录下app.js,在上面引入刚刚新建的文件api.js;
//引入APIvarapi =require('./config/api');
替换请求配置
/*配置请求*/app.get('/',function(req, res){ res.send('hello world');});app.get('/api/*', api.get);app.post('/api/*', api.post);
app.js最终代码:
var express = require('express');
var path = require('path');
var favicon = require('serve-favicon');
var logger = require('morgan');
var cookieParser = require('cookie-parser');
var bodyParser = require('body-parser');
var app = express();
/*引入api*/
var api = require('./config/api');
// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'pug');
// uncomment after placing your favicon in /public
//app.use(favicon(path.join(__dirname, 'public', 'favicon.ico')));
app.use(logger('dev'));
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: false }));
app.use(cookieParser());
app.use(express.static(path.join(__dirname, 'public')));
//配置请求
app.get('/', function(req, res){
res.send('hello world');
});
app.get('/api/*', api.get);
app.post('/api/*', api.post);
module.exports = app;
根目录新建api文件夹,新建demo.js;
var dataDemo={
'code':'000',
'message':'message消息',
'lists':[
{
'naem':'小明',
'age': '12',
'sex':'男'
},{
'naem':'小红',
'age': '12',
'sex':'女'
}
]
}
exports.getData = function(method,data){
var backData={
"code":'000',
"msg":"",
"data":dataDemo
}
if(method=='DELETE'){
backData={
"code":'999',
"msg":"不支持DELETE方法"
}
}
return JSON.stringify(backData);
}
重新运行npm start,浏览器打开localhost:3000,此时应该显示的是hello world;
打开localhost:3000/api/demo,页面显示
{"code":"000","msg":"","data": {"code":"000","message":"message消息","lists": [ {"naem":"小明","age":"12","sex":"男"}, {"naem":"小红","age":"12","sex":"女"} ] }}
以上都成功了,那就说明配置成功了,复制一个js文件命名为demo2.js,改动一下数据,浏览器访问localhost:3000/api/demo2应该也是可以的;
4) 使用
假如线上接口是https://www.baidu.com/mydata/java/school/list,我们在api文件夹按照路径新建文件夹和文件即可:
├── api│ └── mydata│ └── java│ └── school│ └──list.js