此版本仍在开发中,尚不被认为是稳定的。对于最新的稳定版本,请使用 Spring Framework 6.2.10! |
用户目标
应用程序可以发送针对特定用户的消息,并且 Spring 的 STOMP 支持
识别以 为前缀的目的地/user/
为此目的。
例如,客户端可能会订阅/user/queue/position-updates
目的地。UserDestinationMessageHandler
处理此目的地并将其转换为
用户会话唯一的目标(例如/queue/position-updates-user123
).
这提供了订阅通用命名目标的便利,同时,
同时,确保不会与订阅相同的其他用户发生冲突
目的地,以便每个用户都可以接收唯一的股票头寸更新。
使用用户目标时,配置代理和
应用程序目标前缀,如启用 STOMP 中所示,否则
broker 将处理仅应由UserDestinationMessageHandler . |
在发送端,可以将消息发送到目标,例如/user/{username}/queue/position-updates
,这反过来又被翻译
通过UserDestinationMessageHandler
到一个或多个目的地,每个目的地一个
会话。这允许应用程序中的任何组件
发送针对特定用户的消息,而不一定知道更多信息
而不是它们的名称和通用目的地。这也通过
注释和消息传递模板。
消息处理方法可以向与
通过@SendToUser
注释(也支持
类级别共享公共目标),如以下示例所示:
@Controller
public class PortfolioController {
@MessageMapping("/trade")
@SendToUser("/queue/position-updates")
public TradeResult executeTrade(Trade trade, Principal principal) {
// ...
return tradeResult;
}
}
如果用户有多个会话,则默认情况下,所有会话都已订阅
到给定的目的地是有针对性的。但是,有时,可能需要
仅面向发送正在处理的消息的会话。您可以通过以下方式做到这一点
将broadcast
属性设置为 false,如以下示例所示:
@Controller
public class MyController {
@MessageMapping("/action")
public void handleAction() throws Exception{
// raise MyBusinessException here
}
@MessageExceptionHandler
@SendToUser(destinations="/queue/errors", broadcast=false)
public ApplicationError handleException(MyBusinessException exception) {
// ...
return appError;
}
}
虽然用户目标通常意味着经过身份验证的用户,但并不是严格要求的。
未与经过身份验证的用户关联的 WebSocket 会话
可以订阅用户目标。在这种情况下,@SendToUser 注解
行为与broadcast=false (也就是说,仅针对
发送正在处理的消息的会话)。 |
您可以从任何应用程序向用户目标发送消息
组件,例如,注入SimpMessagingTemplate
由 Java 配置创建或
XML 命名空间。(豆名是brokerMessagingTemplate
如果需要
对于资格@Qualifier
.)以下示例显示了如何执行此作:
@Service
public class TradeServiceImpl implements TradeService {
private final SimpMessagingTemplate messagingTemplate;
@Autowired
public TradeServiceImpl(SimpMessagingTemplate messagingTemplate) {
this.messagingTemplate = messagingTemplate;
}
// ...
public void afterTradeExecuted(Trade trade) {
this.messagingTemplate.convertAndSendToUser(
trade.getUserName(), "/queue/position-updates", trade.getResult());
}
}
将用户目标与外部消息代理一起使用时,应检查代理
有关如何管理非活动队列的文档,以便当用户会话
结束时,将删除所有唯一用户队列。例如,RabbitMQ 创建自动删除
队列/exchange/amq.direct/position-updates .
因此,在这种情况下,客户端可以订阅/user/exchange/amq.direct/position-updates .
同样,ActiveMQ 具有用于清除非活动目标的配置选项。 |
在多应用程序服务器方案中,用户目标可能保持未解析状态,因为
用户连接到不同的服务器。在这种情况下,您可以配置
destination 广播未解析的消息,以便其他服务器有机会尝试。
这可以通过userDestinationBroadcast
属性的MessageBrokerRegistry
在 Java 配置中,并且user-destination-broadcast
属性
的message-broker
XML 中的元素。