org.springframework.web.reactive.socket.client

Class UndertowWebSocketClient

java.lang.Object

org.springframework.web.reactive.socket.client.WebSocketClientSupport

org.springframework.web.reactive.socket.client.UndertowWebSocketClient

All Implemented Interfaces:

WebSocketClient

public class UndertowWebSocketClient
extends WebSocketClientSupport
implements WebSocketClient

Undertow based implementation of WebSocketClient.

Since:

5.0

Author:

Violeta Georgieva, Rossen Stoyanchev

Field Summary

Fields inherited from class org.springframework.web.reactive.socket.client.WebSocketClientSupport

logger

Constructor Summary

Constructors

Constructor and Description
UndertowWebSocketClient(XnioWorker worker) Constructor with the XnioWorker to pass to WebSocketClient.connectionBuilder(org.xnio.XnioWorker, io.undertow.connector.ByteBufferPool, java.net.URI)
UndertowWebSocketClient(XnioWorker worker, java.util.function.Consumer<io.undertow.websockets.client.WebSocketClient.ConnectionBuilder> builderConsumer) Alternate constructor providing additional control over the WebSocketClient.ConnectionBuilder for each WebSocket connection.

Method Summary

Modifier and Type	Method and Description
protected io.undertow.websockets.client.WebSocketClient.ConnectionBuilder	createConnectionBuilder(java.net.URI url) Create a WebSocketClient.ConnectionBuilder for the given URI.
reactor.core.publisher.Mono<java.lang.Void>	execute(java.net.URI url, HttpHeaders headers, WebSocketHandler handler) A variant of WebSocketClient.execute(URI, WebSocketHandler) with custom headers.
reactor.core.publisher.Mono<java.lang.Void>	execute(java.net.URI url, WebSocketHandler handler) Execute a handshake request to the given url and handle the resulting WebSocket session with the given handler.
java.util.function.Consumer<io.undertow.websockets.client.WebSocketClient.ConnectionBuilder>	getConnectionBuilderConsumer() Return the configured Consumer<ConnectionBuilder.
int	getPoolBufferSize() Return the size for Undertow's WebSocketClient ByteBufferPool.
XnioWorker	getXnioWorker() Return the configured XnioWorker.
void	setPoolBufferSize(int poolBufferSize) Configure the size of the ByteBufferPool to pass to WebSocketClient.connectionBuilder(org.xnio.XnioWorker, io.undertow.connector.ByteBufferPool, java.net.URI).

Methods inherited from class org.springframework.web.reactive.socket.client.WebSocketClientSupport

afterHandshake, beforeHandshake

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UndertowWebSocketClient

public UndertowWebSocketClient(XnioWorker worker)

Constructor with the XnioWorker to pass to WebSocketClient.connectionBuilder(org.xnio.XnioWorker, io.undertow.connector.ByteBufferPool, java.net.URI)

Parameters:

worker - the Xnio worker

UndertowWebSocketClient

public UndertowWebSocketClient(XnioWorker worker,
                               java.util.function.Consumer<io.undertow.websockets.client.WebSocketClient.ConnectionBuilder> builderConsumer)

Alternate constructor providing additional control over the WebSocketClient.ConnectionBuilder for each WebSocket connection.

Parameters:

worker - the Xnio worker to use to create ConnectionBuilder's

builderConsumer - a consumer to configure ConnectionBuilder's

Method Detail

getXnioWorker

public XnioWorker getXnioWorker()

Return the configured XnioWorker.

getConnectionBuilderConsumer

public java.util.function.Consumer<io.undertow.websockets.client.WebSocketClient.ConnectionBuilder> getConnectionBuilderConsumer()

Return the configured Consumer<ConnectionBuilder.

setPoolBufferSize

public void setPoolBufferSize(int poolBufferSize)

Configure the size of the ByteBufferPool to pass to WebSocketClient.connectionBuilder(org.xnio.XnioWorker, io.undertow.connector.ByteBufferPool, java.net.URI).

By default the buffer size is set to 8192.

getPoolBufferSize

public int getPoolBufferSize()

Return the size for Undertow's WebSocketClient ByteBufferPool.

execute

public reactor.core.publisher.Mono<java.lang.Void> execute(java.net.URI url,
                                                           WebSocketHandler handler)

Description copied from interface: WebSocketClient

Execute a handshake request to the given url and handle the resulting WebSocket session with the given handler.

Specified by:

execute in interface WebSocketClient

Parameters:

url - the handshake url

handler - the handler of the WebSocket session

Returns:

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

execute

public reactor.core.publisher.Mono<java.lang.Void> execute(java.net.URI url,
                                                           HttpHeaders headers,
                                                           WebSocketHandler handler)

Description copied from interface: WebSocketClient

A variant of WebSocketClient.execute(URI, WebSocketHandler) with custom headers.

Specified by:

execute in interface WebSocketClient

Parameters:

url - the handshake url

headers - custom headers for the handshake request

handler - the handler of the WebSocket session

Returns:

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

createConnectionBuilder

protected io.undertow.websockets.client.WebSocketClient.ConnectionBuilder createConnectionBuilder(java.net.URI url)

Create a WebSocketClient.ConnectionBuilder for the given URI.

The default implementation creates a builder with the configured XnioWorker and getPoolBufferSize() and then passes it to the consumer provided at construction time.