HIKvision 请求接口的封装

海康技术封装实例（一）

• 前言

  此封装一种实例

一、环境搭建

• 修改配置文件

  spring:
     profiles: hik-config
  
  hikPros:
    ArtemisConfig:
      host: 2xx.43.xx.xxx  # 综合平台的ip地址
      appKey: 22331111	 # 管理员创建的appkey
      appSecret: ZJ1111fpG1111TbN1111 # 管理员创建的appSecret
    artemisPath: /artemis
    contentType: application/json
    netProtocol: https://
  

  注意

  AK和SK需要对接平台的的管理员创建权限，一定要确定给出的appKey是否存在我们所需要的权限。

二、使用方式

• 文件夹说明

  - hik 海康模块
  	- HIKdemo 代码文件夹
  		- api 海康接口对外直接开放接口
  		- config 海康接口配置文件
  		- core 海康接口的核心代码
  			- inters 操作接口
  		- urls 华康接口的部分url
  	- resources 资源文件夹
  		- application-hik-config.yml 海康接口的配置文件（详情配置请看上方）
  - common 通用模块
  	- pojo 参数实体封装
  		- appointment 预约接口实体
  		- assist 辅助接口实体
  		- basePojo 一些基本接口实体
  		- query 查询接口实体
  		- register 登记接口实体	
  	- uitls 工具类
  

• 请求发送与处理

  // 业务测试
  public class Test{
         
      
      // 测试一下 查询对应职工的访客预约记录
      public void apiTest(){
         
  		// 请求的参数
          JSONObject jsonObject = new JSONObject();
          jsonObject.put("receptionistId", "xxxxx");
          jsonObject.put("pageNo", "1");
          jsonObject.put("pageSize", "100");
          // 请求URL
          String url = UrlAppointment.URL_QUERY_VISITOR_APPOINTMENT;
          // 通过hikPostFectory创建HikPostEnity发送海康请求
          this.hikPostFectory.getHikPostEnity(url, jsonObject)
                  .sendRequest()
                  .getUrlResponeOK(hiKdata -> {
         
               		// 正确返回
                  })
                  .getUrlResponeError(hiKdata -> {
         
                  	// 错误返回
                  });
      }
      
  }
  
  // 返回实体
  hikdata = {
         
      /* 返回响应码**/
  	String code;
      
      /* 返回响应信息**/
      String msg;
      
      /* 返回响应数据**/
      Map<String, Object> data;
  }
  
  

• 请求图示

三、拓展

• 具体请求url和其对应的参数，请看官方链接：访客管理、人员信息接口

• 具体响应的code和msg，请看官方链接：公共返回码