默认app设置及扩展的属性方法

app默认已设置

// parse application/x-www-form-urlencoded
app.use(bodyParser.urlencoded({ extended: false }));
// parse application/json
app.use(bodyParser.json());
app.use(cookieParser());
// nginx代理转发后，要获取正确host需要：
app.set('trust proxy', 'loopback');
app.set('query parser', 'extended');

// 设置引擎默认后缀 if (!app.get('view engine')) { app.set('view engine', 'njk'); }

update: v1.3.2版本后，由stage.set('view engine')来管理默认模板引擎

Nunjucks模板默认设置

nunjucks.configure(viewDir, {
  autoescape: true,
  noCache: env.isDev,  // $NODE_ENV !== 'production'
  watch: env.isDev
}

nunjucks对象的获取使用 const nunjucks = stage.get('nunjucks');。 nunjucks env对象的获取使用 const nunjucksEnv = stage.get('nunjucksEnv');。

以下扩展的属性和方法，是coc框架运行所需，请勿覆盖。

属性

• req.stage coc产生的stage引用
• req.stageIndex 流程索引
• req.pathname 默认等于req.path, 使用req.forward功能后则不相等，req.path始终为原始请求地址
• req.param 路由参数
• req.router 匹配到的router配置
• req.interceptors 匹配到的拦截器
• req.apis 解析后的接口配置
• req.apisTask 接口任务

• req.httpRequest 接口请求client

• res.stage coc产生的stage引用

• res.apiData 接口数据
• res.apiInfo 接口信息
• res.forwardSent forward跳转后，值为true
• res.hasSent 代理转发后，值为true
• res.viewPath 视图模板相对路径
• res.viewExt 视图模板后缀
• res.viewFile 视图模板物理文件地址
• res.locals.request = req
• res.locals.app = req.app
• res.locals.apiDataKeys 在模板中输出{apiDataKeys}来查看视图中有哪些数据可以输出
• res.html 模板的渲染结果
• res.proxyResoponse 代理请求后产生的响应流

方法

• res.forward(routePath) 服务器内跳转，例如 res.forward('/news/100')，内部会跳转到 '/news/:id' 的route v1.2.9版本后，可以跳转到一个外部网址，例如 res.forward('http://other.com')
• res.goto(path) 取代res.redirect的方法，推荐使用该方法跳转请求
• res.disableCache(true|false) 设置响应的缓存头，若为true，则设置no-cache响应头
• next(error) 下一个流程，是对express next的一个封装。stage内使用这个next()跳转流程。 next.origin() 是 express next()。 参数error为可选。

stage对象包含的属性

req.stage是coc产生的stage对象引用，而stage对象内存储了一些属性，可用如下方法获取：

// 获取拦截器配置汇总后的map映射对象
stage.get('interceptorMap');
// 获取拦截器配置转换后的数组对象
stage.get('interceptors');
// 获取路由配置汇总后的map映射对象
stage.get('routerMap');
// 获取路由配置转换后的数组对象
stage.get('routers');
// 获取配置的视图目录
stage.get('views');
// 获取配置的禁止自动渲染模板的目录
stage.get('viewExclude');
// 获取接口数据缓存方法
stage.get('apiDataCache');
// 获取接口数据名方法
stage.get('apiDataName');
// 获取接口地址处理方法
stage.get('handleAPI');
// 获取是否设置缓存ajax headers
stage.get('ajaxCache');