1,安装nei 请安装最新版本nei
npm install edu-nei-mock``
npm install nei -g
由于目前nei版本在ftl渲染插件上有些问题，目前使用可以安装如下测试版本
sudo npm install "NEYouFan/nei-toolkit#fmpp" -g
2，安装edu-nei-mock
`
npm install edu-nei-mock -g
`
#联调时访问的域名
127.0.0.1 cplocal.study.163.com
#数据来源的域名
10.165.124.34 cp.study.163.com
`
#### 2，确保登录
如果联调的工程是需要登录信息的，请先确保登录，能正确拿到数据和对应的权限
#### 3，启动nei服务器mock
#### 4，在对应的工程根目录执行：
`
edu-nei-mock -p 'http://cp.study.163.com/' -m pc
-p
工程名| 域名
---|---
云课堂主站web端 | http://study.163.com/
云课堂主站wap端 | http://m.study.163.com/
云课堂-yooc平台 | http://mooc.study.163.com/
cp主站 | http://cp.study.163.com/
admin管理后台 | http://admin.study.163.com/
-m,
启动模式| 说明
---|---
pc | pc端模拟
mobile | wap端模拟
weixin-a | 微信内-安卓手机
weixin-i | 微信内-苹果手机
app-a | 云课堂APP内-安卓手机
app-i | 云课堂APP内-苹果手机
#### 5，根据nei启动端口访问：
http://cplocal.study.163.com:8002/{id}
比如，我可以访问
http://cplocal.study.163.com:8002/1014290573
这个时候就可以愉快的联调了。
- 如果联调阶段，希望访问的是某位后端同学数据，，那么绑定这位后端同学机器的host即可
- 如果我们想查看一下线上的问题把对应的host去掉，直接使用线上的ip解析就行
#### 前后端分离如何处理study、yooc老的java框架工程
1.从老工程中分理出前端文件
2.处理ftl的路径
由于study中ftl路径的解析很多依赖于后端的框架，然而nei启动的时候，是直接读取ftl的路径，所以
需要一个脚本，去把这些路径转换为nei能直接使用的view路径。buildView.js by lxx
3.同步正在开发的老工程和新分离工程的代码
#### 如何mock大量ftl中回填的复杂数据
工程中有很多后端回填的复杂数据结构，但是通常情况下，我们不会去修改，只是启动页面去开发组件或者模块。所以去mock大量的后端回填数据，是很费精力的。
nei提供了modelServer工程,帮助我们去拿测试环境，或者线上环境的ftl回填model数据
`
modelServer: {
// 完整的主机地址，包括协议、主机名、端口
host: 'http://cp.study.163.com/',
// 查询参数，键值对
queries: {format:'json'},
// 自定义请求头，键值对
headers: {
"User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/63.0.3239.84 Safari/537.36"
},
// path 可以是字符串，也可以是函数；默认不用传，即使用 host + 页面path + queries 的值
// 如果是函数，则使用函数的返回值，传给函数的参数 options 是一个对象，它包含 host、path（页面path）、queries、headers 等参数
// 如果 path 的值为假值，则使用 host + 页面path + queries 的值；
// 如果 path 的值是相对地址，则会在前面加上 host
},
#### 如何代理接口
nei提供的routes，穷举了mock工程下，所有路由的列表
`
/ 路由 /
routes: {
//"ALL /api/*": "代理所有接口, 这里输入代理服务器地址",
"GET /user/setting.htm": { name: '设置页面', index: 0, list: [{"id":14197,"path":"views/user/setting"}] },
"POST /j/search/hotwords.json": { path: 'post/j/search/hotwords.json/data', id: 50203, group: '默认分组' },
"POST /j/order/changeAccountSysOrder.do": { path: 'post/j/order/changeAccountSysOrder.do/data', id: 52189, group: '默认分组' },
"POST /j/order/bindTelPhoneToAccount.do": { path: 'post/j/order/bindTelPhoneToAccount.do/data', id: 52463, group: '默认分组' },
"GET /index/": { name: '首页', index: 0, list: [{"id":14104,"path":"views/index"}] },
"POST /dwr/call/plaincall/UserCenterBean.myCouponCount.dwr": { path: 'post/dwr/call/plaincall/UserCenterBean.myCouponCount.dwr/data', id: 52899, group: '公用接口' },
"POST /dwr/call/plaincall/ShopCartBean.getCount.dwr": { path: 'post/dwr/call/plaincall/ShopCartBean.getCount.dwr/data', id: 52759, group: '公用接口' },
"ALL /j/*": 'http://study.163.com/',
"ALL /p/*": 'http://study.163.com/',
"*.dwr ": 'http://study.163.com/',
},
从上述的配置中，我们可以看出，一个接口，可以有多重数据来源：
- 测试环境或者线上
- 本地mock
我们也可以把所有接口都代理到测试环境，或者在开发的时候，只代理某一个接口到本地，都是可行的。
#### 如何在nei中mock，dwr接口
DWR is a Java library that enables Java on the server and JavaScript in a browser to interact and call each other as simply as possible
除了看起来像是直接传输java对象之外，它还自带csrf校验，完善的异常处理机制等
楠哥dwr介绍：http://ks.netease.com/blog?id=3318
其实，就是返回了一段js，然后全局环境下执行这段代码。
所以在nei的dwr返回接口中，对返回的请求做相应的解析即可
`
module.exports = function (json, req) {
"use strict";
req.res.contentType('text/javascript;charset=UTF-8');
let body = {};
req.body.split('\n').forEach(function(paramPair){
let p = paramPair.split('=');
if((/^\d+$/).test(p[1])){
p[1] = parseInt(p[1]);
}else if(/^\d+\.\d+$/.test(p[1])){
p[1] = parseFloat(p[1]);
}
body[p[0]] = p[1];
});
console.log(body);
return
//#DWR-REPLY
dwr.engine._remoteHandleCallback('${body['batchId']}','${body['c0-id']}',${json.result}) ;``
}
这样dwr接口也可以在nei中mock了，对于返回的数据，统一用result包装。
简化联调使用流程，
提供了一个edu-nei-mock插件，主要帮助我们干以下几件事情：
1，更新nei的配置文件，帮助联调环境准备
- 更新modelServer配置
- 更新routes代理接口
- 更新reload值，避免nei一直监听文件改动
2，处理dwr接口，能使用nei的mock数据处理dwr接口