krossbow-websocket-core/org.hildan.krossbow.websocket/WebSocketConnection

WebSocketConnection

interface WebSocketConnection

Represents a web socket connection to another endpoint.

Implementations must be safe to call concurrently.

Functions

abstract suspend fun close(code: Int = WebSocketCloseCodes.NORMAL_CLOSURE, reason: String? = null)

Sends a web socket close frame with the given code and reason, and closes the connection.

sendBinary

abstract suspend fun sendBinary(frameData: ByteArray)

Sends a web socket binary frame.

sendText

abstract suspend fun sendText(frameText: String)

Sends a web socket text frame.

Properties

canSend

abstract val canSend: Boolean

If false, sending frames should not be attempted and will likely throw an exception. If true, sending frames will likely succeed. However, no guarantees can be made because there could be a race condition between WS closure and a "send" call.

host

open val host: String

The host to which this web socket is connected.

incomingFrames

abstract val incomingFrames: Flow<WebSocketFrame>

The single-consumer hot flow of incoming web socket frames.

url

abstract val url: String

The URL that was used to connect this web socket.

Inheritors

WebSocketConnectionWithPing

Sources

common source