tframe-utility/doc/preRoutes.md

minimal unit of smpoo tframe platform

### 路由预处理器

```
/// 用法示例：
let tut = require('tframe-utility');
app.use((req, res, next) => {
  tut.preRoutes(req, res, next);
});

/* 注：
		本中间件应该在 app.js 文件的第一个路由控制之前引用
*/
```

1. 定义了标准输出的统一调用和输出格式：

   * ##### apiOk

         			 ```
         			  // @data：要返回的数据
         			  res.apiOk = data => {
         			    res.json({
         			      apiStatus: 'ok',
         			      result: data
         			    });
         			  };
         			 ```

   * ##### apiErr
         	 		```
         			  // @err：要返回的错误对象，继承于 Error 对象
         			  res.apiErr = err => {
         			    console.log(err);
         			    res.status(err.status || 500);
         			    res.json({
         			      apiStatus: 'err',
         			      code: err.status || '500',
         			      reason: err.reason || err.toString()
         			    });
         			  };
         			 ```

1. 排除了 favicon.ico 的请求

1. 对请求注入了 IP 地址解析

1. // TO DO 待后续补充是否要对 get 请求参数格式化;

1. 统一了请求验证的处理

   * ##### 排除了 sign/in 和 sign/up 请求的 session 验证

   * ##### 对未认证的请求的返回统一处理