Module io.helidon.nima.websocket.client

Package io.helidon.nima.websocket.client

Class ClientWsConnection

java.lang.Object

io.helidon.nima.websocket.client.ClientWsConnection

All Implemented Interfaces:

WsSession, Runnable

public class ClientWsConnection
extends Object
implements WsSession, Runnable

Client WebSocket connection. This connection handles a single WebSocket interaction, using WsListener to handle connection events.

Method Summary

Modifier and Type	Method	Description
WsSession	close(int code, String reason)	Close session.
static ClientWsConnection	create(WsListener listener, HelidonSocket helidonSocket, DataReader reader, DataWriter writer, Optional<String> subProtocol)	Create a new connection.
WsSession	ping(BufferData bufferData)	Send ping.
WsSession	pong(BufferData bufferData)	Send pong.
void	run()
WsSession	send(BufferData bufferData, boolean last)	Send binary fragment.
WsSession	send(String text, boolean last)	Send text fragment.
Optional<String>	subProtocol()	The WebSocket sub-protocol negotiated for this session.
WsSession	terminate()	Terminate session.

Methods inherited from class java.lang.Object

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

Method Details

create

public static ClientWsConnection create(WsListener listener,
 HelidonSocket helidonSocket,
 DataReader reader,
 DataWriter writer,
 Optional<String> subProtocol)

Create a new connection. The connection needs to run on ana executor service (it implements Runnable) so it does not block the current thread.

Parameters:

listener - WebSocket listener to handle events on this connection

helidonSocket - Helidon Socket to obtain information about peer

reader - used to read data from remote server

writer - use to write data to remote server

subProtocol - chosen sub-protocol of this connection (negotiated during upgrade from HTTP/1)

Returns:

a new WebSocket connection

run

public void run()

Specified by:

run in interface Runnable

send

public WsSession send(String text,
 boolean last)

Description copied from interface: WsSession

Send text fragment.

Specified by:

send in interface WsSession

Parameters:

text - text to send

last - if last fragment

Returns:

this instance

send

public WsSession send(BufferData bufferData,
 boolean last)

Description copied from interface: WsSession

Send binary fragment.

Specified by:

send in interface WsSession

Parameters:

bufferData - buffer with data

last - if last fragment

Returns:

this instance

ping

public WsSession ping(BufferData bufferData)

Description copied from interface: WsSession

Send ping.

Specified by:

ping in interface WsSession

Parameters:

bufferData - buffer with data

Returns:

this instance

pong

public WsSession pong(BufferData bufferData)

Description copied from interface: WsSession

Send pong.

Specified by:

pong in interface WsSession

Parameters:

bufferData - buffer with data

Returns:

this instance

close

public WsSession close(int code,
 String reason)

Description copied from interface: WsSession

Close session.

Specified by:

close in interface WsSession

Parameters:

code - close code, may be one of WsCloseCodes

reason - reason description

Returns:

this instance

terminate

public WsSession terminate()

Description copied from interface: WsSession

Terminate session. Sends a close and closes the connection.

Specified by:

terminate in interface WsSession

Returns:

this instance

subProtocol

public Optional<String> subProtocol()

Description copied from interface: WsSession

The WebSocket sub-protocol negotiated for this session.

Specified by:

subProtocol in interface WsSession

Returns:

sub-protocol negotiated, if any