接口 WebSocketMessageBrokerConfigurer
public interface WebSocketMessageBrokerConfigurer
Defines methods for configuring message handling with simple messaging protocols (e.g. STOMP) from WebSocket clients.Typically used to customize the configuration provided via
@EnableWebSocketMessageBroker.- 从以下版本开始:
- 4.0
- 作者:
- Rossen Stoyanchev
方法概要
所有方法 实例方法 默认方法 修饰符和类型 方法 说明 default voidaddArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers)Add resolvers to support custom controller method argument types.default voidaddReturnValueHandlers(List<HandlerMethodReturnValueHandler> returnValueHandlers)Add handlers to support custom controller method return value types.default voidconfigureClientInboundChannel(ChannelRegistration registration)Configure theMessageChannelused for incoming messages from WebSocket clients.default voidconfigureClientOutboundChannel(ChannelRegistration registration)Configure theMessageChannelused for outbound messages to WebSocket clients.default voidconfigureMessageBroker(MessageBrokerRegistry registry)Configure message broker options.default booleanconfigureMessageConverters(List<MessageConverter> messageConverters)Configure the message converters to use when extracting the payload of messages in annotated methods and when sending messages (e.g. through the "broker" SimpMessagingTemplate).default voidconfigureWebSocketTransport(WebSocketTransportRegistration registry)Configure options related to the processing of messages received from and sent to WebSocket clients.default voidregisterStompEndpoints(StompEndpointRegistry registry)Register STOMP endpoints mapping each to a specific URL and (optionally) enabling and configuring SockJS fallback options.
方法详细资料
registerStompEndpoints
default void registerStompEndpoints(StompEndpointRegistry registry)
Register STOMP endpoints mapping each to a specific URL and (optionally) enabling and configuring SockJS fallback options.
configureWebSocketTransport
default void configureWebSocketTransport(WebSocketTransportRegistration registry)
Configure options related to the processing of messages received from and sent to WebSocket clients.
configureClientInboundChannel
default void configureClientInboundChannel(ChannelRegistration registration)
Configure theMessageChannelused for incoming messages from WebSocket clients. By default the channel is backed by a thread pool of size 1. It is recommended to customize thread pool settings for production use.
configureClientOutboundChannel
default void configureClientOutboundChannel(ChannelRegistration registration)
Configure theMessageChannelused for outbound messages to WebSocket clients. By default the channel is backed by a thread pool of size 1. It is recommended to customize thread pool settings for production use.
addArgumentResolvers
default void addArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers)
Add resolvers to support custom controller method argument types.This does not override the built-in support for resolving handler method arguments. To customize the built-in support for argument resolution, configure
SimpAnnotationMethodMessageHandlerdirectly.- 参数:
argumentResolvers- the resolvers to register (initially an empty list)- 从以下版本开始:
- 4.1.1
addReturnValueHandlers
default void addReturnValueHandlers(List<HandlerMethodReturnValueHandler> returnValueHandlers)
Add handlers to support custom controller method return value types.Using this option does not override the built-in support for handling return values. To customize the built-in support for handling return values, configure
SimpAnnotationMethodMessageHandlerdirectly.- 参数:
returnValueHandlers- the handlers to register (initially an empty list)- 从以下版本开始:
- 4.1.1
configureMessageConverters
default boolean configureMessageConverters(List<MessageConverter> messageConverters)
Configure the message converters to use when extracting the payload of messages in annotated methods and when sending messages (e.g. through the "broker" SimpMessagingTemplate).The provided list, initially empty, can be used to add message converters while the boolean return value is used to determine if default message should be added as well.
- 参数:
messageConverters- the converters to configure (initially an empty list)- 返回:
- whether to also add default converter or not
configureMessageBroker
default void configureMessageBroker(MessageBrokerRegistry registry)
Configure message broker options.