Home

易盾JAVA SDK是什么？

---

易盾JAVA SDK是易盾 API 的配套工具。目的是为了简化 JAVA 开发者调试和接入易盾 API 的成本，提供更快捷和更方便的接入方式，并打包一系列开发者在接入过程中可能存在的痛点功能，包括同步重试、熔断降级、故障恢复、就近访问、回调获取等。

易盾JAVA SDK具有哪些功能特性？

---

具有以下功能特性：

• 完善的失败处理：

  • 接口请求提供同步重试机制，在出现调用失败时，会自动重试指定region内的下一个请求节点。

  • 接口请求提供故障恢复机制，在同步重试仍然失败时，请求会自动写入本地文件，并在后台异步重试，直到成功后调用预设的业务handler。

  • 接口请求支持熔断降级，在当前时间窗口内，指定region的某个节点失败请求次数到达阈值时，会触发熔断，后续请求会自动路由到region内的其他可用节点，直到超过熔断时间再对熔断节点探活。

• 丰富的签名算法：

  • 内置多种接口签名算法支持，包括MD5、SHA1、SHA256、SM3

• 灵活的接口配置：

  • 常用的http请求的各项配置，包括接口超时参数，http连接池连接数、空闲时间等核心参数。

  • 切换请求协议，通过在请求对象中设置protocol字段，切换HTTP/HTTPS协议，默认HTTPS。

  • 指定region（默认杭州），根据您服务器的所在地，选择适合的region，以达到更好的请求效果，支持的region列表请咨询您的商务经理。

  • 熔断窗口的各项配置，包括窗口大小、熔断时间、错误率阈值、熔断生效的请求数阈值。

  • 同步重试和故障恢复的各项配置，包括文件路径、重试次数、重试间隔等。

详细的配置支持：

• http请求各项参数配置

   // 按照需求设置http请求的多个参数配置
   HttpClientConfig httpClientConfig = clientProfile.getHttpClientConfig();
   httpClientConfig.setSocketTimeoutMillis(60000);
  

• 请求协议

  ImageV5SyncCheckRequest checkRequest = new ImageV5SyncCheckRequest();
  checkRequest.setProtocol(ProtocolEnum.HTTPS);
  

• 熔断配置

  // 按照需求设置固定窗口的多个熔断参数配置
  FixedWindowBreakStrategy.Config breakerConfig = clientProfile.getBreakerConfig();
  breakerConfig.statWindowMillis(300000);
  

• 同步重试

  // 最大10次
  clientProfile.setMaxRetryCount(2);
  

• 故障恢复

    // 创建文件恢复的执行器，这个对象全局是单例的
    DefaultRequestRecover requestRecover = DefaultRequestRecover.createRecover("恢复文件所在的目录");
    // 注册故障恢复的handler，用于接口请求失败，异步重试成功后的处理逻辑，每个接口对应一个，否则对应接口不开启故障恢复
    // 如果多个接口都需要开启故障恢复，则需要register多个handler
    requestRecover.registerRecoverHandler(new AbstractRequestRecoverHandler<ImageV5CheckResponse>() {
        @Override
        public void handle(ImageV5CheckResponse response) {
            // 请求异步恢复成功后，处理请求结果
        }
    });
  
    // 注册请求失败后的fallback，用于接口请求失败，返回默认值，选填（不指定时，默认返回code为200的fallback对象）
    ImageV5CheckResponse fallbackResp = new ImageV5CheckResponse();
    fallbackResp.setCode(100);
    fallbackResp.setMsg("fallback response");
  
    requestRecover.registerFallback(fallbackResp);
  
    // 指定故障恢复的recover
    clientProfile.setRequestRecover(requestRecover);