org.springframework.web.reactive.socket

Class WebSocketMessage

java.lang.Object

org.springframework.web.reactive.socket.WebSocketMessage

public class WebSocketMessage
extends java.lang.Object

Representation of a WebSocket message.

See static factory methods in WebSocketSession for creating messages with the DataBufferFactory for the session.

Since:

5.0

Author:

Rossen Stoyanchev

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WebSocketMessage.Type WebSocket message types.

Field Summary

Fields

Modifier and Type	Field and Description
private DataBuffer	payload
private WebSocketMessage.Type	type

Constructor Summary

Constructors

Constructor and Description
WebSocketMessage(WebSocketMessage.Type type, DataBuffer payload) Constructor for a WebSocketMessage.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object other)
DataBuffer	getPayload() Return the message payload.
java.lang.String	getPayloadAsText() A variant of getPayloadAsText(Charset) that uses UTF-8 for decoding the raw content to text.
java.lang.String	getPayloadAsText(java.nio.charset.Charset charset) A shortcut for decoding the raw content of the message to text with the given character encoding.
WebSocketMessage.Type	getType() Return the message type (text, binary, etc).
int	hashCode()
void	release() Release the payload DataBuffer which is useful on runtimes (e.g.
WebSocketMessage	retain() Retain the data buffer for the message payload, which is useful on runtimes (e.g.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

type

private final WebSocketMessage.Type type

payload

private final DataBuffer payload

Constructor Detail

WebSocketMessage

public WebSocketMessage(WebSocketMessage.Type type,
                        DataBuffer payload)

Constructor for a WebSocketMessage.

See static factory methods in WebSocketSession or alternatively use WebSocketSession.bufferFactory() to create the payload and then invoke this constructor.

Method Detail

getType

public WebSocketMessage.Type getType()

Return the message type (text, binary, etc).

getPayload

public DataBuffer getPayload()

Return the message payload.

getPayloadAsText

public java.lang.String getPayloadAsText()

A variant of getPayloadAsText(Charset) that uses UTF-8 for decoding the raw content to text.

getPayloadAsText

public java.lang.String getPayloadAsText(java.nio.charset.Charset charset)

A shortcut for decoding the raw content of the message to text with the given character encoding. This is useful for text WebSocket messages, or otherwise when the payload is expected to contain text.

Parameters:

charset - the character encoding

Since:

5.0.5

retain

public WebSocketMessage retain()

Retain the data buffer for the message payload, which is useful on runtimes (e.g. Netty) with pooled buffers. A shortcut for:

 DataBuffer payload = message.getPayload();
 DataBufferUtils.retain(payload);
 

See Also:

DataBufferUtils.retain(DataBuffer)

release

public void release()

Release the payload DataBuffer which is useful on runtimes (e.g. Netty) with pooled buffers such as Netty. A shortcut for:

 DataBuffer payload = message.getPayload();
 DataBufferUtils.release(payload);
 

See Also:

DataBufferUtils.release(DataBuffer)

equals

public boolean equals(java.lang.Object other)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object