自定义后台接口

1. 概述

Enhancer 赋予开发者自定义后台 HTTP 接口的能力，同时集成了一站式调试和打包功能，让应用的开发具有良好的业务适应性。

2. 定义后台接口

打开工作台左侧【自定义 http 接口】，可以添加接口并编写对 http 请求响应的后台逻辑，如下图：

【示例】

var lodash = require('lodash'); // 如果有使用其他 node 模块，则需要在【全局配置】>【系统】>【依赖】中配置。

// ...

module.exports = function(request, response, Enhancer) {
    var dbService = request.getDatabaseService();
    var sql = 'SELECT * FROM userinfo where id = ?';
    var id = request.getUser().getId();
    dbService.execute(sql, [id], function(err, result) {
        if (err) {
            console.error(err);
            return response.status(500).send(err.message);
        }
        response.send(result.rows);
    });
};

3. 使用后台接口

3.1 在自定义窗口中调用自定义接口 Demo

3.2 在任意前端脚本中调用自定义接口 Demo

3.3 在绑定数据源时使用自定义接口 Demo

4. 自定义接口 request，response 对象使用说明

request

request 对象是对 nodejs 原生 Http.IncomingMessage 的扩展。除了拥有 http 请求基本的参数属性之外还有以下常用属性和方法：

request.query {Object} 本次 http 请求 url 中的参数键值对。
request.body {Object} 本次 http 请求消息体键值对内容。
request.cookies {Object} 本次 http 请求携带的 cookie 键值对。
request.headers {Object} 本次 http 请求的协议头对象。
request.getUser {Function} 获取本次请求的 user 对象。
- user.getName() 获取用户名
- user.getId() 获取用户 id
- user.getRoles() 获取用户角色
request.getServerVariables {Function} 获取当前服务端变量集合。
request.getDatabaseService {Function} 获取数据库服务对象。
- dbService.execute(sql, params, callback)

详细文档请参考 request api

response

response 对象是对 nodejs 原生 Http.ServerResponse 对象的扩展。除了拥有 http 响应所需的基本方法外还有以下常用方法:

response.status(code) 设置响应代码，默认 200。
response.send(text|json) 发送给客户端内容并结束响应。
response.cookie(name, value) 给客户端设置 cookie。

详细文档请参考 response api

【附】服务器端编程 API

5. 使用 Data Bridge 调试接口

如果需要对实现的接口做本地调试，您需要完成以下三步:

在本地安装 data-bridge：$ sudo npm install -g enhancer-data-bridge
在 Enhancer 工作台-->全局配置-->数据库-->连接设置【连接方式】为【桥接】
在本地启动 $ data-birdge debug

此时用 chrome 浏览器打开启动 data-birdge 输出的调试连接即可。

【说明】

如果调试界面打开之后没有看到用于调试的代码视图，很有可能是相关调试工具被隐藏了，需要打开控制台设置查看是否开启了相关调试工具。
如果开发的自定义接口使用了其他 node 模块，即便在工作台依赖配置过了模块，在开发调试阶段，仍然需要执行 data-bridge install <模块名> 来配合接口的调试运行。

[选修]自定义后台接口