webhook-java实现反向API接口

webhook是什么?

webhook是一种web回调或者http的push API，是向APP或者其他应用提供实时信息的一种方式。Webhook在数据产生时立即发送数据，也就是你能实时收到数据。这一种不同于典型的API，需要用了实时性需要足够快的轮询。这无论是对生产还是对消费者都是高效的。

Webhook有时也被称为反向API，因为他提供了API规则，你需要设计要使用的API。Webhook将向你的应用发起http请求，典型的是post请求，应用程序由请求驱动。

Webhook模式的主要优点是，当你的应用在等待变化时，无需周期性地调用APIs。

为什么是webhook

实际生产应用中采用了prometheus + grafana来部署监控。
在prometheus官网上介绍监控系统通过alertmanager来进行告警配置。
其中alertmanager可以配置webhook来反向代理 公司内部 告警中心。

如何用java实现webhook

这里采用的是springboot构建的一个简单的http接口，如下图是给ceph集群部署监控后配置告警的架构概览图示：

prometheus会收集ceph集群的各种指标，并将告警信息发送给alert manager进行管理;
alert manager配置了告警的目标地址——webhook http接口;
alert manager整理告警信息后，通过http请求调用webhook的接口，webhook处理告警信息后调用告警中心的http接口；
接下来的告警分发，就是告警中心要做的事了。

以上就是webhook承担的整个功能，明白流程后一切都好办了！

项目结构如下图：

关键代码如下：(关于Http请求部分，可以谷歌一下通过retrofit来实现)

URIBuilder uri = null;
    try {
      uri = new URIBuilder(url);
    } catch (URISyntaxException e) {
      logger.error("", e);
    }

    uri.setParameters(qparams);

    try (
        CloseableHttpClient closeableHttpClient = HttpClients.createDefault()
        ) {
      HttpPost httpPost = new HttpPost(uri.build());
      httpPost.addHeader("Content-type", "application/json;charset=utf-8");

      StringEntity alertStringEntity = new StringEntity(mapper.writeValueAsString(alertCenterStructs), "UTF-8");
      httpPost.setEntity(alertStringEntity);

      try (
          CloseableHttpResponse httpResponse = closeableHttpClient.execute(httpPost)
          ) {
        HttpEntity entity = httpResponse.getEntity();
        System.out.println(entity.getContent());
      } catch (Exception e) {
        logger.error("send msg to alert center failed", e);
      }
    } catch (Exception e) {
      logger.error("send msg to alert center failed", e);
    }

参考文章：
通过git的webhook实现通过钉钉进行代码及时review（Java版本）
运行 Spring Boot 应用的 3 种方式
Spring boot 发布jar包 ，传参数的3种方式
SpringBoot之Spring@Value属性注入使用详解