org.springframework.web.reactive.socket.server

Interface RequestUpgradeStrategy

All Known Implementing Classes:

JettyRequestUpgradeStrategy, ReactorNettyRequestUpgradeStrategy, TomcatRequestUpgradeStrategy, UndertowRequestUpgradeStrategy

public interface RequestUpgradeStrategy

A strategy for upgrading an HTTP request to a WebSocket session depending on the underlying network runtime.

Typically there is one such strategy for every ServerHttpRequest and ServerHttpResponse type except in the case of Servlet containers for which the standard Java WebSocket API JSR-356 does not define a way to upgrade a request so a custom strategy is needed for every Servlet container.

Since:

5.0

Author:

Rossen Stoyanchev

Method Summary

Modifier and Type	Method and Description
reactor.core.publisher.Mono<java.lang.Void>	upgrade(ServerWebExchange exchange, WebSocketHandler webSocketHandler, java.lang.String subProtocol) Upgrade to a WebSocket session and handle it with the given handler.

Method Detail

upgrade

reactor.core.publisher.Mono<java.lang.Void> upgrade(ServerWebExchange exchange,
                                                    WebSocketHandler webSocketHandler,
                                                    @Nullable
                                                    java.lang.String subProtocol)

Upgrade to a WebSocket session and handle it with the given handler.

Parameters:

exchange - the current exchange

webSocketHandler - handler for the WebSocket session

subProtocol - the selected sub-protocol got the handler

Returns:

completion Mono<Void> to indicate the outcome of the WebSocket session handling.