在JGit中如何监听裸Git仓库ref的增删改并获取具体变更信息？

原生org.eclipse.jgit.events.RefsChangedEvent仅能感知到ref发生了变更，不会携带具体变更的ref名称、变更类型等信息，要实现你的需求可以采用以下两种成熟方案：

绝大多数裸仓库的ref变更都来自外部推送，该方案实现简单，能直接拿到全量的变更详情：

• 实现org.eclipse.jgit.transport.PostReceiveHook接口，重写onPostReceive方法，入参中的Collection<ReceiveCommand>包含了本次推送所有变更ref的完整信息，每个ReceiveCommand实例可获取：
  • getRefName()：受影响的ref完整路径，例如refs/heads/main
  • getType()：变更类型，枚举值包含CREATE（新增）、UPDATE（更新）、DELETE（删除）
  • getOldId()：变更前的commit SHA值
  • getNewId()：变更后的commit SHA值
• 示例代码：

public class CustomRefChangeListener implements PostReceiveHook {
    @Override
    public void onPostReceive(ReceivePack rp, Collection<ReceiveCommand> commands) {
        for (ReceiveCommand command : commands) {
            String refName = command.getRefName();
            ReceiveCommand.Type changeType = command.getType();
            String oldSha = command.getOldId().name();
            String newSha = command.getNewId().name();
            
            // 匹配你需要监听的特定ref，执行对应逻辑
            if ("refs/heads/your-target-ref".equals(refName)) {
                // 此处写入你的自定义处理逻辑
                System.out.printf("ref%s发生%s变更，旧SHA：%s，新SHA：%s%n",
                    refName, changeType, oldSha, newSha);
            }
        }
    }
}

• 注册Hook：将自定义Hook绑定到接收推送的ReceivePack实例即可，示例如下：

GitServlet gitServlet = new GitServlet();
gitServlet.setReceivePackFactory(new DefaultReceivePackFactory() {
    @Override
    public ReceivePack create(HttpServletRequest req, Repository db) throws ServiceNotEnabledException, ServiceNotAuthorizedException {
        ReceivePack receivePack = super.create(req, db);
        // 注册自定义监听Hook
        receivePack.addPostReceiveHook(new CustomRefChangeListener());
        return receivePack;
    }
});

如果你的裸仓库存在本地代码直接调用JGit API修改ref的场景，可通过装饰器模式拦截所有ref修改操作，实现全场景监听：

• 继承org.eclipse.jgit.lib.RefDatabase类，持有原有RefDatabase实例，所有原生方法直接转发，只在updateRef、deleteRef、batchUpdate等修改类方法中插入你的监听逻辑，获取变更的ref信息和变更类型。
• 初始化Repository实例时，将原有RefDatabase替换为你自定义的装饰器实例即可。

• 如果你需要在ref变更写入仓库前做校验拦截，可以改用PreReceiveHook，该Hook在变更落地前触发，返回错误即可终止本次变更。
• PostReceiveHook仅会触发推送导致的ref变更事件，本地API修改ref的场景不会触发，需要全场景覆盖优先选择方案2。

内容的提问来源于stack exchange，提问作者Omkar Shetkar