类 WebSocketTransportRegistration
- java.lang.Object
- org.springframework.web.socket.config.annotation.WebSocketTransportRegistration
public class WebSocketTransportRegistration extends Object
Configure the processing of messages received from and sent to WebSocket clients.- 从以下版本开始:
- 4.0.3
- 作者:
- Rossen Stoyanchev
构造器概要
构造器 构造器 说明 WebSocketTransportRegistration()
方法概要
所有方法 实例方法 具体方法 修饰符和类型 方法 说明 WebSocketTransportRegistration
addDecoratorFactory(WebSocketHandlerDecoratorFactory factory)
Add a factory that to decorate the handler used to process WebSocket messages.protected List<WebSocketHandlerDecoratorFactory>
getDecoratorFactories()
protected Integer
getMessageSizeLimit()
Protected accessor for internal use.protected Integer
getSendBufferSizeLimit()
Protected accessor for internal use.protected Integer
getSendTimeLimit()
Protected accessor for internal use.protected Integer
getTimeToFirstMessage()
Protected accessor for internal use.WebSocketTransportRegistration
setDecoratorFactories(WebSocketHandlerDecoratorFactory... factories)
Configure one or more factories to decorate the handler used to process WebSocket messages.WebSocketTransportRegistration
setMessageSizeLimit(int messageSizeLimit)
Configure the maximum size of an inbound sub-protocol message, such as a STOMP frame which may be aggregated from multiple WebSocket messages.WebSocketTransportRegistration
setSendBufferSizeLimit(int sendBufferSizeLimit)
Configure the maximum amount of data to buffer when sending messages to a WebSocket session, or an HTTP response when SockJS fallback option are in use.WebSocketTransportRegistration
setSendTimeLimit(int timeLimit)
Configure a time limit (in milliseconds) for the maximum amount of a time allowed when sending messages to a WebSocket session or writing to an HTTP response when SockJS fallback option are in use.WebSocketTransportRegistration
setTimeToFirstMessage(int timeToFirstMessage)
Set the maximum time allowed in milliseconds after the WebSocket connection is established and before the first sub-protocol message is received.
构造器详细资料
WebSocketTransportRegistration
public WebSocketTransportRegistration()
方法详细资料
setMessageSizeLimit
public WebSocketTransportRegistration setMessageSizeLimit(int messageSizeLimit)
Configure the maximum size of an inbound sub-protocol message, such as a STOMP frame which may be aggregated from multiple WebSocket messages.The default value is 64K (i.e. 64 * 1024).
Note: This is not the same as the size of an individual WebSocket message which needs to be configured at the WebSocket server level instead. See the reference documentation for details.
getMessageSizeLimit
@Nullable protected Integer getMessageSizeLimit()
Protected accessor for internal use.
setSendTimeLimit
public WebSocketTransportRegistration setSendTimeLimit(int timeLimit)
Configure a time limit (in milliseconds) for the maximum amount of a time allowed when sending messages to a WebSocket session or writing to an HTTP response when SockJS fallback option are in use.In general WebSocket servers expect that messages to a single WebSocket session are sent from a single thread at a time. This is automatically guaranteed when using
@EnableWebSocketMessageBroker
configuration. If message sending is slow, or at least slower than rate of messages sending, subsequent messages are buffered until either thesendTimeLimit
or thesendBufferSizeLimit
are reached at which point the session state is cleared and an attempt is made to close the session.NOTE that the session time limit is checked only on attempts to send additional messages. So if only a single message is sent and it hangs, the session will not time out until another message is sent or the underlying physical socket times out. So this is not a replacement for WebSocket server or HTTP connection timeout but is rather intended to control the extent of buffering of unsent messages.
NOTE that closing the session may not succeed in actually closing the physical socket and may also hang. This is true especially when using blocking IO such as the BIO connector in Tomcat that is used by default on Tomcat 7. Therefore it is recommended to ensure the server is using non-blocking IO such as Tomcat's NIO connector that is used by default on Tomcat 8. If you must use blocking IO consider customizing OS-level TCP settings, for example
/proc/sys/net/ipv4/tcp_retries2
on Linux.The default value is 10 seconds (i.e. 10 * 10000).
- 参数:
timeLimit
- the timeout value in milliseconds; the value must be greater than 0, otherwise it is ignored.
getSendTimeLimit
@Nullable protected Integer getSendTimeLimit()
Protected accessor for internal use.
setSendBufferSizeLimit
public WebSocketTransportRegistration setSendBufferSizeLimit(int sendBufferSizeLimit)
Configure the maximum amount of data to buffer when sending messages to a WebSocket session, or an HTTP response when SockJS fallback option are in use.In general WebSocket servers expect that messages to a single WebSocket session are sent from a single thread at a time. This is automatically guaranteed when using
@EnableWebSocketMessageBroker
configuration. If message sending is slow, or at least slower than rate of messages sending, subsequent messages are buffered until either thesendTimeLimit
or thesendBufferSizeLimit
are reached at which point the session state is cleared and an attempt is made to close the session.NOTE that closing the session may not succeed in actually closing the physical socket and may also hang. This is true especially when using blocking IO such as the BIO connector in Tomcat configured by default on Tomcat 7. Therefore it is recommended to ensure the server is using non-blocking IO such as Tomcat's NIO connector used by default on Tomcat 8. If you must use blocking IO consider customizing OS-level TCP settings, for example
/proc/sys/net/ipv4/tcp_retries2
on Linux.The default value is 512K (i.e. 512 * 1024).
- 参数:
sendBufferSizeLimit
- the maximum number of bytes to buffer when sending messages; if the value is less than or equal to 0 then buffering is effectively disabled.
getSendBufferSizeLimit
@Nullable protected Integer getSendBufferSizeLimit()
Protected accessor for internal use.
setTimeToFirstMessage
public WebSocketTransportRegistration setTimeToFirstMessage(int timeToFirstMessage)
Set the maximum time allowed in milliseconds after the WebSocket connection is established and before the first sub-protocol message is received.This handler is for WebSocket connections that use a sub-protocol. Therefore, we expect the client to send at least one sub-protocol message in the beginning, or else we assume the connection isn't doing well, e.g. proxy issue, slow network, and can be closed.
By default this is set to
60,000
(1 minute).- 参数:
timeToFirstMessage
- the maximum time allowed in milliseconds- 从以下版本开始:
- 5.1
getTimeToFirstMessage
@Nullable protected Integer getTimeToFirstMessage()
Protected accessor for internal use.
setDecoratorFactories
public WebSocketTransportRegistration setDecoratorFactories(WebSocketHandlerDecoratorFactory... factories)
Configure one or more factories to decorate the handler used to process WebSocket messages. This may be useful in some advanced use cases, for example to allow Spring Security to forcibly close the WebSocket session when the corresponding HTTP session expires.- 从以下版本开始:
- 4.1.2
addDecoratorFactory
public WebSocketTransportRegistration addDecoratorFactory(WebSocketHandlerDecoratorFactory factory)
Add a factory that to decorate the handler used to process WebSocket messages. This may be useful for some advanced use cases, for example to allow Spring Security to forcibly close the WebSocket session when the corresponding HTTP session expires.- 从以下版本开始:
- 4.1.2
getDecoratorFactories
protected List<WebSocketHandlerDecoratorFactory> getDecoratorFactories()