Webhooks 实践
文章目录
前言
最近在看老师写的历史代码的时候,发现了在健康系统和图像标注系统都用到了WebHook,还有在之前项目配置钉钉机器人的时候也用到了WebHook一直没了解过是如果进行信息推送的,只知道配置了能根据条件进行推送,没有去研究原理(其实就是缺少探索精神,学编程的大忌),基于此,就有了这个关于webhook的实践文章

WebHook是什么
WebHook 直译是网络钩子,可以把 WebHook 看做一种通知方式,只要发生关注的事件,就会发送通知到我们指定的 Web 服务。
我们在配置钉钉机器人的时候,我需要指定github或gitee仓库,进行某些操作的时候进行推送就要通知我的钉钉机器人服务,告诉钉钉机器人服务我执行了某种触发条件的操作,执行了你指定的某一个特定操作,就进行实时推送事件数据,使接收方能够及时做出响应。而不是钉钉机器人服务隔一段时间就发起请求询问事件触发者说你执行了这个操作的了没。

基于github WebHook案例
GitHub 允许我们配置 WebHook ,它允许我们配置仓库发生某个事件时,通知指定我们的web服务。比如当指定仓库有提交代码、创建issue、关闭issue、评论issue等等触发事件的时候,GitHub 将向我们配置的 API 发送 POST 请求。
配置Webhooks
github创建webhooks有两种方式,一种是在项目仓库中的设置找到webhooks新建,一种是通过api接口请求的方式进行创建
通过访达方式新建webhooks
访问 GitHub 仓库的 Webhooks 设置页面,打开仓库的 Settings 配置页面,点击 Webhook Tab 页。
点击 Add webhook 按钮。


通过api的方式新建webhooks
github WebHooks网址
https://docs.github.com/en/rest/repos/webhooks?apiVersion=2022-11-28#create-a-repository-webhook
通过这里发现,我们可以通过post请求的方式进行创建

这里我采用postman的方式进行请求
https://api.github.com/repos/kexiaobin11/angular-springboot/hooks
通过查看webhooks已经创建了

Java 验证 WebHook触发事件
这里我们编写一个我们签名写需要回推的web api接口
@RestController()
@RequestMapping("api")
public class ApiController {
private static final Logger log = LoggerFactory.getLogger(ApiController.class);
@PostMapping("/github/webhooks")
public void githubWebhooks(@RequestBody String payload) {
log.info(payload);
System.out.println("payload: " + payload);
}
}我们通过github创建一个issue

查看web服务终端查看是否触发事件进行回推数据

这里我们看到github的issue号是5,证明当前测试webhooks没有问题
总结
之前也想过2个系统数据的回推,之前思考这个问题,但是没有去实践,最开始的想法是web服务通过轮询的方式进行请求去查看是否有触发事件,这样做一个弊端,隔一段时间就进行请求,会无故浪费资源。使用webhooks的方式很完美的解决了资源浪费的问题。这篇测试文章在创建webhooks没有使用secret密钥对信息就行传输加密,存在即合理。详细可以查看官网关于webhook handleEvent。这里就没有过多赘述。
相关文档
https://docs.github.com/en/rest/repos/webhooks?apiVersion=2022-11-28#create-a-repository-webhook
https://docs.github.com/en/webhooks/using-webhooks/handling-webhook-deliveries
评论
登录后参与技术讨论,分享你的经验与见解。
登录 / 注册暂无评论