Spring Boot 流程引擎服务：流程定义/实例/任务、审批人解析、 回调分发、oapi 接口及单元测试。 保留远程 .gitea/workflows/build.yml 与 docker/Dockerfile， 新增 .gitignore 排除 target/ 构建产物。
This commit is contained in:
chenxing
@@ -0,0 +1,146 @@
|
||||
package com.yunhai.flowcenter.service;
|
||||
|
||||
import com.yunhai.flowcenter.callback.CallbackProperties;
|
||||
import com.yunhai.flowcenter.callback.CallbackPushService;
|
||||
import com.yunhai.flowcenter.entity.FlwCallbackLog;
|
||||
import com.yunhai.flowcenter.entity.FlwCallbackReg;
|
||||
import com.yunhai.flowcenter.enums.FlwEnums;
|
||||
import com.yunhai.flowcenter.repository.FlwCallbackLogRepository;
|
||||
import com.yunhai.flowcenter.repository.FlwCallbackRegRepository;
|
||||
import com.yunhai.platform.apistd.BizException;
|
||||
import com.yunhai.platform.utils.exception.ErrorCode;
|
||||
import com.yunhai.platform.utils.model.BasePageResult;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import org.springframework.data.domain.Page;
|
||||
import org.springframework.data.domain.PageRequest;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.List;
|
||||
import java.util.UUID;
|
||||
|
||||
/**
|
||||
* 回调注册/推送日志/死信管理（概览 §9.2）：
|
||||
* 启停、secret 重置（重置后旧签名立即失效）、推送日志查询、死信列表与手工重推。
|
||||
*/
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
public class FlowCallbackAdminService {
|
||||
|
||||
private final FlwCallbackRegRepository regRepository;
|
||||
private final FlwCallbackLogRepository logRepository;
|
||||
private final CallbackPushService pushService;
|
||||
private final CallbackProperties callbackProperties;
|
||||
|
||||
public List<FlwCallbackReg> listRegs(Long schId) {
|
||||
return regRepository.findBySchIdOrderByUpdateTimeDesc(schId);
|
||||
}
|
||||
|
||||
/** 启用/停用注册（停用后该注册不再收到推送，日志保留） */
|
||||
@Transactional
|
||||
public void setRegStatus(Long schId, Long regId, boolean enabled) {
|
||||
FlwCallbackReg reg = requireReg(schId, regId);
|
||||
reg.setStatus(enabled ? 0 : 1);
|
||||
regRepository.save(reg);
|
||||
}
|
||||
|
||||
/** secret 重置：新 secret 下发（管理端展示一次，不回显存量） */
|
||||
@Transactional
|
||||
public String resetSecret(Long schId, Long regId) {
|
||||
FlwCallbackReg reg = requireReg(schId, regId);
|
||||
String secret = UUID.randomUUID().toString().replace("-", "").toLowerCase();
|
||||
reg.setSecret(secret);
|
||||
regRepository.save(reg);
|
||||
return secret;
|
||||
}
|
||||
|
||||
/** 推送日志分页（状态/事件/办件筛选） */
|
||||
public BasePageResult<FlwCallbackLog> pageLogs(Long schId, Integer status, String event,
|
||||
Long instanceId, Integer page, Integer size) {
|
||||
Page<FlwCallbackLog> p = logRepository.pageLogs(schId, status, event, instanceId,
|
||||
PageRequest.of(page == null || page < 1 ? 0 : page - 1,
|
||||
size == null || size < 1 || size > 100 ? 10 : size));
|
||||
return new BasePageResult<>(p.getContent(), (int) p.getTotalElements(),
|
||||
page == null || page < 1 ? 1 : page,
|
||||
size == null || size < 1 || size > 100 ? 10 : size,
|
||||
p.getTotalPages(), p.hasNext());
|
||||
}
|
||||
|
||||
/** 死信列表 */
|
||||
public BasePageResult<FlwCallbackLog> pageDead(Long schId, Integer page, Integer size) {
|
||||
Page<FlwCallbackLog> p = logRepository.findBySchIdAndStatusOrderByIdDesc(schId,
|
||||
FlwEnums.CallbackLogStatus.DEAD.getCode(),
|
||||
PageRequest.of(page == null || page < 1 ? 0 : page - 1,
|
||||
size == null || size < 1 || size > 100 ? 10 : size));
|
||||
return new BasePageResult<>(p.getContent(), (int) p.getTotalElements(),
|
||||
page == null || page < 1 ? 1 : page,
|
||||
size == null || size < 1 || size > 100 ? 10 : size,
|
||||
p.getTotalPages(), p.hasNext());
|
||||
}
|
||||
|
||||
/** 挂起列表：待推且 retryCount≥挂起阈值（持续重试中疑似消费方停机的可视入口） */
|
||||
public BasePageResult<FlwCallbackLog> pageHung(Long schId, Integer page, Integer size) {
|
||||
Page<FlwCallbackLog> p = logRepository.pageHung(schId, callbackProperties.getHangAlertRetries(),
|
||||
PageRequest.of(page == null || page < 1 ? 0 : page - 1,
|
||||
size == null || size < 1 || size > 100 ? 10 : size));
|
||||
return new BasePageResult<>(p.getContent(), (int) p.getTotalElements(),
|
||||
page == null || page < 1 ? 1 : page,
|
||||
size == null || size < 1 || size > 100 ? 10 : size,
|
||||
p.getTotalPages(), p.hasNext());
|
||||
}
|
||||
|
||||
/**
|
||||
* 管理端手工标记死信（持续重试语义下死信的唯一人工入口：人工判定事件无意义时止血）。
|
||||
* 标记后可经既有 rePush 复活。
|
||||
*/
|
||||
@Transactional
|
||||
public void markDead(Long schId, Long logId) {
|
||||
FlwCallbackLog callbackLog = logRepository.findById(logId)
|
||||
.orElseThrow(() -> new BizException(ErrorCode.PARAM_ERROR, "推送日志不存在：" + logId));
|
||||
if (!schId.equals(callbackLog.getSchId())) {
|
||||
throw new BizException(ErrorCode.FORBIDDEN, "推送日志不属于该学校");
|
||||
}
|
||||
if (callbackLog.getStatus() != null
|
||||
&& callbackLog.getStatus() == FlwEnums.CallbackLogStatus.SUCCESS.getCode()) {
|
||||
throw new BizException(ErrorCode.PARAM_ERROR, "已成功日志无需标记死信");
|
||||
}
|
||||
pushService.markDead(callbackLog, "管理端手工标记死信");
|
||||
}
|
||||
|
||||
/** 手工重推（死信/失败日志）：置回待推并立即触发一次推送 */
|
||||
@Transactional
|
||||
public void rePush(Long schId, List<Long> logIds) {
|
||||
if (logIds == null || logIds.isEmpty()) {
|
||||
throw new BizException(ErrorCode.PARAM_ERROR, "请选择要重推的日志");
|
||||
}
|
||||
List<FlwCallbackLog> logs = logRepository.findByIdInAndSchId(logIds, schId);
|
||||
if (logs.size() != logIds.size()) {
|
||||
throw new BizException(ErrorCode.PARAM_ERROR, "存在不属于该校或不存在 dead/pending 日志");
|
||||
}
|
||||
for (FlwCallbackLog callbackLog : logs) {
|
||||
if (callbackLog.getStatus() == FlwEnums.CallbackLogStatus.SUCCESS.getCode()) {
|
||||
continue;
|
||||
}
|
||||
callbackLog.setStatus(FlwEnums.CallbackLogStatus.PENDING.getCode());
|
||||
callbackLog.setRetryCount(0);
|
||||
callbackLog.setNextRetryTime(LocalDateTime.now());
|
||||
logRepository.save(callbackLog);
|
||||
}
|
||||
logRepository.flush();
|
||||
for (FlwCallbackLog callbackLog : logs) {
|
||||
if (callbackLog.getStatus() != null) {
|
||||
pushService.pushAsync(callbackLog.getId());
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private FlwCallbackReg requireReg(Long schId, Long regId) {
|
||||
FlwCallbackReg reg = regRepository.findById(regId)
|
||||
.orElseThrow(() -> new BizException(ErrorCode.PARAM_ERROR, "回调注册不存在：" + regId));
|
||||
if (!reg.getSchId().equals(schId)) {
|
||||
throw new BizException(ErrorCode.FORBIDDEN, "回调注册不属于该学校");
|
||||
}
|
||||
return reg;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user