org.springframework.web.reactive.socket.adapter

Class AbstractListenerWebSocketSession<T>

java.lang.Object

org.springframework.web.reactive.socket.adapter.AbstractWebSocketSession<T>

org.springframework.web.reactive.socket.adapter.AbstractListenerWebSocketSession<T>

All Implemented Interfaces:

org.reactivestreams.Subscriber<java.lang.Void>, WebSocketSession

Direct Known Subclasses:

JettyWebSocketSession, StandardWebSocketSession, UndertowWebSocketSession

public abstract class AbstractListenerWebSocketSession<T>
extends AbstractWebSocketSession<T>
implements org.reactivestreams.Subscriber<java.lang.Void>

Base class for WebSocketSession implementations that bridge between event-listener WebSocket APIs (e.g. Java WebSocket API JSR-356, Jetty, Undertow) and Reactive Streams.

Also an implementation of Subscriber<Void> so it can be used as the completion subscriber for session handling

Since:

5.0

Author:

Violeta Georgieva, Rossen Stoyanchev

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AbstractListenerWebSocketSession.WebSocketSendProcessor

Constructor Summary

Constructors

Constructor and Description
AbstractListenerWebSocketSession(T delegate, java.lang.String id, HandshakeInfo handshakeInfo, org.springframework.core.io.buffer.DataBufferFactory bufferFactory) Base constructor.
AbstractListenerWebSocketSession(T delegate, java.lang.String id, HandshakeInfo handshakeInfo, org.springframework.core.io.buffer.DataBufferFactory bufferFactory, reactor.core.publisher.MonoProcessor<java.lang.Void> completionMono) Alternative constructor with completion Mono&lt;Void&gt; to propagate the session completion (success or error) (for client-side use).

Method Summary

Modifier and Type	Method and Description
protected abstract boolean	canSuspendReceiving() Whether the underlying WebSocket API has flow control and can suspend and resume the receiving of messages.
protected AbstractListenerWebSocketSession.WebSocketSendProcessor	getSendProcessor()
void	onComplete()
void	onError(java.lang.Throwable ex)
void	onNext(java.lang.Void aVoid)
void	onSubscribe(org.reactivestreams.Subscription subscription)
reactor.core.publisher.Flux<WebSocketMessage>	receive() Get the flux of incoming messages.
protected abstract void	resumeReceiving() Resume receiving new message(s) after demand is generated by the downstream Subscriber.
reactor.core.publisher.Mono<java.lang.Void>	send(org.reactivestreams.Publisher<WebSocketMessage> messages) Write the given messages to the WebSocket connection.
protected abstract boolean	sendMessage(WebSocketMessage message) Send the given WebSocket message.
protected abstract void	suspendReceiving() Suspend receiving until received message(s) are processed and more demand is generated by the downstream Subscriber.

Methods inherited from class org.springframework.web.reactive.socket.adapter.AbstractWebSocketSession

binaryMessage, bufferFactory, getDelegate, getHandshakeInfo, getId, pingMessage, pongMessage, textMessage, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.web.reactive.socket.WebSocketSession

close, close

Constructor Detail

AbstractListenerWebSocketSession

public AbstractListenerWebSocketSession(T delegate,
                                        java.lang.String id,
                                        HandshakeInfo handshakeInfo,
                                        org.springframework.core.io.buffer.DataBufferFactory bufferFactory)

Base constructor.

Parameters:

delegate - the native WebSocket session, channel, or connection

id - the session id

handshakeInfo - the handshake info

bufferFactory - the DataBuffer factor for the current connection

AbstractListenerWebSocketSession

public AbstractListenerWebSocketSession(T delegate,
                                        java.lang.String id,
                                        HandshakeInfo handshakeInfo,
                                        org.springframework.core.io.buffer.DataBufferFactory bufferFactory,
                                        @Nullable
                                        reactor.core.publisher.MonoProcessor<java.lang.Void> completionMono)

Alternative constructor with completion Mono<Void> to propagate the session completion (success or error) (for client-side use).

Method Detail

getSendProcessor

protected AbstractListenerWebSocketSession.WebSocketSendProcessor getSendProcessor()

receive

public reactor.core.publisher.Flux<WebSocketMessage> receive()

Description copied from interface: WebSocketSession

Get the flux of incoming messages.

Specified by:

receive in interface WebSocketSession

Specified by:

receive in class AbstractWebSocketSession<T>

send

public reactor.core.publisher.Mono<java.lang.Void> send(org.reactivestreams.Publisher<WebSocketMessage> messages)

Description copied from interface: WebSocketSession

Write the given messages to the WebSocket connection.

Specified by:

send in interface WebSocketSession

Specified by:

send in class AbstractWebSocketSession<T>

Parameters:

messages - the messages to write

canSuspendReceiving

protected abstract boolean canSuspendReceiving()

Whether the underlying WebSocket API has flow control and can suspend and resume the receiving of messages.

suspendReceiving

protected abstract void suspendReceiving()

Suspend receiving until received message(s) are processed and more demand is generated by the downstream Subscriber.

Note: if the underlying WebSocket API does not provide flow control for receiving messages, and this method should be a no-op and canSuspendReceiving() should return false.

resumeReceiving

protected abstract void resumeReceiving()

Resume receiving new message(s) after demand is generated by the downstream Subscriber.

Note: if the underlying WebSocket API does not provide flow control for receiving messages, and this method should be a no-op and canSuspendReceiving() should return false.

sendMessage

protected abstract boolean sendMessage(WebSocketMessage message)
                                throws java.io.IOException

Send the given WebSocket message.

Throws:

java.io.IOException

onSubscribe

public void onSubscribe(org.reactivestreams.Subscription subscription)

Specified by:

onSubscribe in interface org.reactivestreams.Subscriber<java.lang.Void>

onNext

public void onNext(java.lang.Void aVoid)

Specified by:

onNext in interface org.reactivestreams.Subscriber<java.lang.Void>

onError

public void onError(java.lang.Throwable ex)

Specified by:

onError in interface org.reactivestreams.Subscriber<java.lang.Void>

onComplete

public void onComplete()

Specified by:

onComplete in interface org.reactivestreams.Subscriber<java.lang.Void>