org.eclipse.jetty.websocket.common

Class WebSocketRemoteEndpoint

java.lang.Object

org.eclipse.jetty.websocket.common.WebSocketRemoteEndpoint

All Implemented Interfaces:

RemoteEndpoint

public class WebSocketRemoteEndpoint
extends Object
implements RemoteEndpoint

Endpoint for Writing messages to the Remote websocket.

Field Summary

Fields

Modifier and Type	Field and Description
LogicalConnection	connection
OutgoingFrames	outgoing

Constructor Summary

Constructors

Constructor and Description
WebSocketRemoteEndpoint(LogicalConnection connection, OutgoingFrames outgoing)

Method Summary

Methods

Modifier and Type	Method and Description
InetSocketAddress	getInetSocketAddress()
void	sendBytes(ByteBuffer data) Blocking write of bytes.
Future<Void>	sendBytesByFuture(ByteBuffer data) Initiates the asynchronous transmission of a binary message.
void	sendPartialBytes(ByteBuffer fragment, boolean isLast) Send a binary message in pieces, blocking until all of the message has been transmitted.
void	sendPartialString(String fragment, boolean isLast) Send a text message in pieces, blocking until all of the message has been transmitted.
void	sendPing(ByteBuffer applicationData) Send a Ping message containing the given application data to the remote endpoint.
void	sendPong(ByteBuffer applicationData) Allows the developer to send an unsolicited Pong message containing the given application data in order to serve as a unidirectional heartbeat for the session.
void	sendString(String text) Send a text message, blocking until all bytes of the message has been transmitted.
Future<Void>	sendStringByFuture(String text) Initiates the asynchronous transmission of a text message.

Methods inherited from class java.lang.Object

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

Field Detail

connection

public final LogicalConnection connection

outgoing

public final OutgoingFrames outgoing

Constructor Detail

WebSocketRemoteEndpoint

public WebSocketRemoteEndpoint(LogicalConnection connection,
                       OutgoingFrames outgoing)

Method Detail

getInetSocketAddress

public InetSocketAddress getInetSocketAddress()

sendBytes

public void sendBytes(ByteBuffer data)
               throws IOException

Blocking write of bytes.

Specified by:

sendBytes in interface RemoteEndpoint

Parameters:

data - the message to be sent

Throws:

IOException

sendBytesByFuture

public Future<Void> sendBytesByFuture(ByteBuffer data)

Description copied from interface: RemoteEndpoint

Initiates the asynchronous transmission of a binary message. This method returns before the message is transmitted. Developers may provide a callback to be notified when the message has been transmitted, or may use the returned Future object to track progress of the transmission. Errors in transmission are given to the developer in the WriteResult object in either case.

Specified by:

sendBytesByFuture in interface RemoteEndpoint

Parameters:

data - the data being sent

Returns:

the Future object representing the send operation.

sendPartialBytes

public void sendPartialBytes(ByteBuffer fragment,
                    boolean isLast)
                      throws IOException

Description copied from interface: RemoteEndpoint

Send a binary message in pieces, blocking until all of the message has been transmitted. The runtime reads the message in order. Non-final pieces are sent with isLast set to false. The final piece must be sent with isLast set to true.

Specified by:

sendPartialBytes in interface RemoteEndpoint

Parameters:

fragment - the piece of the message being sent

Throws:

IOException

sendPartialString

public void sendPartialString(String fragment,
                     boolean isLast)
                       throws IOException

Description copied from interface: RemoteEndpoint

Send a text message in pieces, blocking until all of the message has been transmitted. The runtime reads the message in order. Non-final pieces are sent with isLast set to false. The final piece must be sent with isLast set to true.

Specified by:

sendPartialString in interface RemoteEndpoint

Parameters:

fragment - the piece of the message being sent

Throws:

IOException

sendPing

public void sendPing(ByteBuffer applicationData)
              throws IOException

Description copied from interface: RemoteEndpoint

Send a Ping message containing the given application data to the remote endpoint. The corresponding Pong message may be picked up using the MessageHandler.Pong handler.

Specified by:

sendPing in interface RemoteEndpoint

Parameters:

applicationData - the data to be carried in the ping request

Throws:

IOException

sendPong

public void sendPong(ByteBuffer applicationData)
              throws IOException

Description copied from interface: RemoteEndpoint

Allows the developer to send an unsolicited Pong message containing the given application data in order to serve as a unidirectional heartbeat for the session.

Specified by:

sendPong in interface RemoteEndpoint

Parameters:

applicationData - the application data to be carried in the pong response.

Throws:

IOException

sendString

public void sendString(String text)
                throws IOException

Description copied from interface: RemoteEndpoint

Send a text message, blocking until all bytes of the message has been transmitted.

Note: this is a blocking call

Specified by:

sendString in interface RemoteEndpoint

Parameters:

text - the message to be sent

Throws:

IOException

sendStringByFuture

public Future<Void> sendStringByFuture(String text)

Description copied from interface: RemoteEndpoint

Initiates the asynchronous transmission of a text message. This method returns before the message is transmitted. Developers may provide a callback to be notified when the message has been transmitted, or may use the returned Future object to track progress of the transmission. Errors in transmission are given to the developer in the WriteResult object in either case.

Specified by:

sendStringByFuture in interface RemoteEndpoint

Parameters:

text - the text being sent

Returns:

the Future object representing the send operation.