Files
webgame-backend/src/main/java/com/webgame/webgamebackend/sse/SseController.java
T

94 lines
3.7 KiB
Java
Raw Normal View History

2026-06-22 13:43:25 +08:00
package com.webgame.webgamebackend.sse;
import cn.dev33.satoken.stp.StpUtil;
2026-06-24 10:40:28 +08:00
import jakarta.servlet.http.HttpServletResponse;
2026-06-22 13:43:25 +08:00
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.GetMapping;
2026-06-24 08:30:22 +08:00
import org.springframework.web.bind.annotation.RequestHeader;
2026-06-22 13:43:25 +08:00
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.servlet.mvc.method.annotation.SseEmitter;
import java.io.IOException;
/**
2026-06-24 08:30:22 +08:00
* SSE 订阅端点
2026-06-24 09:50:01 +08:00
*
* 提供 GET /sse/subscribe 端点建立持久化 SSE 连接。
* 心跳由 SseConnectionManager 统一批量管理,此处不再维护 per-connection 定时器。
2026-06-22 13:43:25 +08:00
*/
@Slf4j
@RestController
@RequestMapping("/sse")
@RequiredArgsConstructor
public class SseController {
2026-06-24 09:50:01 +08:00
/** SseEmitter 超时时间(30 分钟),超时后由 SseConnectionManager 的 onTimeout 回调清理 */
2026-06-24 08:30:22 +08:00
private static final long SSE_TIMEOUT_MS = 30 * 60 * 1000L;
2026-06-22 13:43:25 +08:00
private final SseConnectionManager connectionManager;
@GetMapping(value = "/subscribe", produces = MediaType.TEXT_EVENT_STREAM_VALUE)
2026-06-24 08:30:22 +08:00
public SseEmitter subscribe(
2026-06-24 10:40:28 +08:00
@RequestHeader(value = "Last-Event-ID", required = false) String lastEventId,
HttpServletResponse response) throws IOException {
// SSE 路径已排除在 SaInterceptor 之外,此处手动校验登录态
String token = StpUtil.getTokenValue();
if (token == null || token.isBlank()) {
log.warn("[SSE] 缺少认证 token");
return writeAuthError(response, HttpServletResponse.SC_UNAUTHORIZED, "缺少认证信息,请先登录");
}
Object loginId = StpUtil.getLoginIdByToken(token);
if (loginId == null) {
log.warn("[SSE] token 无效或已过期");
return writeAuthError(response, HttpServletResponse.SC_UNAUTHORIZED, "登录已过期,请重新登录");
}
// 设置 Sa-Token 上下文,后续 StpUtil.getLoginIdAsString() 可用
StpUtil.setTokenValue(token, -1);
String userId = loginId.toString();
2026-06-24 08:30:22 +08:00
SseEmitter emitter = new SseEmitter(SSE_TIMEOUT_MS);
String connectionId = connectionManager.register(userId, emitter);
2026-06-22 13:43:25 +08:00
2026-06-24 09:50:01 +08:00
// 发送初始连接确认
2026-06-22 13:43:25 +08:00
try {
emitter.send(SseEmitter.event()
.name("connected")
.data("{\"message\":\"连接成功\"}"));
2026-06-24 08:30:22 +08:00
} catch (IOException | IllegalStateException e) {
log.warn("[SSE] 发送 connected 事件失败, userId={}, connectionId={}",
userId, connectionId, e);
connectionManager.remove(userId, connectionId);
2026-06-22 13:43:25 +08:00
}
2026-06-24 08:30:22 +08:00
if (lastEventId != null && !lastEventId.isBlank()) {
log.debug("[SSE] 客户端重连, Last-Event-ID={}, userId={}, connectionId={}",
lastEventId, userId, connectionId);
}
2026-06-22 13:43:25 +08:00
return emitter;
}
2026-06-24 10:40:28 +08:00
/**
* 向 SSE 客户端返回认证错误
*
* 直接写入 HttpServletResponse 返回 401 + SSE error 事件,
* 前端 SseClient.onopen 检测到 response.status === 401 后触发 onUnauthorized,
* 自动刷新 token 并重连。
*
* @return null,通知 Spring MVC 响应已处理完毕,无需 MessageConverter
*/
private SseEmitter writeAuthError(HttpServletResponse response, int status, String message) throws IOException {
response.setStatus(status);
response.setContentType(MediaType.TEXT_EVENT_STREAM_VALUE);
response.getWriter().write("event: error\ndata: {\"code\":" + status + ",\"message\":\"" + message + "\"}\n\n");
response.getWriter().flush();
return null;
}
2026-06-22 13:43:25 +08:00
}