honey-net v1.0.4

honey-net 接口请求库

目前接口请求响应格式分为两版：

1. 旧版：海纳原有所有系统都采用这种格式
2. 新版：遵循腾讯云apiv3规范

本接口请求库，通过封装，隐藏了不同接口格式的底层细节，提供统一的请求方式，响应结果，只需在初始化时选择对应的接口格式即可

安装方法

npm install --save "honey-net"

接口库初始化

NetV3是新版接口 NetV1是旧版接口

新版接口初始化方法

import { NetV3 as Net } from '@tencent/honey-net';
const api = new Net();
api.init({
  baseUrl: '/',
});

旧版接口初始化方法

import { NetV1 as Net } from '@tencent/honey-net';
const api = new Net();
api.init({
  baseUrl: '/',
});

init传入的参数

Net对象方法

NetV3.post

原始的post方法

不会对返回信息进行解析

import { NetV3 as Net } from '@tencent/honey-net';
const api = new Net();

const res = await api.post('/v1/getRole', {
  RoleID: 123
})

if (res.data) {
  // res.data 是接口返回的数据，需要自行解析，自行处理正常数据返回或者错误数据返回
}

NetV3.get

原始的get方法

不会对返回信息进行解析

import { NetV3 as Net } from '@tencent/honey-net';
const api = new Net();

const res = await api.get('/v1/getRole', {
  RoleID: 123
},{
  headers: {
    xxxx: 'xxx'
  },// 添加请求头等其他自定义参数
})

if (res.data) {
  // res.data 是接口返回的数据，需要自行解析，自行处理正常数据返回或者错误数据返回
}

NetV3.setToken

设置 jwt token 值

api.setToken('blah blah');

NetV3.easyPost

post方法

会对返回信息进行解析，如果接口返回正常数据，post函数返回值就是接口Response里的数据，如果接口返回错误，则会抛出ApiError 可通过ApiError的getCode和getMessage分别获得错误码和错误信息

import { NetV3 as Net, ApiError } from '@tencent/honey-net';
const api = new Net();

try {
  const res = await api.easyPost('/v1/getRole', {
    RoleID: 123
  })
  // 这里res就是接口返回的正常数据
} catch (err) {
  if (err instanceof ApiError) {
    // 错误码
    const code = err.getCode()
    // 错误信息
    const message = err.getMessage()
  }
}

NetV3.easyGet

get方法

会对返回信息进行解析，如果接口返回正常数据，get函数返回值就是接口Response里的数据，如果接口返回错误，则会抛出ApiError 可通过ApiError的getCode和getMessage分别获得错误码和错误信息

import { NetV3 as Net, ApiError } from '@tencent/honey-net';
const api = new Net();

try {
  const res = await api.easyGet('/v1/getRole', {
    RoleID: 123
  })
  // 这里res就是接口返回的正常数据
} catch (err) {
  if (err instanceof ApiError) {
    // 错误码
    const code = err.getCode()
    // 错误信息
    const message = err.getMessage()
  }
}

错误对象

ApiError

如果是接口返回的错误信息，easyPost和easyGet会抛出ApiError

ApiError有如下函数可以使用：

使用Demo

下面以post请求（新版）

假设接口定义如下：

请求路径：

method: POST

path: /v1/GridPCSvr/DescribeRoleList

请求参数：

{
  "RequestId": "xxx",
  "RoleID": "1001",
  "Offset": 0,
  "Limit": 10
}

接口返回：

{
  "Response": {
    "TotalNum":143,
    "RoleMemberList":[{
      "UserName":"张三",
      "UserID":"XXX",                    
      "CreateTime":"2020-12-02 19:03:21",
      "Phone":"13923882323",
    }]
  }
}

可以如下请求

import { NetV3 as Net } from '@tencent/honey-net';
const api = new Net();
api.init({
  baseUrl: '/',
});

async function getRoleList(params) {
  try {
    const roleListData = await api.easyPost('/v1/GridPCSvr/DescribeRoleList', params);

    return roleListData;
  } catch (error) {
    // ApiError 是接口返回错误信息，需要继续抛出去给业务逻辑
    if (error instanceof ApiError) {
      if (error.isAuthFailureTokenFailure()) {
        // token 失效了
        // 处理token失效的逻辑
      } else {
        // 其他错误
        // 如果无法处理则继续抛出错误
        throw error
      }
    }
    console.error(error.message);
  }
  return null;
}

// 这里无需存入RequestId，接口库会自动带上
const resData = await getRoleList({
  "RoleID": "1001",
  "Offset": 0,
  "Limit": 10
})