此版本仍在开发中,尚不被认为是稳定的。对于最新的稳定版本,请使用 Spring Framework 6.2.10spring-doc.cadn.net.cn

用户目标

应用程序可以发送针对特定用户的消息,并且 Spring 的 STOMP 支持 识别以 为前缀的目的地/user/为此目的。 例如,客户端可能会订阅/user/queue/position-updates目的地。UserDestinationMessageHandler处理此目的地并将其转换为 用户会话唯一的目标(例如/queue/position-updates-user123). 这提供了订阅通用命名目标的便利,同时, 同时,确保不会与订阅相同的其他用户发生冲突 目的地,以便每个用户都可以接收唯一的股票头寸更新。spring-doc.cadn.net.cn

使用用户目标时,配置代理和 应用程序目标前缀,如启用 STOMP 中所示,否则 broker 将处理仅应由UserDestinationMessageHandler.

在发送端,可以将消息发送到目标,例如/user/{username}/queue/position-updates,这反过来又被翻译 通过UserDestinationMessageHandler到一个或多个目的地,每个目的地一个 会话。这允许应用程序中的任何组件 发送针对特定用户的消息,而不一定知道更多信息 而不是它们的名称和通用目的地。这也通过 注释和消息传递模板。spring-doc.cadn.net.cn

消息处理方法可以向与 通过@SendToUser注释(也支持 类级别共享公共目标),如以下示例所示:spring-doc.cadn.net.cn

@Controller
public class PortfolioController {

	@MessageMapping("/trade")
	@SendToUser("/queue/position-updates")
	public TradeResult executeTrade(Trade trade, Principal principal) {
		// ...
		return tradeResult;
	}
}

如果用户有多个会话,则默认情况下,所有会话都已订阅 到给定的目的地是有针对性的。但是,有时,可能需要 仅面向发送正在处理的消息的会话。您可以通过以下方式做到这一点 将broadcast属性设置为 false,如以下示例所示:spring-doc.cadn.net.cn

@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.)以下示例显示了如何执行此作:spring-doc.cadn.net.cn

@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-brokerXML 中的元素。spring-doc.cadn.net.cn