hc-service-client

ServiceClient

hc-service-client

本项目支持两种用法，如下介绍为在honeybee extension中使用的方法。

直接使用ServiceClient请参考: 这里 !!!

在honeycomb extension中的例子

{
  extension: {
    serviceClient: {
      module: 'hc-service-client',
      config: {
        otm: {
          endpoint: 'http://otm.com/v2',
          accessKeySecret: 'xxx',
          headerExtension: ['otm']
        },
        azk: {
          endpoint: 'http://algorithm.com/',
          accessKeySecret: 'xxx',
          workApp: 'test',
          headerExtension: ['azk']
        },
        brain: {
          endpoint: 'http://brain_domain.com/',
          accessKeySecret: 'xxx',
          headerExtension: [
            function (req, serviceCfg) {
              return {
                'X-Access-User': req.session.id
              };
            }
          ]
        }
      }
    }
  }
}

配置详情如下。

配置

hc-service-client的配置结构:

{
  [serviceCode]: {
    endpoint,
    accessKeyId,
    accessKeySecret,
    signatureApproach,
    headerExtension,
    disableFileSignature,
    headers,
    timeout
  }
}

options	desc	default
endpoint	远程的endpoint	必填
accessKeyId	调用的用户标志	anonymous
accessKeySecret	调用的签名密钥，原token/systemToken	必填
signatureApproach	签名方式 enum: [systemCall, userAuth]	默认 systemCall
disableFileSignature	禁用文件签名	false
headerExtension	根据环境动态修改header的扩展	[]
headers	使用serviceClient的默认发送headers，优先级高于headerExtension	{}
timeout	请求的超时时间（单位ms）	60000
signatureHeader	签名请求头，默认 systemCall -> signature, userAuth -> Authorization
responseWrapper	处理返回结果的function	默认函数，返回结果result.code!== 'SUCCESS'时作为错误处理，否则将result.data作为结果返回，详见SERVICE_CLIENT文档responseWrapper参数介绍

headerExtension

其他参数介绍见 这里

headerExtension是一个数组，数组中元素支持动态扩展header，

支持

• 函数, function (req, serviceCfg) ，返回 header
• object，直接写header内容
• 内置扩展， 'otm' 、 'azk' 、'gateway'

如:

{
  otm: {
    endpoint: 'http://xxx',
    accessKeyId: 'DonaldTrump',
    accessKeySecret: config.systemToken,
    headerExtension: [
      function (req, serviceCfg) {
        return {
          'X-Access-TenantCode': req.session.tenant || serviceCfg.defaultTenant
        };
      },
      {
        'X-Access-WorkApp': 'city_brain'
      },
      'otm'
    ]
  }
}

如上配置，三个类型返回的header会merge到一起，再最终请求时带上。

用法

const otm = req.getService('otm');
otm.get('/api/workspaces', {}, (err, data) => {});

const azk = req.getService('azk');
azk.get('/api/workspaces', {}, (err, data) => {});