com.pusher.java_websocket.client

Class WebSocketClient

java.lang.Object

com.pusher.java_websocket.WebSocketAdapter

com.pusher.java_websocket.client.WebSocketClient

All Implemented Interfaces:

WebSocket, WebSocketListener, java.lang.Runnable

public abstract class WebSocketClient
extends WebSocketAdapter
implements java.lang.Runnable, WebSocket

A subclass must implement at least onOpen, onClose, and onMessage to be useful. At runtime the user is expected to establish a connection via connect(), then receive events like onMessage(String) via the overloaded methods and to send(String) data to the server.

Nested Class Summary

Nested classes/interfaces inherited from interface com.pusher.java_websocket.WebSocket

WebSocket.READYSTATE, WebSocket.Role

Field Summary

Fields

Modifier and Type	Field and Description
protected java.net.URI	uri The URI this channel is supposed to connect to.

Fields inherited from interface com.pusher.java_websocket.WebSocket

DEFAULT_PORT, DEFAULT_WSS_PORT

Constructor Summary

Constructors

Constructor and Description
WebSocketClient(java.net.URI serverURI) This open a websocket connection as specified by rfc6455
WebSocketClient(java.net.URI serverUri, Draft draft) Constructs a WebSocketClient instance and sets it to the connect to the specified URI.
WebSocketClient(java.net.URI serverUri, Draft protocolDraft, java.util.Map<java.lang.String,java.lang.String> httpHeaders, int connectTimeout)

Method Summary

Modifier and Type	Method and Description
void	close() Initiates the websocket close handshake.
void	close(int code)
void	close(int code, java.lang.String message) sends the closing handshake.
void	closeBlocking()
void	closeConnection(int code, java.lang.String message) This will close the connection immediately without a proper close handshake.
void	connect() Initiates the websocket connection.
boolean	connectBlocking() Same as connect but blocks until the websocket connected or failed to do so. Returns whether it succeeded or not.
WebSocket	getConnection()
Draft	getDraft() Returns the protocol version this channel uses. For more infos see https://github.com/TooTallNate/Java-WebSocket/wiki/Drafts
java.net.InetSocketAddress	getLocalSocketAddress()
java.net.InetSocketAddress	getLocalSocketAddress(WebSocket conn)
WebSocket.READYSTATE	getReadyState() This represents the state of the connection.
java.net.InetSocketAddress	getRemoteSocketAddress()
java.net.InetSocketAddress	getRemoteSocketAddress(WebSocket conn)
java.lang.String	getResourceDescriptor() Returns the HTTP Request-URI as defined by http://tools.ietf.org/html/rfc2616#section-5.1.2 If the opening handshake has not yet happened it will return null.
java.net.URI	getURI() Returns the URI that this WebSocketClient is connected to.
boolean	hasBufferedData()
boolean	isClosed() Returns whether the close handshake has been completed and the socket is closed.
boolean	isClosing()
boolean	isConnecting()
boolean	isFlushAndClose() Returns true when no further frames may be submitted This happens before the socket connection is closed.
boolean	isOpen()
abstract void	onClose(int code, java.lang.String reason, boolean remote)
void	onCloseInitiated(int code, java.lang.String reason)
void	onClosing(int code, java.lang.String reason, boolean remote)
abstract void	onError(java.lang.Exception ex)
void	onFragment(Framedata frame)
void	onMessage(java.nio.ByteBuffer bytes)
abstract void	onMessage(java.lang.String message)
abstract void	onOpen(ServerHandshake handshakedata)
void	onWebsocketClose(WebSocket conn, int code, java.lang.String reason, boolean remote) Calls subclass' implementation of onClose.
void	onWebsocketCloseInitiated(WebSocket conn, int code, java.lang.String reason) send when this peer sends a close handshake
void	onWebsocketClosing(WebSocket conn, int code, java.lang.String reason, boolean remote) called as soon as no further frames are accepted
void	onWebsocketError(WebSocket conn, java.lang.Exception ex) Calls subclass' implementation of onIOError.
void	onWebsocketMessage(WebSocket conn, java.nio.ByteBuffer blob) Called when an entire binary frame has been received.
void	onWebsocketMessage(WebSocket conn, java.lang.String message) Calls subclass' implementation of onMessage.
void	onWebsocketMessageFragment(WebSocket conn, Framedata frame) This default implementation does not do anything.
void	onWebsocketOpen(WebSocket conn, Handshakedata handshake) Calls subclass' implementation of onOpen.
void	onWriteDemand(WebSocket conn) This method is used to inform the selector thread that there is data queued to be written to the socket.
void	run()
void	send(byte[] data) Sends binary data to the connected webSocket server.
void	send(java.nio.ByteBuffer bytes) Send Binary data (plain bytes) to the other end.
void	send(java.lang.String text) Sends text to the connected websocket server.
void	sendFragmentedFrame(Framedata.Opcode op, java.nio.ByteBuffer buffer, boolean fin) Allows to send continuous/fragmented frames conveniently.
void	sendFrame(Framedata framedata)
void	setProxy(java.net.Proxy proxy)
void	setSocket(java.net.Socket socket) Accepts bound and unbound sockets. This method must be called before connect.

Methods inherited from class com.pusher.java_websocket.WebSocketAdapter

getFlashPolicy, onWebsocketHandshakeReceivedAsClient, onWebsocketHandshakeReceivedAsServer, onWebsocketHandshakeSentAsClient, onWebsocketPing, onWebsocketPong

Methods inherited from class java.lang.Object

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

Field Detail

uri

protected java.net.URI uri

The URI this channel is supposed to connect to.

Constructor Detail

WebSocketClient

public WebSocketClient(java.net.URI serverURI)

This open a websocket connection as specified by rfc6455

WebSocketClient

public WebSocketClient(java.net.URI serverUri,
                       Draft draft)

Constructs a WebSocketClient instance and sets it to the connect to the specified URI. The channel does not attampt to connect automatically. The connection will be established once you call connect.

WebSocketClient

public WebSocketClient(java.net.URI serverUri,
                       Draft protocolDraft,
                       java.util.Map<java.lang.String,java.lang.String> httpHeaders,
                       int connectTimeout)

Method Detail

getURI

public java.net.URI getURI()

Returns the URI that this WebSocketClient is connected to.

getDraft

public Draft getDraft()

Returns the protocol version this channel uses.
For more infos see https://github.com/TooTallNate/Java-WebSocket/wiki/Drafts

Specified by:

getDraft in interface WebSocket

connect

public void connect()

Initiates the websocket connection. This method does not block.

connectBlocking

public boolean connectBlocking()
                        throws java.lang.InterruptedException

Same as connect but blocks until the websocket connected or failed to do so.
Returns whether it succeeded or not.

Throws:

java.lang.InterruptedException

close

public void close()

Initiates the websocket close handshake. This method does not block
In oder to make sure the connection is closed use closeBlocking

Specified by:

close in interface WebSocket

closeBlocking

public void closeBlocking()
                   throws java.lang.InterruptedException

Throws:

java.lang.InterruptedException

send

public void send(java.lang.String text)
          throws java.nio.channels.NotYetConnectedException

Sends text to the connected websocket server.

Specified by:

send in interface WebSocket

Parameters:

text - The string which will be transmitted.

Throws:

java.nio.channels.NotYetConnectedException

send

public void send(byte[] data)
          throws java.nio.channels.NotYetConnectedException

Sends binary data to the connected webSocket server.

Specified by:

send in interface WebSocket

Parameters:

data - The byte-Array of data to send to the WebSocket server.

Throws:

java.nio.channels.NotYetConnectedException

run

public void run()

Specified by:

run in interface java.lang.Runnable

getReadyState

public WebSocket.READYSTATE getReadyState()

This represents the state of the connection.

Specified by:

getReadyState in interface WebSocket

Returns:

Returns '0 = CONNECTING', '1 = OPEN', '2 = CLOSING' or '3 = CLOSED'

onWebsocketMessage

public final void onWebsocketMessage(WebSocket conn,
                                     java.lang.String message)

Calls subclass' implementation of onMessage.

Specified by:

onWebsocketMessage in interface WebSocketListener

Parameters:

conn - The WebSocket instance this event is occurring on.

message - The UTF-8 decoded message that was received.

onWebsocketMessage

public final void onWebsocketMessage(WebSocket conn,
                                     java.nio.ByteBuffer blob)

Description copied from interface: WebSocketListener

Called when an entire binary frame has been received. Do whatever you want here...

Specified by:

onWebsocketMessage in interface WebSocketListener

Parameters:

conn - The WebSocket instance this event is occurring on.

blob - The binary message that was received.

onWebsocketMessageFragment

public void onWebsocketMessageFragment(WebSocket conn,
                                       Framedata frame)

Description copied from class: WebSocketAdapter

This default implementation does not do anything. Go ahead and overwrite it

Specified by:

onWebsocketMessageFragment in interface WebSocketListener

Overrides:

onWebsocketMessageFragment in class WebSocketAdapter

See Also:

WebSocketListener.onWebsocketMessageFragment(WebSocket, Framedata)

onWebsocketOpen

public final void onWebsocketOpen(WebSocket conn,
                                  Handshakedata handshake)

Calls subclass' implementation of onOpen.

Specified by:

onWebsocketOpen in interface WebSocketListener

Parameters:

conn - The WebSocket instance this event is occuring on.

onWebsocketClose

public final void onWebsocketClose(WebSocket conn,
                                   int code,
                                   java.lang.String reason,
                                   boolean remote)

Calls subclass' implementation of onClose.

Specified by:

onWebsocketClose in interface WebSocketListener

Parameters:

conn - The WebSocket instance this event is occuring on.

onWebsocketError

public final void onWebsocketError(WebSocket conn,
                                   java.lang.Exception ex)

Calls subclass' implementation of onIOError.

Specified by:

onWebsocketError in interface WebSocketListener

ex - The exception that occurred.
Might be null if the exception is not related to any specific connection. For example if the server port could not be bound.

onWriteDemand

public final void onWriteDemand(WebSocket conn)

Description copied from interface: WebSocketListener

This method is used to inform the selector thread that there is data queued to be written to the socket.

Specified by:

onWriteDemand in interface WebSocketListener

onWebsocketCloseInitiated

public void onWebsocketCloseInitiated(WebSocket conn,
                                      int code,
                                      java.lang.String reason)

Description copied from interface: WebSocketListener

send when this peer sends a close handshake

Specified by:

onWebsocketCloseInitiated in interface WebSocketListener

onWebsocketClosing

public void onWebsocketClosing(WebSocket conn,
                               int code,
                               java.lang.String reason,
                               boolean remote)

Description copied from interface: WebSocketListener

called as soon as no further frames are accepted

Specified by:

onWebsocketClosing in interface WebSocketListener

onCloseInitiated

public void onCloseInitiated(int code,
                             java.lang.String reason)

onClosing

public void onClosing(int code,
                      java.lang.String reason,
                      boolean remote)

getConnection

public WebSocket getConnection()

getLocalSocketAddress

public java.net.InetSocketAddress getLocalSocketAddress(WebSocket conn)

Specified by:

getLocalSocketAddress in interface WebSocketListener

getRemoteSocketAddress

public java.net.InetSocketAddress getRemoteSocketAddress(WebSocket conn)

Specified by:

getRemoteSocketAddress in interface WebSocketListener

onOpen

public abstract void onOpen(ServerHandshake handshakedata)

onMessage

public abstract void onMessage(java.lang.String message)

onClose

public abstract void onClose(int code,
                             java.lang.String reason,
                             boolean remote)

onError

public abstract void onError(java.lang.Exception ex)

onMessage

public void onMessage(java.nio.ByteBuffer bytes)

onFragment

public void onFragment(Framedata frame)

setProxy

public void setProxy(java.net.Proxy proxy)

setSocket

public void setSocket(java.net.Socket socket)

Accepts bound and unbound sockets.
This method must be called before connect. If the given socket is not yet bound it will be bound to the uri specified in the constructor.

sendFragmentedFrame

public void sendFragmentedFrame(Framedata.Opcode op,
                                java.nio.ByteBuffer buffer,
                                boolean fin)

Description copied from interface: WebSocket

Allows to send continuous/fragmented frames conveniently.
For more into on this frame type see http://tools.ietf.org/html/rfc6455#section-5.4
If the first frame you send is also the last then it is not a fragmented frame and will received via onMessage instead of onFragmented even though it was send by this method.

Specified by:

sendFragmentedFrame in interface WebSocket

Parameters:

op - This is only important for the first frame in the sequence. Opcode.TEXT, Opcode.BINARY are allowed.

buffer - The buffer which contains the payload. It may have no bytes remaining.

fin - true means the current frame is the last in the sequence.

isOpen

public boolean isOpen()

Specified by:

isOpen in interface WebSocket

isFlushAndClose

public boolean isFlushAndClose()

Description copied from interface: WebSocket

Returns true when no further frames may be submitted
This happens before the socket connection is closed.

Specified by:

isFlushAndClose in interface WebSocket

isClosed

public boolean isClosed()

Description copied from interface: WebSocket

Returns whether the close handshake has been completed and the socket is closed.

Specified by:

isClosed in interface WebSocket

isClosing

public boolean isClosing()

Specified by:

isClosing in interface WebSocket

isConnecting

public boolean isConnecting()

Specified by:

isConnecting in interface WebSocket

hasBufferedData

public boolean hasBufferedData()

Specified by:

hasBufferedData in interface WebSocket

close

public void close(int code)

Specified by:

close in interface WebSocket

close

public void close(int code,
                  java.lang.String message)

Description copied from interface: WebSocket

sends the closing handshake. may be send in response to an other handshake.

Specified by:

close in interface WebSocket

closeConnection

public void closeConnection(int code,
                            java.lang.String message)

Description copied from interface: WebSocket

This will close the connection immediately without a proper close handshake. The code and the message therefore won't be transfered over the wire also they will be forwarded to onClose/onWebsocketClose.

Specified by:

closeConnection in interface WebSocket

send

public void send(java.nio.ByteBuffer bytes)
          throws java.lang.IllegalArgumentException,
                 java.nio.channels.NotYetConnectedException

Description copied from interface: WebSocket

Send Binary data (plain bytes) to the other end.

Specified by:

send in interface WebSocket

Throws:

java.lang.IllegalArgumentException

java.nio.channels.NotYetConnectedException

sendFrame

public void sendFrame(Framedata framedata)

Specified by:

sendFrame in interface WebSocket

getLocalSocketAddress

public java.net.InetSocketAddress getLocalSocketAddress()

Specified by:

getLocalSocketAddress in interface WebSocket

Returns:

never returns null

getRemoteSocketAddress

public java.net.InetSocketAddress getRemoteSocketAddress()

Specified by:

getRemoteSocketAddress in interface WebSocket

Returns:

never returns null

getResourceDescriptor

public java.lang.String getResourceDescriptor()

Description copied from interface: WebSocket

Returns the HTTP Request-URI as defined by http://tools.ietf.org/html/rfc2616#section-5.1.2
If the opening handshake has not yet happened it will return null.

Specified by:

getResourceDescriptor in interface WebSocket