这是一个基于Koa2的轻量级RESTfulAPIServer脚手架，支持ES6。
约定使用JSON格式传输数据，POST、PUT、DELET方法支持的Content-Type为 application/x-www-form-urlencoded、multipart/form-data、application/json可配置支持跨域。非上传文件推荐application/x-www-form-urlencoded。通常情况下返回application/json格式的JSON数据。
可选用Mongodb、Redis非关系型数据库和PostgreSQL、 MySQL、MariaDB、SQLite、MSSQL关系型数据库，考虑RESTfulAPIServer的实际开发需要，这里通过sequelize.js作为ORM，同时提通过Promise执行SQL直接操作Mysql数据库的方法（不管什么方法，注意安全哦）。
此脚手架只安装了一些和Koa2不冲突的搭建RESTfulAPIServer的必要插件，附带每一个插件的说明。采用ESlint进行语法检查。
因此脚手架主要提供RESTfulAPI，故暂时不考虑前端静态资源处理，只提供静态资源访问的基本方法便于访问用户上传到服务器的图片等资源。基本目录结构与vue-cli保持一致，可配合React、AngularJS、Vue.js等前端框架使用。在Cordova/PhoneGap中使用时需要开启跨域功能。
免责声明： 此脚手架仅为方便开发提供基础环境，任何人或组织均可随意克隆使用，使用引入的框架需遵循原作者规定的相关协议（框架列表及来源地址在下方）。采用此脚手架产生的任何后果请自行承担，本人不对此脚手架负任何法律责任，使用即代表同意此条。
目前暂未加入软件测试模块，下一个版本会加入该功能并提供集成方案。
China大陆用户请自行优化网络。
开发使用说明$ git clone https://github.com/yi-ge/koa2-API-scaffold.git$ cd mv koa2-API-scaffold$ npm install$ npm run dev # 可执行npm start跳过ESlint检查。访问： https://127.0.0.1:3000/
调试说明$ npm run dev --debugOr$ npm start --debug支持Node.js原生调试功能：https://nodejs.org/api/debugger.html
开发环境部署生成node直接可以执行的代码到dist目录：
$ npm run build$ npm run production # 生产模式运行Or$ node dist/app.jsPM2部署说明提供了PM2部署RESTfulAPIServer的示例配置，位于“pm2.js”文件中。
$ pm2 start pm2.jsPM2配合Docker部署说明： https://pm2.keymetrics.io/docs/usage/docker-pm2-nodejs/
Docker部署说明$ docker pull node$ docker run -itd --name RESTfulAPI -v `pwd`:/usr/src/app -w /usr/src/app node node ./dist/app.js通过'dockerps'查看是否运行成功及运行状态
Linux/Mac直接后台运行生产环境代码有时候为了简单，我们也这样做：
$ nohup node ./dist/app.js > logs/out.log &查看运行状态（如果有'nodeapp.js'出现则说明正在后台运行）：
$ ps aux|grep app.js查看运行日志
$ cat logs/out.log监控运行状态
$ tail -f logs/out.log配合Vue-cli部署说明Vue-cli（Vue2）运行'npmrunbuild'后会在'dist'目录中生成所有静态资源文件。推荐使用Nginx处理静态资源以达最佳利用效果，然后通过上述任意一种方法部署RESTfulAPI服务器。前后端是完全分离的，请注意Koa2RESTfulAPIServer项目中config/main.json里面的跨域配置。
推荐的Nginx配置文件：
server { listen 80; listen [::]:80; server_name abc.com www.abc.com; #绑定域名 index index.html index.htm; root /www/app/dist; #Vue-cli编译后的dist目录 location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ { expires 30d; } location ~ .*\.(js|css)?$ { expires 12h; } location ~ /\. { deny all; } access_log off; #访问日志路径 }Docker中Nginx运行命令(将上述配置文件任意命名放置于nginx_config目录中即可)：
$ docker run -itd -p 80:80 -p 443:443 -v `pwd`/nginx_config:/etc/nginx/conf.d nginx引入插件介绍引入插件的版本将会持续更新
引入的插件：koa@2koa-body@2koa-router@nextkoa-session2koa-static2koa-composerequire-directorybabel-clibabel-registerbabel-plugin-transform-runtimebabel-preset-es2015babel-preset-stage-2gulpgulp-eslinteslinteslint-config-standardeslint-friendly-formattereslint-plugin-htmleslint-plugin-promisenodemailerpromise-mysql
目录结构说明.├── README.md├── .babelrc # Babel 配置文件├── .editorconfig # 编辑器风格定义文件├── .eslintignore # ESlint 忽略文件列表├── .eslintrc.js # ESlint 配置文件├── .gitignore # Git 忽略文件列表├── gulpfile.js # Gulp配置文件├── package.json # 描述文件├── pm2.js # pm2 部署示例文件├── build # build 入口目录│ └── dev-server.js # 开发环境 Babel 实时编译入口├── src # 源代码目录，编译后目标源代码位于 dist 目录│ ├── app.js # 入口文件│ ├── config.js # 主配置文件（*谨防泄密！）│ ├── plugin # 插件目录│ └── smtp_sendemail # 示例插件 - 发邮件│ ├── tool # 工具目录│ ├── PluginLoader.js # 插件引入工具│ └── Common.js # 示例插件 - 发邮件│ ├── lib # 库目录│ ├── controllers # 控制器│ ├── models # 模型│ ├── routes # 路由│ └── services # 服务├── assets # 静态资源目录└── logs # 日志目录各类主流框架调用RESTfulAPI的示例代码（仅供参考）AngularJS(Ionic同)$http({ method: 'post', url: 'https://localhost:3000/xxx', data: {para1:'para1',para2:'para2'}, headers: { 'Content-Type': 'application/x-www-form-urlencoded' } }).success(function (data) { }).error(function (data) { })jQuery$.ajax({ cache: false, type: 'POST', url: 'https://localhost:3000/xxx', data: { para1: para1 }, async: false, dataType: 'json', success: function (result) { }, error: function (err) { console.log(err) }})// 上传文件//创建FormData对象var data = new FormData()//为FormData对象添加数据//$.each($('#inputfile')[0].files, function (i, file) { data.append('upload_file', file)})$.ajax({ url: 'https://127.0.0.1:3000/api/upload_oss_img_demo', type: 'POST', data: data, cache: false, contentType: false, //不可缺 processData: false, //不可缺 success: function (data) { console.log(data) if (data.result == 'ok') { $('#zzzz').attr('src', data.img_url) } }})MUImui.ajax({ url: 'https://localhost:3000/xxx', dataType: 'json', success: function(data){ }, error: function(data){ console.log('error!') }})JavaScript var xhr = new XMLHttpRequest() xhr.open('POST', 'https://localhost:3000/xxx', true) //POST或GET，true（异步）或 false（同步） xhr.setRequestHeader('Content-type', 'application/x-www-form-urlencoded') xhr.withCredentials = true xhr.onreadystatechange = function () { if (obj.readyState == 4 && obj.status == 200 || obj.status == 304) { var gotServices = JSON.parse(xhr.responseText) }else{ console.log('ajax失败了') } } xhr.send({para1: para1})vue-resourcehttps://github.com/pagekit/vue-resource
// global Vue objectVue.http.post('/someUrl', [body], { headers: {'Content-type', 'application/x-www-form-urlencoded'}}).then(successCallback, errorCallback)fetchhttps://github.com/github/fetch
fetch('/users', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ name: 'Hubot', login: 'hubot', })}).then(function(response) { // response.text()}).then(function(body) { // body})// 文件上传var input = document.querySelector('input[type='file']')var data = new FormData()data.append('file', input.files[0])data.append('user', 'hubot')fetch('/avatars', { method: 'POST', body: data})superagenthttps://github.com/visionmedia/superagent
request.post('/user') .set('Content-Type', 'application/json') .send('{'name':'tj','pet':'tobi'}') .end(callback)requesthttps://github.com/request/request
request.post('/api').form({key:'value'}), function(err,httpResponse,body){ /* ... */ })在React中可以将上述任意方法其置于componentDidMount()中，Vue.js同理。
彻底移除ESlint方法删除package.json的devDependencies中所有eslint开头的插件，根目录下的“.eslintignore、.eslintrc.js”文件，并且修改package.json的dev为：
'dev': 'gulp start'删除gulpfile.js中的lint、eslint_start两个任务，并且把default改为“gulp.task('default',['start']”。
更新说明v0.0.42017年02月07日15:57:171、修改了部分配置文件的配置方法，使之更为规范（老版本用户无须理会，对程序没有影响）。2、修改了eslintrc.js文件中的JavaScript版本配置，改为ES8，兼容async、await。3、修改gulpfile.js文件第12行，检查src/**/*.js文件。
评论