此版本仍在开发中,尚未稳定。如需最新的稳定版本,请使用 Spring Framework 7.0.6spring-doc.cadn.net.cn

消息顺序

来自代理的消息被发布到 clientOutboundChannel,从那里它们被写入WebSocket会话。由于该通道由 ThreadPoolExecutor 支持,消息会在不同的线程中处理,客户端接收到的结果顺序可能与发布的顺序不完全一致。spring-doc.cadn.net.cn

要启用有序发布,请按如下方式设置 setPreservePublishOrder 标志:spring-doc.cadn.net.cn

@Configuration
@EnableWebSocketMessageBroker
public class PublishOrderWebSocketConfiguration implements WebSocketMessageBrokerConfigurer {

	@Override
	public void configureMessageBroker(MessageBrokerRegistry registry) {
		// ...
		registry.setPreservePublishOrder(true);
	}

}
@Configuration
@EnableWebSocketMessageBroker
class PublishOrderWebSocketConfiguration : WebSocketMessageBrokerConfigurer {

	override fun configureMessageBroker(registry: MessageBrokerRegistry) {
		// ...
		registry.setPreservePublishOrder(true)
	}
}
<beans xmlns="http://www.springframework.org/schema/beans"
	   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	   xmlns:websocket="http://www.springframework.org/schema/websocket"
	   xsi:schemaLocation="
		http://www.springframework.org/schema/beans
		https://www.springframework.org/schema/beans/spring-beans.xsd
		http://www.springframework.org/schema/websocket
		https://www.springframework.org/schema/websocket/spring-websocket.xsd">

	<websocket:message-broker preserve-publish-order="true">
		<!-- ... -->
	</websocket:message-broker>

</beans>

当设置该标志时,同一客户端会话中的消息将按顺序依次发布到 clientOutboundChannel,从而保证发布的顺序。 请注意,这会带来一定的性能开销,因此只有在需要时才应启用它。spring-doc.cadn.net.cn

同样的情况也适用于来自客户端的消息,这些消息被发送到 clientInboundChannel, 然后根据其目标前缀进行处理。由于该通道由一个 ThreadPoolExecutor 支持,消息将在不同的线程中被处理, 因此处理的最终顺序可能与接收时的确切顺序不一致。spring-doc.cadn.net.cn

要启用有序接收,请如下设置标志setPreserveReceiveOrderspring-doc.cadn.net.cn

@Configuration
@EnableWebSocketMessageBroker
public class ReceiveOrderWebSocketConfiguration implements WebSocketMessageBrokerConfigurer {

	@Override
	public void registerStompEndpoints(StompEndpointRegistry registry) {
		registry.setPreserveReceiveOrder(true);
	}
}
@Configuration
@EnableWebSocketMessageBroker
class ReceiveOrderWebSocketConfiguration : WebSocketMessageBrokerConfigurer {

	override fun registerStompEndpoints(registry: StompEndpointRegistry) {
		registry.setPreserveReceiveOrder(true)
	}
}