Class ClientWebSocket
- All Implemented Interfaces:
MutinyDelegate,WebSocketBase,ReadStream<io.vertx.core.buffer.Buffer>,StreamBase,WriteStream<io.vertx.core.buffer.Buffer>
NOTE: This class has been automatically generated from the original non Mutiny-ified interface.
- Author:
- Tim Fox
- See Also:
-
ClientWebSocket
-
Nested Class Summary
Nested classes/interfaces inherited from interface io.vertx.mutiny.core.streams.ReadStream
ReadStream.ReadStreamImpl<T>Nested classes/interfaces inherited from interface io.vertx.mutiny.core.streams.StreamBase
StreamBase.StreamBaseImplNested classes/interfaces inherited from interface io.vertx.mutiny.core.http.WebSocketBase
WebSocketBase.WebSocketBaseImplNested classes/interfaces inherited from interface io.vertx.mutiny.core.streams.WriteStream
WriteStream.WriteStreamImpl<T> -
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionClientWebSocket(io.vertx.core.http.ClientWebSocket delegate) Create a new instance ofClientWebSocketdelegating to the given (non-null) instance ofClientWebSocket.ClientWebSocket(Object delegate) -
Method Summary
Modifier and TypeMethodDescriptionWhen aWebSocketis created, it may register an event handler with the event bus - the ID of that handler is given by this method.binaryMessageHandler(Consumer<io.vertx.core.buffer.Buffer> handler) Set a binary message handler on the connection.io.smallrye.mutiny.Uni<Void>close()Close the WebSocket sending the default close frame.io.smallrye.mutiny.Uni<Void>close(short arg0) Close the WebSocket sending a close frame with specified status code.io.smallrye.mutiny.Uni<Void>Close sending a close frame with specified status code and reason.voidClose the WebSocket sending the default close frame.voidcloseAndAwait(short arg0) Close the WebSocket sending a close frame with specified status code.voidcloseAndAwait(short arg0, String arg1) Close sending a close frame with specified status code and reason.Close the WebSocket sending the default close frame.closeAndForget(short arg0) Close the WebSocket sending a close frame with specified status code.closeAndForget(short arg0, String arg1) Close sending a close frame with specified status code and reason.closeHandler(Runnable handler) Set a close handler.Returns the close reason message from the remote endpoint ornullwhen not yet received.Returns the close status code received from the remote endpoint ornullwhen not yet received.io.smallrye.mutiny.Uni<WebSocket>Connect this WebSocket to the specified port, host and relative request URI.io.smallrye.mutiny.Uni<WebSocket>connect(io.vertx.core.http.WebSocketConnectOptions options) Connect this WebSocket with the specified options.io.smallrye.mutiny.Uni<WebSocket>Connect this WebSocket at the relative request URI using the default host and port.io.smallrye.mutiny.Uni<WebSocket>Connect this WebSocket to the host and relative request URI and default port.connectAndAwait(int port, String host, String requestURI) Connect this WebSocket to the specified port, host and relative request URI.connectAndAwait(io.vertx.core.http.WebSocketConnectOptions options) Connect this WebSocket with the specified options.connectAndAwait(String requestURI) Connect this WebSocket at the relative request URI using the default host and port.connectAndAwait(String host, String requestURI) Connect this WebSocket to the host and relative request URI and default port.connectAndForget(int port, String host, String requestURI) Connect this WebSocket to the specified port, host and relative request URI.connectAndForget(io.vertx.core.http.WebSocketConnectOptions options) Connect this WebSocket with the specified options.connectAndForget(String requestURI) Connect this WebSocket at the relative request URI using the default host and port.connectAndForget(String host, String requestURI) Connect this WebSocket to the host and relative request URI and default port.drainHandler(Runnable handler) Set a drain handler on the stream.io.smallrye.mutiny.Uni<Void>end()Ends the stream.io.smallrye.mutiny.Uni<Void>end(io.vertx.core.buffer.Buffer arg0) Same asend()but writes some data to the stream before ending.voidCallsWebSocket.close()voidendAndAwait(io.vertx.core.buffer.Buffer arg0) Same asend()but writes some data to the stream before ending.CallsWebSocket.close()endAndForget(io.vertx.core.buffer.Buffer arg0) Same asend()but writes some data to the stream before ending.endHandler(Runnable endHandler) Set an end handler.booleanexceptionHandler(Consumer<Throwable> handler) Set an exception handler on the read stream.fetch(long amount) Fetch the specifiedamountof elements.frameHandler(Consumer<io.vertx.core.http.WebSocketFrame> handler) Set a frame handler on the connection.io.vertx.core.http.ClientWebSocketGet the delegate instance.Set a data handler.inthashCode()io.vertx.core.MultiMapheaders()Returns the HTTP headers.booleanisClosed()booleanisSsl()io.vertx.core.net.SocketAddressstatic ClientWebSocketnewInstance(io.vertx.core.http.ClientWebSocket delegate) Creates a new instance of theClientWebSocket.pause()Pause theReadStream, it sets the buffer infetchmode and clears the actual demand.Pipe<io.vertx.core.buffer.Buffer>pipe()Pause this stream and return aPipeto transfer the elements of this stream to a destinationWriteStream.io.smallrye.mutiny.Uni<Void>pipeTo(WriteStream<io.vertx.core.buffer.Buffer> arg0) Pipe thisReadStreamto theWriteStream.voidpipeToAndAwait(WriteStream<io.vertx.core.buffer.Buffer> arg0) Pipe thisReadStreamto theWriteStream.pipeToAndForget(WriteStream<io.vertx.core.buffer.Buffer> arg0) Pipe thisReadStreamto theWriteStream.pongHandler(Consumer<io.vertx.core.buffer.Buffer> handler) Set a pong frame handler on the connection.io.vertx.core.net.SocketAddressresume()Resume reading, and sets the buffer inflowingmode.setWriteQueueMaxSize(int maxSize) Set the maximum size of the write queue tomaxSize.io.smallrye.mutiny.Uni<Void>shutdown()Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout, the status code1000anullreason.io.smallrye.mutiny.Uni<Void>Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.io.smallrye.mutiny.Uni<Void>Callsshutdown(long, TimeUnit, short, String)with anullreason.io.smallrye.mutiny.Uni<Void>io.smallrye.mutiny.Uni<Void>shutdown(short arg0) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.io.smallrye.mutiny.Uni<Void>Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.io.smallrye.mutiny.Uni<Void>Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.io.smallrye.mutiny.Uni<Void>Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.io.smallrye.mutiny.Uni<Void>Callsshutdown(long, TimeUnit, short, String)with anullreason.voidLikeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout, the status code1000anullreason.voidshutdownAndAwait(long arg0, TimeUnit arg1) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.voidshutdownAndAwait(long arg0, TimeUnit arg1, short arg2) Callsshutdown(long, TimeUnit, short, String)with anullreason.voidshutdownAndAwait(long arg0, TimeUnit arg1, short arg2, String arg3) voidshutdownAndAwait(short arg0) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.voidshutdownAndAwait(short arg0, String arg1) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.voidshutdownAndAwait(Duration arg0) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.voidshutdownAndAwait(Duration arg0, short arg1) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.voidshutdownAndAwait(Duration arg0, short arg1, String arg2) Callsshutdown(long, TimeUnit, short, String)with anullreason.Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout, the status code1000anullreason.shutdownAndForget(long arg0, TimeUnit arg1) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.shutdownAndForget(long arg0, TimeUnit arg1, short arg2) Callsshutdown(long, TimeUnit, short, String)with anullreason.shutdownAndForget(long arg0, TimeUnit arg1, short arg2, String arg3) shutdownAndForget(short arg0) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.shutdownAndForget(short arg0, String arg1) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.shutdownAndForget(Duration arg0) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.shutdownAndForget(Duration arg0, short arg1) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.shutdownAndForget(Duration arg0, short arg1, String arg2) Callsshutdown(long, TimeUnit, short, String)with anullreason.shutdownHandler(Runnable arg0) Set ahandlernotified when the WebSocket is shutdown: the client or server will close the connection within a certain amount of time.Returns the WebSocket sub protocol selected by the WebSocket handshake.When aWebSocketis created, it may register an event handler with the eventbus, the ID of that handler is given bytextHandlerID.textMessageHandler(Consumer<String> handler) Set a text message handler on the connection.Iterable<io.vertx.core.buffer.Buffer>Stream<io.vertx.core.buffer.Buffer>io.smallrye.mutiny.Multi<io.vertx.core.buffer.Buffer>toMulti()toString()Flow.Subscriber<io.vertx.core.buffer.Buffer>Converts the current write stream to a subscriber.io.smallrye.mutiny.Uni<Void>write(io.vertx.core.buffer.Buffer arg0) Write some data to the stream.voidwriteAndAwait(io.vertx.core.buffer.Buffer arg0) Write some data to the stream.writeAndForget(io.vertx.core.buffer.Buffer arg0) Write some data to the stream.io.smallrye.mutiny.Uni<Void>writeBinaryMessage(io.vertx.core.buffer.Buffer arg0) Writes a (potentially large) piece of binary data to the connection.voidwriteBinaryMessageAndAwait(io.vertx.core.buffer.Buffer arg0) Writes a (potentially large) piece of binary data to the connection.writeBinaryMessageAndForget(io.vertx.core.buffer.Buffer arg0) Writes a (potentially large) piece of binary data to the connection.io.smallrye.mutiny.Uni<Void>writeFinalBinaryFrame(io.vertx.core.buffer.Buffer arg0) Write a final WebSocket binary frame to the connectionvoidwriteFinalBinaryFrameAndAwait(io.vertx.core.buffer.Buffer arg0) Write a final WebSocket binary frame to the connectionwriteFinalBinaryFrameAndForget(io.vertx.core.buffer.Buffer arg0) Write a final WebSocket binary frame to the connectionio.smallrye.mutiny.Uni<Void>writeFinalTextFrame(String arg0) Write a final WebSocket text frame to the connectionvoidWrite a final WebSocket text frame to the connectionWrite a final WebSocket text frame to the connectionio.smallrye.mutiny.Uni<Void>writeFrame(io.vertx.core.http.WebSocketFrame arg0) Write a WebSocket frame to the connectionvoidwriteFrameAndAwait(io.vertx.core.http.WebSocketFrame arg0) Write a WebSocket frame to the connectionwriteFrameAndForget(io.vertx.core.http.WebSocketFrame arg0) Write a WebSocket frame to the connectionio.smallrye.mutiny.Uni<Void>writePing(io.vertx.core.buffer.Buffer arg0) Writes a ping frame to the connection.voidwritePingAndAwait(io.vertx.core.buffer.Buffer arg0) Writes a ping frame to the connection.writePingAndForget(io.vertx.core.buffer.Buffer arg0) Writes a ping frame to the connection.io.smallrye.mutiny.Uni<Void>writePong(io.vertx.core.buffer.Buffer arg0) Writes a pong frame to the connection.voidwritePongAndAwait(io.vertx.core.buffer.Buffer arg0) Writes a pong frame to the connection.writePongAndForget(io.vertx.core.buffer.Buffer arg0) Writes a pong frame to the connection.booleanThis will returntrueif there are more bytes in the write queue than the value set usingsetWriteQueueMaxSize(int)io.smallrye.mutiny.Uni<Void>writeTextMessage(String arg0) Writes a (potentially large) piece of text data to the connection.voidWrites a (potentially large) piece of text data to the connection.Writes a (potentially large) piece of text data to the connection.Methods inherited from class io.vertx.mutiny.core.http.WebSocket
newInstance
-
Field Details
-
__TYPE_ARG
-
-
Constructor Details
-
ClientWebSocket
public ClientWebSocket(io.vertx.core.http.ClientWebSocket delegate) Create a new instance ofClientWebSocketdelegating to the given (non-null) instance ofClientWebSocket. -
ClientWebSocket
-
-
Method Details
-
getDelegate
public io.vertx.core.http.ClientWebSocket getDelegate()Get the delegate instance.This method returns the instance on which this shim is delegating the calls. And so, give you access to the bare API.
- Specified by:
getDelegatein interfaceMutinyDelegate- Specified by:
getDelegatein interfaceReadStream<io.vertx.core.buffer.Buffer>- Specified by:
getDelegatein interfaceStreamBase- Specified by:
getDelegatein interfaceWebSocketBase- Specified by:
getDelegatein interfaceWriteStream<io.vertx.core.buffer.Buffer>- Overrides:
getDelegatein classWebSocket- Returns:
- the delegate instance
-
connect
@CheckReturnValue public io.smallrye.mutiny.Uni<WebSocket> connect(io.vertx.core.http.WebSocketConnectOptions options) Connect this WebSocket with the specified options.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Parameters:
options- the request options- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
ClientWebSocket.connect(WebSocketConnectOptions)
-
connectAndAwait
Connect this WebSocket with the specified options.Unlike the bare Vert.x variant, this method returns a
WebSocket. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Parameters:
options- the request options- Returns:
- The operation result
- See Also:
-
ClientWebSocket.connect(WebSocketConnectOptions)
-
connectAndForget
Connect this WebSocket with the specified options.Unlike the bare Vert.x variant, this method ignores the
WebSocketresult or any failure.- Parameters:
options- the request options- Returns:
- The current instance to chain operations if needed.
- See Also:
-
ClientWebSocket.connect(WebSocketConnectOptions)
-
connect
@CheckReturnValue public io.smallrye.mutiny.Uni<WebSocket> connect(int port, String host, String requestURI) Connect this WebSocket to the specified port, host and relative request URI.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Parameters:
port- the porthost- the hostrequestURI- the relative URI- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
ClientWebSocket.connect(int, String, String)
-
connectAndAwait
Connect this WebSocket to the specified port, host and relative request URI.Unlike the bare Vert.x variant, this method returns a
WebSocket. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Parameters:
port- the porthost- the hostrequestURI- the relative URI- Returns:
- The operation result
- See Also:
-
ClientWebSocket.connect(int, String, String)
-
connectAndForget
Connect this WebSocket to the specified port, host and relative request URI.Unlike the bare Vert.x variant, this method ignores the
WebSocketresult or any failure.- Parameters:
port- the porthost- the hostrequestURI- the relative URI- Returns:
- The current instance to chain operations if needed.
- See Also:
-
ClientWebSocket.connect(int, String, String)
-
connect
Connect this WebSocket to the host and relative request URI and default port.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Parameters:
host- the hostrequestURI- the relative URI- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
ClientWebSocket.connect(String, String)
-
connectAndAwait
Connect this WebSocket to the host and relative request URI and default port.Unlike the bare Vert.x variant, this method returns a
WebSocket. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Parameters:
host- the hostrequestURI- the relative URI- Returns:
- The operation result
- See Also:
-
ClientWebSocket.connect(String, String)
-
connectAndForget
Connect this WebSocket to the host and relative request URI and default port.Unlike the bare Vert.x variant, this method ignores the
WebSocketresult or any failure.- Parameters:
host- the hostrequestURI- the relative URI- Returns:
- The current instance to chain operations if needed.
- See Also:
-
ClientWebSocket.connect(String, String)
-
connect
Connect this WebSocket at the relative request URI using the default host and port.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Parameters:
requestURI- the relative URI- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
ClientWebSocket.connect(String)
-
connectAndAwait
Connect this WebSocket at the relative request URI using the default host and port.Unlike the bare Vert.x variant, this method returns a
WebSocket. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Parameters:
requestURI- the relative URI- Returns:
- The operation result
- See Also:
-
ClientWebSocket.connect(String)
-
connectAndForget
Connect this WebSocket at the relative request URI using the default host and port.Unlike the bare Vert.x variant, this method ignores the
WebSocketresult or any failure.- Parameters:
requestURI- the relative URI- Returns:
- The current instance to chain operations if needed.
- See Also:
-
ClientWebSocket.connect(String)
-
end
Same asend()but writes some data to the stream before ending.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
endin interfaceWebSocketBase- Specified by:
endin interfaceWriteStream<io.vertx.core.buffer.Buffer>- Overrides:
endin classWebSocket- Parameters:
data- the data to write- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WriteStream.end(T)
-
endAndAwait
public void endAndAwait(io.vertx.core.buffer.Buffer arg0) Same asend()but writes some data to the stream before ending.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
endAndAwaitin classWebSocket- Parameters:
data- the data to write- See Also:
-
WriteStream.end(T)
-
endAndForget
Same asend()but writes some data to the stream before ending.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
endAndForgetin classWebSocket- Parameters:
data- the data to write- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WriteStream.end(T)
-
shutdown
@CheckReturnValue public io.smallrye.mutiny.Uni<Void> shutdown(long arg0, TimeUnit arg1, short arg2, String arg3) Callsshutdown(Duration, short, String)Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
shutdownin interfaceWebSocketBase- Overrides:
shutdownin classWebSocket- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.shutdown(long, TimeUnit, short, String)
-
shutdownAndAwait
Callsshutdown(Duration, short, String)Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
shutdownAndAwaitin classWebSocket- See Also:
-
WebSocketBase.shutdown(long, TimeUnit, short, String)
-
shutdownAndForget
Callsshutdown(Duration, short, String)Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
shutdownAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.shutdown(long, TimeUnit, short, String)
-
writeFrame
@CheckReturnValue public io.smallrye.mutiny.Uni<Void> writeFrame(io.vertx.core.http.WebSocketFrame arg0) Write a WebSocket frame to the connectionUnlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
writeFramein interfaceWebSocketBase- Overrides:
writeFramein classWebSocket- Parameters:
frame- the frame to write- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.writeFrame(WebSocketFrame)
-
writeFrameAndAwait
public void writeFrameAndAwait(io.vertx.core.http.WebSocketFrame arg0) Write a WebSocket frame to the connectionUnlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
writeFrameAndAwaitin classWebSocket- Parameters:
frame- the frame to write- See Also:
-
WebSocketBase.writeFrame(WebSocketFrame)
-
writeFrameAndForget
Write a WebSocket frame to the connectionUnlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
writeFrameAndForgetin classWebSocket- Parameters:
frame- the frame to write- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.writeFrame(WebSocketFrame)
-
writeTextMessage
Writes a (potentially large) piece of text data to the connection. This data might be written as multiple frames if it exceeds the maximum WebSocket frame size.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
writeTextMessagein interfaceWebSocketBase- Overrides:
writeTextMessagein classWebSocket- Parameters:
text- the data to write- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.writeTextMessage(String)
-
writeTextMessageAndAwait
Writes a (potentially large) piece of text data to the connection. This data might be written as multiple frames if it exceeds the maximum WebSocket frame size.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
writeTextMessageAndAwaitin classWebSocket- Parameters:
text- the data to write- See Also:
-
WebSocketBase.writeTextMessage(String)
-
writeTextMessageAndForget
Writes a (potentially large) piece of text data to the connection. This data might be written as multiple frames if it exceeds the maximum WebSocket frame size.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
writeTextMessageAndForgetin classWebSocket- Parameters:
text- the data to write- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.writeTextMessage(String)
-
pipeTo
@CheckReturnValue public io.smallrye.mutiny.Uni<Void> pipeTo(WriteStream<io.vertx.core.buffer.Buffer> arg0) Pipe thisReadStreamto theWriteStream.Elements emitted by this stream will be written to the write stream until this stream ends or fails.
Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
pipeToin interfaceReadStream<io.vertx.core.buffer.Buffer>- Specified by:
pipeToin interfaceWebSocketBase- Overrides:
pipeToin classWebSocket- Parameters:
dst- the destination write stream- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
io.vertx.core.http.ClientWebSocket#pipeTo(WriteStream)
-
pipeToAndAwait
Pipe thisReadStreamto theWriteStream.Elements emitted by this stream will be written to the write stream until this stream ends or fails.
Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
pipeToAndAwaitin classWebSocket- Parameters:
dst- the destination write stream- See Also:
-
io.vertx.core.http.ClientWebSocket#pipeTo(WriteStream)
-
pipeToAndForget
Pipe thisReadStreamto theWriteStream.Elements emitted by this stream will be written to the write stream until this stream ends or fails.
Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
pipeToAndForgetin classWebSocket- Parameters:
dst- the destination write stream- Returns:
- The current instance to chain operations if needed.
- See Also:
-
io.vertx.core.http.ClientWebSocket#pipeTo(WriteStream)
-
writeFinalBinaryFrame
@CheckReturnValue public io.smallrye.mutiny.Uni<Void> writeFinalBinaryFrame(io.vertx.core.buffer.Buffer arg0) Write a final WebSocket binary frame to the connectionUnlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
writeFinalBinaryFramein interfaceWebSocketBase- Overrides:
writeFinalBinaryFramein classWebSocket- Parameters:
data- The data to write- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.writeFinalBinaryFrame(Buffer)
-
writeFinalBinaryFrameAndAwait
public void writeFinalBinaryFrameAndAwait(io.vertx.core.buffer.Buffer arg0) Write a final WebSocket binary frame to the connectionUnlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
writeFinalBinaryFrameAndAwaitin classWebSocket- Parameters:
data- The data to write- See Also:
-
WebSocketBase.writeFinalBinaryFrame(Buffer)
-
writeFinalBinaryFrameAndForget
Write a final WebSocket binary frame to the connectionUnlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
writeFinalBinaryFrameAndForgetin classWebSocket- Parameters:
data- The data to write- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.writeFinalBinaryFrame(Buffer)
-
shutdown
@CheckReturnValue public io.smallrye.mutiny.Uni<Void> shutdown(Duration arg0, short arg1, String arg2) Callsshutdown(long, TimeUnit, short, String)with anullreason.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
shutdownin interfaceWebSocketBase- Overrides:
shutdownin classWebSocket- Parameters:
arg0- the amount of time after which all resources are forcibly closedarg1- the status codearg2- reason of closure. Can benull.- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.shutdown(long, TimeUnit, short)
-
shutdownAndAwait
Callsshutdown(long, TimeUnit, short, String)with anullreason.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
shutdownAndAwaitin classWebSocket- See Also:
-
WebSocketBase.shutdown(long, TimeUnit, short)
-
shutdownAndForget
Callsshutdown(long, TimeUnit, short, String)with anullreason.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
shutdownAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.shutdown(long, TimeUnit, short)
-
writePong
Writes a pong frame to the connection. This will be written in a single frame. Pong frames may be at most 125 bytes (octets).This method should not be used to write application data and should only be used for implementing a keep alive or to ensure the client is still responsive, see RFC 6455 section 5.5.2.
There is no need to manually write a pong frame, as the server and client both handle responding to a ping from with a pong from automatically and this is exposed to users. RFC 6455 section 5.5.3 states that pongs may be sent unsolicited in order to implement a one way heartbeat.
Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
writePongin interfaceWebSocketBase- Overrides:
writePongin classWebSocket- Parameters:
data- the data to write, may be at most 125 bytes- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.writePong(Buffer)
-
writePongAndAwait
public void writePongAndAwait(io.vertx.core.buffer.Buffer arg0) Writes a pong frame to the connection. This will be written in a single frame. Pong frames may be at most 125 bytes (octets).This method should not be used to write application data and should only be used for implementing a keep alive or to ensure the client is still responsive, see RFC 6455 section 5.5.2.
There is no need to manually write a pong frame, as the server and client both handle responding to a ping from with a pong from automatically and this is exposed to users. RFC 6455 section 5.5.3 states that pongs may be sent unsolicited in order to implement a one way heartbeat.
Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
writePongAndAwaitin classWebSocket- Parameters:
data- the data to write, may be at most 125 bytes- See Also:
-
WebSocketBase.writePong(Buffer)
-
writePongAndForget
Writes a pong frame to the connection. This will be written in a single frame. Pong frames may be at most 125 bytes (octets).This method should not be used to write application data and should only be used for implementing a keep alive or to ensure the client is still responsive, see RFC 6455 section 5.5.2.
There is no need to manually write a pong frame, as the server and client both handle responding to a ping from with a pong from automatically and this is exposed to users. RFC 6455 section 5.5.3 states that pongs may be sent unsolicited in order to implement a one way heartbeat.
Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
writePongAndForgetin classWebSocket- Parameters:
data- the data to write, may be at most 125 bytes- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.writePong(Buffer)
-
shutdown
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
shutdownin interfaceWebSocketBase- Overrides:
shutdownin classWebSocket- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.shutdown(short)
-
shutdownAndAwait
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
shutdownAndAwaitin classWebSocket- See Also:
-
WebSocketBase.shutdown(short)
-
shutdownAndForget
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
shutdownAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.shutdown(short)
-
close
Close the WebSocket sending the default close frame. No more messages can be sent.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
closein interfaceWebSocketBase- Overrides:
closein classWebSocket- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.close()
-
closeAndAwait
public void closeAndAwait()Close the WebSocket sending the default close frame. No more messages can be sent.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
closeAndAwaitin classWebSocket- See Also:
-
WebSocketBase.close()
-
closeAndForget
Close the WebSocket sending the default close frame. No more messages can be sent.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
closeAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.close()
-
close
Close the WebSocket sending a close frame with specified status code. You can give a look at various close payloads here: RFC6455 section 7.4.1 No more messages can be sent.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
closein interfaceWebSocketBase- Overrides:
closein classWebSocket- Parameters:
statusCode- the status code- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.close(short)
-
closeAndAwait
public void closeAndAwait(short arg0) Close the WebSocket sending a close frame with specified status code. You can give a look at various close payloads here: RFC6455 section 7.4.1 No more messages can be sent.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
closeAndAwaitin classWebSocket- Parameters:
statusCode- the status code- See Also:
-
WebSocketBase.close(short)
-
closeAndForget
Close the WebSocket sending a close frame with specified status code. You can give a look at various close payloads here: RFC6455 section 7.4.1 No more messages can be sent.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
closeAndForgetin classWebSocket- Parameters:
statusCode- the status code- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.close(short)
-
shutdown
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
shutdownin interfaceWebSocketBase- Overrides:
shutdownin classWebSocket- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.shutdown(short, String)
-
shutdownAndAwait
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
shutdownAndAwaitin classWebSocket- See Also:
-
WebSocketBase.shutdown(short, String)
-
shutdownAndForget
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
shutdownAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.shutdown(short, String)
-
shutdown
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout, the status code1000anullreason.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
shutdownin interfaceWebSocketBase- Overrides:
shutdownin classWebSocket- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.shutdown()
-
shutdownAndAwait
public void shutdownAndAwait()Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout, the status code1000anullreason.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
shutdownAndAwaitin classWebSocket- See Also:
-
WebSocketBase.shutdown()
-
shutdownAndForget
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout, the status code1000anullreason.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
shutdownAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.shutdown()
-
shutdown
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
shutdownin interfaceWebSocketBase- Overrides:
shutdownin classWebSocket- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.shutdown(short)
-
shutdownAndAwait
public void shutdownAndAwait(short arg0) Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
shutdownAndAwaitin classWebSocket- See Also:
-
WebSocketBase.shutdown(short)
-
shutdownAndForget
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout and anullreason.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
shutdownAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.shutdown(short)
-
end
Ends the stream.Once the stream has ended, it cannot be used any more.
Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
CallsWebSocketBase.close()Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
CallsWebSocket.close()Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
Callsclose()Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
endin interfaceWebSocketBase- Specified by:
endin interfaceWriteStream<io.vertx.core.buffer.Buffer>- Overrides:
endin classWebSocket- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.end()
-
endAndAwait
public void endAndAwait()CallsWebSocket.close()Unlike the bare Vert.x variant, this method returns a
CallsVoid. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).close()Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
endAndAwaitin classWebSocket- See Also:
-
WebSocketBase.end()
-
endAndForget
CallsWebSocket.close()Unlike the bare Vert.x variant, this method ignores the
CallsVoidresult or any failure.close()Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
endAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.end()
-
shutdown
@CheckReturnValue public io.smallrye.mutiny.Uni<Void> shutdown(long arg0, TimeUnit arg1, short arg2) Callsshutdown(long, TimeUnit, short, String)with anullreason.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
shutdownin interfaceWebSocketBase- Overrides:
shutdownin classWebSocket- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.shutdown(long, TimeUnit, short)
-
shutdownAndAwait
Callsshutdown(long, TimeUnit, short, String)with anullreason.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
shutdownAndAwaitin classWebSocket- See Also:
-
WebSocketBase.shutdown(long, TimeUnit, short)
-
shutdownAndForget
Callsshutdown(long, TimeUnit, short, String)with anullreason.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
shutdownAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.shutdown(long, TimeUnit, short)
-
shutdown
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
shutdownin interfaceWebSocketBase- Overrides:
shutdownin classWebSocket- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.shutdown(short, String)
-
shutdownAndAwait
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
shutdownAndAwaitin classWebSocket- See Also:
-
WebSocketBase.shutdown(short, String)
-
shutdownAndForget
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
shutdownAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.shutdown(short, String)
-
writeFinalTextFrame
Write a final WebSocket text frame to the connectionUnlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
writeFinalTextFramein interfaceWebSocketBase- Overrides:
writeFinalTextFramein classWebSocket- Parameters:
text- The text to write- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.writeFinalTextFrame(String)
-
writeFinalTextFrameAndAwait
Write a final WebSocket text frame to the connectionUnlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
writeFinalTextFrameAndAwaitin classWebSocket- Parameters:
text- The text to write- See Also:
-
WebSocketBase.writeFinalTextFrame(String)
-
writeFinalTextFrameAndForget
Write a final WebSocket text frame to the connectionUnlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
writeFinalTextFrameAndForgetin classWebSocket- Parameters:
text- The text to write- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.writeFinalTextFrame(String)
-
writePing
Writes a ping frame to the connection. This will be written in a single frame. Ping frames may be at most 125 bytes (octets).This method should not be used to write application data and should only be used for implementing a keep alive or to ensure the client is still responsive, see RFC 6455 Section section 5.5.2.
There is no handler for ping frames because RFC 6455 clearly states that the only response to a ping frame is a pong frame with identical contents.
Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
writePingin interfaceWebSocketBase- Overrides:
writePingin classWebSocket- Parameters:
data- the data to write, may be at most 125 bytes- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.writePing(Buffer)
-
writePingAndAwait
public void writePingAndAwait(io.vertx.core.buffer.Buffer arg0) Writes a ping frame to the connection. This will be written in a single frame. Ping frames may be at most 125 bytes (octets).This method should not be used to write application data and should only be used for implementing a keep alive or to ensure the client is still responsive, see RFC 6455 Section section 5.5.2.
There is no handler for ping frames because RFC 6455 clearly states that the only response to a ping frame is a pong frame with identical contents.
Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
writePingAndAwaitin classWebSocket- Parameters:
data- the data to write, may be at most 125 bytes- See Also:
-
WebSocketBase.writePing(Buffer)
-
writePingAndForget
Writes a ping frame to the connection. This will be written in a single frame. Ping frames may be at most 125 bytes (octets).This method should not be used to write application data and should only be used for implementing a keep alive or to ensure the client is still responsive, see RFC 6455 Section section 5.5.2.
There is no handler for ping frames because RFC 6455 clearly states that the only response to a ping frame is a pong frame with identical contents.
Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
writePingAndForgetin classWebSocket- Parameters:
data- the data to write, may be at most 125 bytes- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.writePing(Buffer)
-
close
Close sending a close frame with specified status code and reason. You can give a look at various close payloads here: RFC6455 section 7.4.1 No more messages can be sent.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
closein interfaceWebSocketBase- Overrides:
closein classWebSocket- Parameters:
statusCode- the status codereason- reason of closure- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.close(short, String)
-
closeAndAwait
Close sending a close frame with specified status code and reason. You can give a look at various close payloads here: RFC6455 section 7.4.1 No more messages can be sent.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
closeAndAwaitin classWebSocket- Parameters:
statusCode- the status codereason- reason of closure- See Also:
-
WebSocketBase.close(short, String)
-
closeAndForget
Close sending a close frame with specified status code and reason. You can give a look at various close payloads here: RFC6455 section 7.4.1 No more messages can be sent.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
closeAndForgetin classWebSocket- Parameters:
statusCode- the status codereason- reason of closure- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.close(short, String)
-
write
Write some data to the stream.The data is usually put on an internal write queue, and the write actually happens asynchronously. To avoid running out of memory by putting too much on the write queue, check the
writeQueueFull()method before writing. This is done automatically if using aPipe.When the
datais moved from the queue to the actual medium, the returnedFuturewill be completed with the write result, e.g the uni is succeeded when a server HTTP response buffer is written to the socket and failed if the remote client has closed the socket while the data was still pending for write.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
writein interfaceWebSocketBase- Specified by:
writein interfaceWriteStream<io.vertx.core.buffer.Buffer>- Overrides:
writein classWebSocket- Parameters:
data- the data to write- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WriteStream.write(T)
-
writeAndAwait
public void writeAndAwait(io.vertx.core.buffer.Buffer arg0) Write some data to the stream.The data is usually put on an internal write queue, and the write actually happens asynchronously. To avoid running out of memory by putting too much on the write queue, check the
writeQueueFull()method before writing. This is done automatically if using aPipe.When the
datais moved from the queue to the actual medium, the returnedFuturewill be completed with the write result, e.g the underlying uni is succeeded when a server HTTP response buffer is written to the socket and failed if the remote client has closed the socket while the data was still pending for write.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
writeAndAwaitin classWebSocket- Parameters:
data- the data to write- See Also:
-
WriteStream.write(T)
-
writeAndForget
Write some data to the stream.The data is usually put on an internal write queue, and the write actually happens asynchronously. To avoid running out of memory by putting too much on the write queue, check the
writeQueueFull()method before writing. This is done automatically if using aPipe.When the
datais moved from the queue to the actual medium, the returnedFuturewill be completed with the write result, e.g the underlying uni is succeeded when a server HTTP response buffer is written to the socket and failed if the remote client has closed the socket while the data was still pending for write.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
writeAndForgetin classWebSocket- Parameters:
data- the data to write- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WriteStream.write(T)
-
shutdown
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
shutdownin interfaceWebSocketBase- Overrides:
shutdownin classWebSocket- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.shutdown(short, String)
-
shutdownAndAwait
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
shutdownAndAwaitin classWebSocket- See Also:
-
WebSocketBase.shutdown(short, String)
-
shutdownAndForget
Likeshutdown(long, TimeUnit, short, String)with a 30 seconds timeout.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
shutdownAndForgetin classWebSocket- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.shutdown(short, String)
-
writeBinaryMessage
@CheckReturnValue public io.smallrye.mutiny.Uni<Void> writeBinaryMessage(io.vertx.core.buffer.Buffer arg0) Writes a (potentially large) piece of binary data to the connection. This data might be written as multiple frames if it exceeds the maximum WebSocket frame size.Unlike the bare Vert.x variant, this method returns a
Uni. The uni emits the result of the operation as item. If the operation fails, the uni emits the failure.Don't forget to subscribe on it to trigger the operation.
- Specified by:
writeBinaryMessagein interfaceWebSocketBase- Overrides:
writeBinaryMessagein classWebSocket- Parameters:
data- the data to write- Returns:
- A
Unirepresenting the asynchronous result of this operation. - See Also:
-
WebSocketBase.writeBinaryMessage(Buffer)
-
writeBinaryMessageAndAwait
public void writeBinaryMessageAndAwait(io.vertx.core.buffer.Buffer arg0) Writes a (potentially large) piece of binary data to the connection. This data might be written as multiple frames if it exceeds the maximum WebSocket frame size.Unlike the bare Vert.x variant, this method returns a
Void. This method awaits indefinitely for the completion of the underlying asynchronous operation. If the operation completes successfully, the result is returned, otherwise the failure is thrown (potentially wrapped in aRuntimeException).- Overrides:
writeBinaryMessageAndAwaitin classWebSocket- Parameters:
data- the data to write- See Also:
-
WebSocketBase.writeBinaryMessage(Buffer)
-
writeBinaryMessageAndForget
Writes a (potentially large) piece of binary data to the connection. This data might be written as multiple frames if it exceeds the maximum WebSocket frame size.Unlike the bare Vert.x variant, this method ignores the
Voidresult or any failure.- Overrides:
writeBinaryMessageAndForgetin classWebSocket- Parameters:
data- the data to write- Returns:
- The current instance to chain operations if needed.
- See Also:
-
WebSocketBase.writeBinaryMessage(Buffer)
-
pause
Description copied from interface:ReadStreamPause theReadStream, it sets the buffer infetchmode and clears the actual demand.While it's paused, no data will be sent to the data
handler.- Specified by:
pausein interfaceReadStream<io.vertx.core.buffer.Buffer>- Specified by:
pausein interfaceWebSocketBase- Overrides:
pausein classWebSocket- Returns:
- a reference to this, so the API can be used fluently
-
resume
Description copied from interface:ReadStreamResume reading, and sets the buffer inflowingmode. If theReadStreamhas been paused, reading will recommence on it.- Specified by:
resumein interfaceReadStream<io.vertx.core.buffer.Buffer>- Specified by:
resumein interfaceWebSocketBase- Overrides:
resumein classWebSocket- Returns:
- a reference to this, so the API can be used fluently
-
fetch
Description copied from interface:ReadStreamFetch the specifiedamountof elements. If theReadStreamhas been paused, reading will recommence with the specifiedamountof items, otherwise the specifiedamountwill be added to the current stream demand.- Specified by:
fetchin interfaceReadStream<io.vertx.core.buffer.Buffer>- Specified by:
fetchin interfaceWebSocketBase- Overrides:
fetchin classWebSocket- Returns:
- a reference to this, so the API can be used fluently
-
setWriteQueueMaxSize
Description copied from interface:WriteStreamSet the maximum size of the write queue tomaxSize. You will still be able to write to the stream even if there is more thanmaxSizeitems in the write queue. This is used as an indicator by classes such asPipeto provide flow control. The value is defined by the implementation of the stream, e.g in bytes for aNetSocket, etc...- Specified by:
setWriteQueueMaxSizein interfaceWebSocketBase- Specified by:
setWriteQueueMaxSizein interfaceWriteStream<io.vertx.core.buffer.Buffer>- Overrides:
setWriteQueueMaxSizein classWebSocket- Parameters:
maxSize- the max size of the write stream- Returns:
- a reference to this, so the API can be used fluently
-
handler
Description copied from interface:ReadStreamSet a data handler. As data is read, the handler will be called with the data.- Specified by:
handlerin interfaceReadStream<io.vertx.core.buffer.Buffer>- Specified by:
handlerin interfaceWebSocketBase- Overrides:
handlerin classWebSocket- Returns:
- a reference to this, so the API can be used fluently
-
endHandler
Description copied from interface:ReadStreamSet an end handler. Once the stream has ended, and there is no more data to be read, this handler will be called.- Specified by:
endHandlerin interfaceReadStream<io.vertx.core.buffer.Buffer>- Specified by:
endHandlerin interfaceWebSocketBase- Overrides:
endHandlerin classWebSocket- Returns:
- a reference to this, so the API can be used fluently
-
drainHandler
Description copied from interface:WriteStreamSet a drain handler on the stream. If the write queue is full, then the handler will be called when the write queue is ready to accept buffers again. SeePipefor an example of this being used.The stream implementation defines when the drain handler, for example it could be when the queue size has been reduced to
maxSize / 2.- Specified by:
drainHandlerin interfaceWebSocketBase- Specified by:
drainHandlerin interfaceWriteStream<io.vertx.core.buffer.Buffer>- Overrides:
drainHandlerin classWebSocket- Parameters:
handler- the handler. Can benull.- Returns:
- a reference to this, so the API can be used fluently
-
closeHandler
Description copied from interface:WebSocketBaseSet a close handler. This will be called when the WebSocket is closed. After this callback, no more messages are expected. When the WebSocket received a close frame, theWebSocketBase.closeStatusCode()will return the status code andWebSocketBase.closeReason()will return the reason.- Specified by:
closeHandlerin interfaceWebSocketBase- Overrides:
closeHandlerin classWebSocket- Parameters:
handler- the handler. Can benull.- Returns:
- a reference to this, so the API can be used fluently
-
frameHandler
Description copied from interface:WebSocketBaseSet a frame handler on the connection. This handler will be called when frames are read on the connection.- Specified by:
frameHandlerin interfaceWebSocketBase- Overrides:
frameHandlerin classWebSocket- Parameters:
handler- the handler. Can benull.- Returns:
- a reference to this, so the API can be used fluently
-
textMessageHandler
Description copied from interface:WebSocketBaseSet a text message handler on the connection. This handler will be called similar to the#binaryMessageHandler(Handler), but the buffer will be converted to a String first- Specified by:
textMessageHandlerin interfaceWebSocketBase- Overrides:
textMessageHandlerin classWebSocket- Parameters:
handler- the handler. Can benull.- Returns:
- a reference to this, so the API can be used fluently
-
binaryMessageHandler
Description copied from interface:WebSocketBaseSet a binary message handler on the connection. This handler serves a similar purpose to#handler(Handler)except that if a message comes into the socket in multiple frames, the data from the frames will be aggregated into a single buffer before calling the handler (usingWebSocketFrame.isFinal()to find the boundaries).- Specified by:
binaryMessageHandlerin interfaceWebSocketBase- Overrides:
binaryMessageHandlerin classWebSocket- Parameters:
handler- the handler. Can benull.- Returns:
- a reference to this, so the API can be used fluently
-
pongHandler
Description copied from interface:WebSocketBaseSet a pong frame handler on the connection. This handler will be invoked every time a pong frame is received on the server, and can be used by both clients and servers since the RFC 6455 section 5.5.2 and section 5.5.3 do not specify whether the client or server sends a ping.Pong frames may be at most 125 bytes (octets).
There is no ping handler since ping frames should immediately be responded to with a pong frame with identical content
Pong frames may be received unsolicited.
- Specified by:
pongHandlerin interfaceWebSocketBase- Overrides:
pongHandlerin classWebSocket- Parameters:
handler- the handler. Can benull.- Returns:
- a reference to this, so the API can be used fluently
-
exceptionHandler
Description copied from interface:ReadStreamSet an exception handler on the read stream.- Specified by:
exceptionHandlerin interfaceReadStream<io.vertx.core.buffer.Buffer>- Specified by:
exceptionHandlerin interfaceStreamBase- Specified by:
exceptionHandlerin interfaceWebSocketBase- Specified by:
exceptionHandlerin interfaceWriteStream<io.vertx.core.buffer.Buffer>- Overrides:
exceptionHandlerin classWebSocket- Parameters:
handler- the exception handler. Can benull.- Returns:
- a reference to this, so the API can be used fluently
-
headers
public io.vertx.core.MultiMap headers()Returns the HTTP headers.- Specified by:
headersin interfaceWebSocketBase- Overrides:
headersin classWebSocket- Returns:
- the headers
-
binaryHandlerID
When aWebSocketis created, it may register an event handler with the event bus - the ID of that handler is given by this method.By default, no handler is registered, the feature must be enabled via
WebSocketConnectOptions.setRegisterWriteHandlers(boolean)orHttpServerOptions#setRegisterWebSocketWriteHandlers(boolean).Given this ID, a different event loop can send a binary frame to that event handler using the event bus and that buffer will be received by this instance in its own event loop and written to the underlying connection. This allows you to write data to other WebSockets which are owned by different event loops.
- Specified by:
binaryHandlerIDin interfaceWebSocketBase- Overrides:
binaryHandlerIDin classWebSocket- Returns:
- the binary handler id
- See Also:
-
WebSocketConnectOptions.setRegisterWriteHandlers(boolean)HttpServerOptions#setRegisterWebSocketWriteHandlers(boolean)
-
subProtocol
Returns the WebSocket sub protocol selected by the WebSocket handshake. On the server, the value will benullwhen the handler receives the WebSocket callback as the handshake will not be completed yet.- Specified by:
subProtocolin interfaceWebSocketBase- Overrides:
subProtocolin classWebSocket
-
pipe
Pause this stream and return aPipeto transfer the elements of this stream to a destinationWriteStream. The stream will be resumed when the pipe will be wired to aWriteStream.- Specified by:
pipein interfaceReadStream<io.vertx.core.buffer.Buffer>- Specified by:
pipein interfaceWebSocketBase- Overrides:
pipein classWebSocket- Returns:
- a pipe
-
writeQueueFull
public boolean writeQueueFull()This will returntrueif there are more bytes in the write queue than the value set usingsetWriteQueueMaxSize(int)- Specified by:
writeQueueFullin interfaceWebSocketBase- Specified by:
writeQueueFullin interfaceWriteStream<io.vertx.core.buffer.Buffer>- Overrides:
writeQueueFullin classWebSocket- Returns:
trueif write queue is full
-
closeStatusCode
Returns the close status code received from the remote endpoint ornullwhen not yet received.- Specified by:
closeStatusCodein interfaceWebSocketBase- Overrides:
closeStatusCodein classWebSocket
-
isClosed
public boolean isClosed()- Specified by:
isClosedin interfaceWebSocketBase- Overrides:
isClosedin classWebSocket- Returns:
trueif the WebSocket cannot be used to send message anymore
-
localAddress
public io.vertx.core.net.SocketAddress localAddress()- Specified by:
localAddressin interfaceWebSocketBase- Overrides:
localAddressin classWebSocket- Returns:
- the local address for this connection, possibly
null(e.g a server bound on a domain socket) IfuseProxyProtocolis set totrue, the address returned will be of the proxy.
-
isSsl
public boolean isSsl()- Specified by:
isSslin interfaceWebSocketBase- Overrides:
isSslin classWebSocket- Returns:
- true if this
HttpConnectionis encrypted via SSL/TLS.
-
sslSession
- Specified by:
sslSessionin interfaceWebSocketBase- Overrides:
sslSessionin classWebSocket- Returns:
- SSLSession associated with the underlying socket. Returns null if connection is not SSL.
- See Also:
-
remoteAddress
public io.vertx.core.net.SocketAddress remoteAddress()- Specified by:
remoteAddressin interfaceWebSocketBase- Overrides:
remoteAddressin classWebSocket- Returns:
- the remote address for this connection, possibly
null(e.g a server bound on a domain socket). IfuseProxyProtocolis set totrue, the address returned will be of the actual connecting client.
-
closeReason
Returns the close reason message from the remote endpoint ornullwhen not yet received.- Specified by:
closeReasonin interfaceWebSocketBase- Overrides:
closeReasonin classWebSocket
-
shutdownHandler
Set ahandlernotified when the WebSocket is shutdown: the client or server will close the connection within a certain amount of time. This gives the opportunity to thehandlerto close the WebSocket gracefully before the WebSocket is forcefully closed.- Specified by:
shutdownHandlerin interfaceWebSocketBase- Overrides:
shutdownHandlerin classWebSocket- Parameters:
handler- the handler notified with the remaining shutdown- Returns:
- a reference to this, so the API can be used fluently
-
textHandlerID
When aWebSocketis created, it may register an event handler with the eventbus, the ID of that handler is given bytextHandlerID.By default, no handler is registered, the feature must be enabled via
WebSocketConnectOptions.setRegisterWriteHandlers(boolean)orHttpServerOptions#setRegisterWebSocketWriteHandlers(boolean).Given this ID, a different event loop can send a text frame to that event handler using the event bus and that buffer will be received by this instance in its own event loop and written to the underlying connection. This allows you to write data to other WebSockets which are owned by different event loops.
- Specified by:
textHandlerIDin interfaceWebSocketBase- Overrides:
textHandlerIDin classWebSocket- Returns:
- the text handler id
- See Also:
-
WebSocketConnectOptions.setRegisterWriteHandlers(boolean)HttpServerOptions#setRegisterWebSocketWriteHandlers(boolean)
-
newInstance
Creates a new instance of theClientWebSocket. -
hashCode
public int hashCode() -
equals
-
toString
-
toMulti
@CheckReturnValue public io.smallrye.mutiny.Multi<io.vertx.core.buffer.Buffer> toMulti()- Specified by:
toMultiin interfaceWebSocketBase- Overrides:
toMultiin classWebSocket
-
toBlockingIterable
- Overrides:
toBlockingIterablein classWebSocket
-
toBlockingStream
- Overrides:
toBlockingStreamin classWebSocket
-
toSubscriber
Converts the current write stream to a subscriber.- Overrides:
toSubscriberin classWebSocket
-