Files
contract-manager/.trae/rules/server_task_rules.md
songqq 02afa189f8 feat(contract): 新增合同余额功能及重构文件管理
重构合同文件管理逻辑,增加错误处理和日志记录
新增ContractBalance实体、Repository和VO类
完善Voable接口文档和实现规范
更新项目架构文档和数据库设计
修复SmbFileService的连接问题
移动合同相关TabSkin类到contract包
添加合同文件重建任务的WebSocket支持
2025-11-19 00:50:16 +08:00

14 KiB
Raw Blame History

WebSocketServerTasker 接口实现规范

1. 概述

本文档总结了实现 WebSocketServerTasker 接口的标准做法和最佳实践基于对项目中已有实现类的分析。该接口用于服务器端实现支持WebSocket通信的任务处理器实现异步任务的执行和状态监控。

2. WebSocketServerTasker 接口介绍

WebSocketServerTasker 接口位于 com.ecep.contract.service.tasker 包下,继承自 java.util.concurrent.Callable<Object>,定义了以下核心方法:

public interface WebSocketServerTasker extends Callable<Object> {
    // 初始化任务,处理传入的参数
    void init(JsonNode argsNode);
    
    // 设置会话信息(默认实现为空)
    default void setSession(SessionInfo session) {}
    
    // 设置消息处理函数
    void setMessageHandler(Predicate<Message> messageHandler);
    
    // 设置标题处理函数
    void setTitleHandler(Predicate<String> titleHandler);
    
    // 设置属性处理函数
    void setPropertyHandler(BiConsumer<String, Object> propertyHandler);
    
    // 设置进度处理函数
    void setProgressHandler(BiConsumer<Long, Long> progressHandler);
}

3. 基础实现模式

3.1 推荐实现方式

通过分析项目中的实现类,推荐以下标准实现模式:

  1. 继承 Tasker