Method Detail

• getSendTimeout

  long getSendTimeout()

  Return the number of milliseconds the implementation will timeout attempting to send a websocket message. A zero or negative value indicates the implementation will not timeout attempting to send a websocket message asynchronously. This value overrides the default value assigned in the WebSocketContainer.

  Returns:

  the timeout time in milliseconds.

• setSendTimeout

  void setSendTimeout(long timeoutmillis)

  Sets the number of milliseconds the implementation will timeout attempting to send a websocket message. A zero or negative value indicates the implementation will not timeout attempting to send a websocket message asynchronously. This value overrides the default value assigned in the WebSocketContainer.

  Parameters:

  timeoutmillis - The number of milliseconds this RemoteEndpoint will wait before timing out an incomplete asynchronous message send.

• sendText

  void sendText(java.lang.String text,
                SendHandler handler)

  Initiates the asynchronous transmission of a text message. This method returns before the message is transmitted. Developers provide a callback to be notified when the message has been transmitted. Errors in transmission are given to the developer in the SendResult object.

  Parameters:

  text - the text being sent.

  handler - the handler which will be notified of progress.

  Throws:

  java.lang.IllegalArgumentException - if the text or the handler is null.

• sendText

  java.util.concurrent.Future<java.lang.Void> sendText(java.lang.String text)

  Initiates the asynchronous transmission of a text message. This method returns before the message is transmitted. Developers use the returned Future object to track progress of the transmission. The Future's get() method returns null upon successful completion. Errors in transmission are wrapped in the ExecutionException thrown when querying the Future object.

  Parameters:

  text - the text being sent.

  Returns:

  the Future object representing the send operation.

  Throws:

  java.lang.IllegalArgumentException - if the text is null.

• sendBinary

  java.util.concurrent.Future<java.lang.Void> sendBinary(java.nio.ByteBuffer data)

  Initiates the asynchronous transmission of a binary message. This method returns before the message is transmitted. Developers use the returned Future object to track progress of the transmission. The Future's get() method returns null upon successful completion. Errors in transmission are wrapped in the ExecutionException thrown when querying the Future object.

  It is not safe for other threads to use the ByteBuffer until the sending of this message is complete. If the sending of the message completes successfully, the buffer's limit will be unchanged and the buffer's position will be equal to the limit. If the sending of the message does not complete successfully, the state of the buffer is undefined.

  Parameters:

  data - the data being sent.

  Returns:

  the Future object representing the send operation.

  Throws:

  java.lang.IllegalArgumentException - if the data is null.

• sendBinary

  void sendBinary(java.nio.ByteBuffer data,
                  SendHandler handler)

  Initiates the asynchronous transmission of a binary message. This method returns before the message is transmitted. Developers provide a callback to be notified when the message has been transmitted. Errors in transmission are given to the developer in the SendResult object.

  It is not safe for other threads to use the ByteBuffer until the sending of this message is complete. If the sending of the message completes successfully, the buffer's limit will be unchanged and the buffer's position will be equal to the limit. If the sending of the message does not complete successfully, the state of the buffer is undefined.

  Parameters:

  data - the data being sent, must not be null.

  handler - the handler that will be notified of progress, must not be null.

  Throws:

  java.lang.IllegalArgumentException - if either the data or the handler are null.

• sendObject

  java.util.concurrent.Future<java.lang.Void> sendObject(java.lang.Object data)

  Initiates the asynchronous transmission of a custom developer object. The developer will have provided an encoder for this object type in the endpoint configuration. Containers will by default be able to encode java primitive types and their object equivalents, otherwise the developer must have provided an encoder for the object type in the endpoint configuration. A developer-provided encoder for a Java primitive type and its object equivalent overrides the container default encoder. Progress may be tracked using the Future object. The Future's get() methods return null upon successful completion. Errors in transmission are wrapped in the ExecutionException thrown when querying the Future object.

  Parameters:

  data - the object being sent.

  Returns:

  the Future object representing the send operation.

  Throws:

  java.lang.IllegalArgumentException - if the data is null.

• sendObject

  void sendObject(java.lang.Object data,
                  SendHandler handler)

  Initiates the asynchronous transmission of a custom developer object. Containers will by default be able to encode java primitive types and their object equivalents, otherwise the developer must have provided an encoder for the object type in the endpoint configuration. A developer-provided encoder for a Java primitive type and its object equivalent overrides the container default encoder. Developers are notified when transmission is complete through the supplied callback object.

  Parameters:

  data - the object being sent.

  handler - the handler that will be notified of progress, must not be null.

  Throws:

  java.lang.IllegalArgumentException - if either the data or the handler are null.