用户目的地

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

在使用用户目标时，务必配置代理和应用程序目标前缀，如启用 STOMP中所示，否则代理将处理应该仅由UserDestinationMessageHandler处理的以“/user”为前缀的消息。

在发送端，可以将消息发送到诸如/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完全相同（即，仅将发送正在处理的消息的会话作为目标）。

例如，您可以通过注入由 Java 配置或 XML 命名空间创建的SimpMessagingTemplate，从任何应用程序组件向用户目标发送消息。（如果需要使用@Qualifier进行限定，则 bean 名称是brokerMessagingTemplate。）以下示例显示了如何执行此操作

@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());
	}
}

当您将用户目标与外部消息代理一起使用时，您应该检查代理文档中有关如何管理非活动队列的信息，以便在用户会话结束时，删除所有唯一的用户队列。例如，当您使用诸如/exchange/amq.direct/position-updates的目标时，RabbitMQ 会创建自动删除的队列。因此，在这种情况下，客户端可以订阅/user/exchange/amq.direct/position-updates。类似地，ActiveMQ 具有配置选项用于清除非活动目标。

在多应用程序服务器方案中，用户目标可能无法解析，因为用户已连接到不同的服务器。在这种情况下，您可以配置目标以广播未解析的消息，以便其他服务器有机会尝试。这可以通过 Java 配置中MessageBrokerRegistry的userDestinationBroadcast属性以及 XML 中message-broker元素的user-destination-broadcast属性来完成。