SOFAArk 中非Spring应用的Biz包卸载事件监听机制

概述

在SOFAArk框架中，Biz模块(业务模块)的热部署和卸载是一个核心特性。对于基于Spring的应用，框架提供了完善的上下文管理机制来自动处理资源清理。但对于非Spring的普通Java程序，如main函数启动的独立线程应用，开发者需要自行处理模块卸载时的资源释放问题。

事件监听机制

SOFAArk提供了一套完善的事件机制来感知模块生命周期的各个阶段。针对Biz模块的卸载，框架会发布AfterBizStopEvent事件，开发者可以通过实现EventHandler接口来监听这一事件。

实现步骤

1. 创建事件处理器

首先需要创建一个实现EventHandler接口的类，指定泛型为AfterBizStopEvent：

public class BizStopEventHandler implements EventHandler<AfterBizStopEvent> {
    
    @Override
    public void handleEvent(AfterBizStopEvent event) {
        // 在这里执行资源清理逻辑
        System.out.println("Biz模块"+event.getBizName()+"已停止，开始清理资源...");
        // 关闭线程、释放连接等操作
    }
}

2. 注册事件处理器

在模块启动的main方法中，需要将事件处理器注册到SOFAArk运行时环境中：

public class MainApp {
    public static void main(String[] args) {
        // 初始化业务逻辑...
        
        // 注册事件处理器
        EventHandler handler = new BizStopEventHandler();
        ArkClient.getEventAdminService().register(handler);
        
        // 启动业务线程...
    }
}

注意事项

1. 资源清理的完整性：确保在事件处理器中彻底释放所有模块占用的资源，包括但不限于：

   • 线程池的关闭
   • 网络连接的断开
   • 文件句柄的释放
   • 内存缓存的清理

2. 事件处理的时效性：AfterBizStopEvent是在模块完全卸载前触发的最后一个事件，处理逻辑应尽量快速完成，避免影响整体卸载流程。

3. 异常处理：在事件处理器中应妥善处理可能出现的异常，防止异常传播导致卸载过程失败。

4. 线程安全：如果业务模块启动了多个线程，确保在事件处理器中能正确同步和终止这些线程。

最佳实践

对于复杂的非Spring应用，建议采用以下模式：

public class ResourceManager {
    private static List<AutoCloseable> resources = new CopyOnWriteArrayList<>();
    
    public static void registerResource(AutoCloseable resource) {
        resources.add(resource);
    }
    
    public static void cleanAll() {
        resources.forEach(res -> {
            try {
                res.close();
            } catch (Exception e) {
                // 记录日志
            }
        });
        resources.clear();
    }
}

public class BizStopEventHandler implements EventHandler<AfterBizStopEvent> {
    @Override
    public void handleEvent(AfterBizStopEvent event) {
        ResourceManager.cleanAll();
    }
}

这种集中式资源管理模式可以确保所有资源都能在模块卸载时被正确清理。

总结

通过SOFAArk的事件机制，非Spring应用可以有效地感知Biz模块的卸载事件，并执行必要的资源清理操作。开发者应当根据应用特点设计合理的资源管理策略，确保模块能够优雅卸载，避免资源泄漏等问题。