Package org.java_websocket

Class WebSocketImpl

java.lang.Object

org.java_websocket.WebSocketImpl

All Implemented Interfaces:

WebSocket

public class WebSocketImpl
extends java.lang.Object
implements WebSocket

Represents one end (client or server) of a single WebSocketImpl connection. Takes care of the "handshake" phase, then allows for easy sending of text frames, and receiving frames through an event-based model.

Nested Class Summary

Nested classes/interfaces inherited from interface org.java_websocket.WebSocket

WebSocket.READYSTATE, WebSocket.Role

Field Summary

Fields

Modifier and Type	Field	Description
java.nio.channels.ByteChannel	channel	the possibly wrapped channel object whose selection is controlled by key
static boolean	DEBUG	Activate debug mode for additional infos
java.util.concurrent.BlockingQueue<java.nio.ByteBuffer>	inQueue	Queue of buffers that need to be processed
java.nio.channels.SelectionKey	key
java.util.concurrent.BlockingQueue<java.nio.ByteBuffer>	outQueue	Queue of buffers that need to be sent to the client.
static int	RCVBUF
WebSocketServer.WebSocketWorker	workerThread	Helper variable meant to store the thread which ( exclusively ) triggers this objects decode method.

Fields inherited from interface org.java_websocket.WebSocket

DEFAULT_PORT, DEFAULT_WSS_PORT

Constructor Summary

Constructors

Constructor	Description
WebSocketImpl(WebSocketListener listener, java.util.List<Draft> drafts)	Creates a websocket with server role
WebSocketImpl(WebSocketListener listener, java.util.List<Draft> drafts, java.net.Socket socket)	Deprecated.
WebSocketImpl(WebSocketListener listener, Draft draft)	creates a websocket with client role
WebSocketImpl(WebSocketListener listener, Draft draft, java.net.Socket socket)	Deprecated.

Method Summary

Modifier and Type	Method	Description
void	close()	Convenience function which behaves like close(CloseFrame.NORMAL)
void	close(int code)	sends the closing handshake.
void	close(int code, java.lang.String message)	sends the closing handshake.
void	close(int code, java.lang.String message, boolean remote)
void	close(InvalidDataException e)
void	closeConnection()
protected void	closeConnection(int code, boolean remote)
void	closeConnection(int code, java.lang.String message)	This will close the connection immediately without a proper close handshake.
void	closeConnection(int code, java.lang.String message, boolean remote)	This will close the connection immediately without a proper close handshake.
void	decode(java.nio.ByteBuffer socketBuffer)	Method to decode the provided ByteBuffer
void	eot()
void	flushAndClose(int code, java.lang.String message, boolean remote)
<T> T	getAttachment()	Getter for the connection attachment.
Draft	getDraft()	Getter for the draft
java.net.InetSocketAddress	getLocalSocketAddress()	Returns the address of the endpoint this socket is bound to.
WebSocket.READYSTATE	getReadyState()	Retrieve the WebSocket 'readyState'.
java.net.InetSocketAddress	getRemoteSocketAddress()	Returns the address of the endpoint this socket is connected to, ornull if it is unconnected.
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.
WebSocketListener	getWebSocketListener()	Getter for the websocket listener
boolean	hasBufferedData()	Checks if the websocket has buffered data
int	hashCode()
boolean	isClosed()	Is the websocket in the state CLOSED
boolean	isClosing()	Is the websocket in the state CLOSING
boolean	isConnecting()	Deprecated.
boolean	isFlushAndClose()	Returns true when no further frames may be submitted This happens before the socket connection is closed.
boolean	isOpen()	Is the websocket in the state OPEN
void	send(byte[] bytes)	Send Binary data (plain bytes) to the other end.
void	send(java.lang.String text)	Send Text data to the other end.
void	send(java.nio.ByteBuffer bytes)	Send Binary data (plain bytes) to the other end.
void	sendFragmentedFrame(Framedata.Opcode op, java.nio.ByteBuffer buffer, boolean fin)	Allows to send continuous/fragmented frames conveniently.
void	sendFrame(java.util.Collection<Framedata> frames)	Send a collection of frames to the other end
void	sendFrame(Framedata framedata)	Send a frame to the other end
void	sendPing()	Send a ping to the other end
<T> void	setAttachment(T attachment)	Setter for an attachment on the socket connection.
void	startHandshake(ClientHandshakeBuilder handshakedata)
java.lang.String	toString()
void	updateLastPong()	Update the timestamp when the last pong was received

Methods inherited from class java.lang.Object

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

Field Detail

RCVBUF

public static int RCVBUF

DEBUG

public static boolean DEBUG

Activate debug mode for additional infos

outQueue

public final java.util.concurrent.BlockingQueue<java.nio.ByteBuffer> outQueue

Queue of buffers that need to be sent to the client.

inQueue

public final java.util.concurrent.BlockingQueue<java.nio.ByteBuffer> inQueue

Queue of buffers that need to be processed

key

public java.nio.channels.SelectionKey key

channel

public java.nio.channels.ByteChannel channel

the possibly wrapped channel object whose selection is controlled by key

workerThread

public volatile WebSocketServer.WebSocketWorker workerThread

Helper variable meant to store the thread which ( exclusively ) triggers this objects decode method.

Constructor Detail

WebSocketImpl

public WebSocketImpl(WebSocketListener listener,
                     java.util.List<Draft> drafts)

Creates a websocket with server role

Parameters:

listener - The listener for this instance

drafts - The drafts which should be used

WebSocketImpl

public WebSocketImpl(WebSocketListener listener,
                     Draft draft)

creates a websocket with client role

Parameters:

listener - The listener for this instance

draft - The draft which should be used

WebSocketImpl

@Deprecated
public WebSocketImpl(WebSocketListener listener,
                     Draft draft,
                     java.net.Socket socket)

Deprecated.

WebSocketImpl

@Deprecated
public WebSocketImpl(WebSocketListener listener,
                     java.util.List<Draft> drafts,
                     java.net.Socket socket)

Deprecated.

Method Detail

decode

public void decode(java.nio.ByteBuffer socketBuffer)

Method to decode the provided ByteBuffer

Parameters:

socketBuffer - the ByteBuffer to decode

close

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

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

Parameters:

code - the closing code

message - the closing message

closeConnection

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

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.

Parameters:

code - the closing code

message - the closing message

remote - Indicates who "generated" code.
true means that this endpoint received the code from the other endpoint.
false means this endpoint decided to send the given code,
remote may also be true if this endpoint started the closing handshake since the other endpoint may not simply echo the code but close the connection the same time this endpoint does do but with an other code.

closeConnection

protected void closeConnection(int code,
                               boolean remote)

closeConnection

public void closeConnection()

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

Parameters:

code - the closing code

message - the closing message

flushAndClose

public void flushAndClose(int code,
                          java.lang.String message,
                          boolean remote)

eot

public void eot()

close

public void close(int code)

Description copied from interface: WebSocket

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

Specified by:

close in interface WebSocket

Parameters:

code - the closing code

close

public void close(InvalidDataException e)

send

public void send(java.lang.String text)
          throws WebsocketNotConnectedException

Send Text data to the other end.

Specified by:

send in interface WebSocket

Parameters:

text - the text data to send

Throws:

java.nio.channels.NotYetConnectedException - websocket is not yet connected

WebsocketNotConnectedException

send

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

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

Specified by:

send in interface WebSocket

Parameters:

bytes - the binary data to send

Throws:

java.lang.IllegalArgumentException - the data is null

java.nio.channels.NotYetConnectedException - websocket is not yet connected

WebsocketNotConnectedException

send

public void send(byte[] bytes)
          throws java.lang.IllegalArgumentException,
                 WebsocketNotConnectedException

Description copied from interface: WebSocket

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

Specified by:

send in interface WebSocket

Parameters:

bytes - the byte array to send

Throws:

java.lang.IllegalArgumentException - the data is null

WebsocketNotConnectedException

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.

sendFrame

public void sendFrame(java.util.Collection<Framedata> frames)

Description copied from interface: WebSocket

Send a collection of frames to the other end

Specified by:

sendFrame in interface WebSocket

Parameters:

frames - the frames to send to the other end

sendFrame

public void sendFrame(Framedata framedata)

Description copied from interface: WebSocket

Send a frame to the other end

Specified by:

sendFrame in interface WebSocket

Parameters:

framedata - the frame to send to the other end

sendPing

public void sendPing()
              throws java.nio.channels.NotYetConnectedException

Description copied from interface: WebSocket

Send a ping to the other end

Specified by:

sendPing in interface WebSocket

Throws:

java.nio.channels.NotYetConnectedException - websocket is not yet connected

hasBufferedData

public boolean hasBufferedData()

Description copied from interface: WebSocket

Checks if the websocket has buffered data

Specified by:

hasBufferedData in interface WebSocket

Returns:

has the websocket buffered data

startHandshake

public void startHandshake(ClientHandshakeBuilder handshakedata)
                    throws InvalidHandshakeException

Throws:

InvalidHandshakeException

isConnecting

@Deprecated
public boolean isConnecting()

Deprecated.

Description copied from interface: WebSocket

Is the websocket in the state CONNECTING

Specified by:

isConnecting in interface WebSocket

Returns:

state equals READYSTATE.CONNECTING

isOpen

public boolean isOpen()

Description copied from interface: WebSocket

Is the websocket in the state OPEN

Specified by:

isOpen in interface WebSocket

Returns:

state equals READYSTATE.OPEN

isClosing

public boolean isClosing()

Description copied from interface: WebSocket

Is the websocket in the state CLOSING

Specified by:

isClosing in interface WebSocket

Returns:

state equals READYSTATE.CLOSING

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

Returns:

true when no further frames may be submitted

isClosed

public boolean isClosed()

Description copied from interface: WebSocket

Is the websocket in the state CLOSED

Specified by:

isClosed in interface WebSocket

Returns:

state equals READYSTATE.CLOSED

getReadyState

public WebSocket.READYSTATE getReadyState()

Description copied from interface: WebSocket

Retrieve the WebSocket 'readyState'. This represents the state of the connection. It returns a numerical value, as per W3C WebSockets specs.

Specified by:

getReadyState in interface WebSocket

Returns:

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

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getRemoteSocketAddress

public java.net.InetSocketAddress getRemoteSocketAddress()

Description copied from interface: WebSocket

Returns the address of the endpoint this socket is connected to, ornull if it is unconnected.

Specified by:

getRemoteSocketAddress in interface WebSocket

Returns:

never returns null

getLocalSocketAddress

public java.net.InetSocketAddress getLocalSocketAddress()

Description copied from interface: WebSocket

Returns the address of the endpoint this socket is bound to.

Specified by:

getLocalSocketAddress in interface WebSocket

Returns:

never returns null

getDraft

public Draft getDraft()

Description copied from interface: WebSocket

Getter for the draft

Specified by:

getDraft in interface WebSocket

Returns:

the used draft

close

public void close()

Description copied from interface: WebSocket

Convenience function which behaves like close(CloseFrame.NORMAL)

Specified by:

close in interface WebSocket

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

Returns:

Returns the decoded path component of this URI.

updateLastPong

public void updateLastPong()

Update the timestamp when the last pong was received

getWebSocketListener

public WebSocketListener getWebSocketListener()

Getter for the websocket listener

Returns:

the websocket listener associated with this instance

getAttachment

public <T> T getAttachment()

Description copied from interface: WebSocket

Getter for the connection attachment.

Specified by:

getAttachment in interface WebSocket

Type Parameters:

T - The type of the attachment

Returns:

Returns the user attachment

setAttachment

public <T> void setAttachment(T attachment)

Description copied from interface: WebSocket

Setter for an attachment on the socket connection. The attachment may be of any type.

Specified by:

setAttachment in interface WebSocket

Type Parameters:

T - The type of the attachment

Parameters:

attachment - The object to be attached to the user