public abstract class WebSocketClient extends AbstractWebSocket implements Runnable, WebSocket
connect(), then receive events like onMessage(String) via the overloaded methods
and to send(String) data to the server.| 限定符和类型 | 字段和说明 |
|---|---|
protected URI |
uri
The URI this channel is supposed to connect to.
|
DEFAULT_PORT, DEFAULT_WSS_PORT| 构造器和说明 |
|---|
WebSocketClient(URI serverUri)
Constructs a WebSocketClient instance and sets it to the connect to the specified URI.
|
WebSocketClient(URI serverUri,
Draft protocolDraft)
Constructs a WebSocketClient instance and sets it to the connect to the specified URI.
|
WebSocketClient(URI serverUri,
Draft protocolDraft,
Map<String,String> httpHeaders)
Constructs a WebSocketClient instance and sets it to the connect to the specified URI.
|
WebSocketClient(URI serverUri,
Draft protocolDraft,
Map<String,String> httpHeaders,
int connectTimeout)
Constructs a WebSocketClient instance and sets it to the connect to the specified URI.
|
WebSocketClient(URI serverUri,
Map<String,String> httpHeaders,
String charset)
Constructs a WebSocketClient instance and sets it to the connect to the specified URI.
|
| 限定符和类型 | 方法和说明 |
|---|---|
void |
close()
Initiates the websocket close handshake.
|
void |
close(int code)
sends the closing handshake. may be send in response to an other handshake.
|
void |
close(int code,
String message)
sends the closing handshake. may be send in response to an other handshake.
|
void |
closeBlocking()
Same as
close but blocks until the websocket closed or failed to do so. |
void |
closeConnection(int code,
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. |
boolean |
connectBlocking(long timeout,
TimeUnit timeUnit)
Same as
connect but blocks with a timeout until the websocket connected or failed to do so. |
<T> T |
getAttachment()
Getter for the connection attachment.
|
WebSocket |
getConnection()
Getter for the engine
|
protected Collection<WebSocket> |
getConnections()
Getter to get all the currently available connections
|
Draft |
getDraft()
Returns the protocol version this channel uses.
|
InetSocketAddress |
getLocalSocketAddress()
Returns the address of the endpoint this socket is bound to.
|
InetSocketAddress |
getLocalSocketAddress(WebSocket conn) |
ReadyState |
getReadyState()
This represents the state of the connection.
|
InetSocketAddress |
getRemoteSocketAddress()
Returns the address of the endpoint this socket is connected to, or
null if it is unconnected. |
InetSocketAddress |
getRemoteSocketAddress(WebSocket conn) |
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. |
Socket |
getSocket()
Returns the socket to allow Hostname Verification
|
URI |
getURI()
Returns the URI that this WebSocketClient is connected to.
|
boolean |
hasBufferedData()
Checks if the websocket has buffered data
|
boolean |
isClosed()
Is the websocket in the state CLOSED
|
boolean |
isClosing()
Is the websocket in the state CLOSING
|
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
|
abstract void |
onClose(int code,
String reason,
boolean remote)
Called after the websocket connection has been closed.
|
void |
onCloseInitiated(int code,
String reason)
Send when this peer sends a close handshake
|
void |
onClosing(int code,
String reason,
boolean remote)
Called as soon as no further frames are accepted
|
abstract void |
onError(Exception ex)
Called when errors occurs.
|
void |
onMessage(ByteBuffer bytes)
Callback for binary messages received from the remote host
|
abstract void |
onMessage(String message)
Callback for string messages received from the remote host
|
abstract void |
onOpen(ServerHandshake handshakedata)
Called after an opening handshake has been performed and the given websocket is ready to be written on.
|
void |
onWebsocketClose(WebSocket conn,
int code,
String reason,
boolean remote)
Calls subclass' implementation of onClose.
|
void |
onWebsocketCloseInitiated(WebSocket conn,
int code,
String reason)
send when this peer sends a close handshake
|
void |
onWebsocketClosing(WebSocket conn,
int code,
String reason,
boolean remote)
Called as soon as no further frames are accepted
|
void |
onWebsocketError(WebSocket conn,
Exception ex)
Calls subclass' implementation of onIOError.
|
void |
onWebsocketMessage(WebSocket conn,
ByteBuffer blob)
Called when an entire binary frame has been received.
|
void |
onWebsocketMessage(WebSocket conn,
String message)
Calls subclass' implementation of onMessage.
|
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 |
reconnect()
Reinitiates the websocket connection.
|
boolean |
reconnectBlocking()
Same as
reconnect but blocks until the websocket reconnected or failed to do so. |
void |
run() |
void |
send(byte[] data)
Sends binary data to the connected webSocket server.
|
void |
send(ByteBuffer bytes)
Send Binary data (plain bytes) to the other end.
|
void |
send(String text)
Sends text to the connected websocket server.
|
void |
sendFragmentedFrame(Opcode op,
ByteBuffer buffer,
boolean fin)
Allows to send continuous/fragmented frames conveniently.
|
void |
sendFrame(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 |
setProxy(Proxy proxy)
Method to set a proxy for this connection
|
void |
setSocket(Socket socket)
Accepts bound and unbound sockets.
|
getConnectionLostTimeout, isReuseAddr, isTcpNoDelay, setConnectionLostTimeout, setReuseAddr, setTcpNoDelay, startConnectionLostTimer, stopConnectionLostTimeronWebsocketHandshakeReceivedAsClient, onWebsocketHandshakeReceivedAsServer, onWebsocketHandshakeSentAsClient, onWebsocketPing, onWebsocketPongprotected URI uri
public WebSocketClient(URI serverUri)
serverUri - the server URI to connect topublic WebSocketClient(URI serverUri, Draft protocolDraft)
serverUri - the server URI to connect toprotocolDraft - The draft which should be used for this connectionpublic WebSocketClient(URI serverUri, Map<String,String> httpHeaders, String charset)
serverUri - the server URI to connect tohttpHeaders - Additional HTTP-Headerspublic WebSocketClient(URI serverUri, Draft protocolDraft, Map<String,String> httpHeaders)
serverUri - the server URI to connect toprotocolDraft - The draft which should be used for this connectionhttpHeaders - Additional HTTP-Headerspublic WebSocketClient(URI serverUri, Draft protocolDraft, Map<String,String> httpHeaders, int connectTimeout)
serverUri - the server URI to connect toprotocolDraft - The draft which should be used for this connectionhttpHeaders - Additional HTTP-HeadersconnectTimeout - The Timeout for the connectionpublic URI getURI()
public Draft getDraft()
public Socket getSocket()
public void reconnect()
public boolean reconnectBlocking()
throws InterruptedException
reconnect but blocks until the websocket reconnected or failed to do so.InterruptedException - Thrown when the threads get interruptedpublic void connect()
public boolean connectBlocking()
throws InterruptedException
connect but blocks until the websocket connected or failed to do so.InterruptedException - Thrown when the threads get interruptedpublic boolean connectBlocking(long timeout,
TimeUnit timeUnit)
throws InterruptedException
connect but blocks with a timeout until the websocket connected or failed to do so.timeout - The connect timeouttimeUnit - The timeout time unitInterruptedException - Thrown when the threads get interruptedpublic void close()
closeBlockingpublic void closeBlocking()
throws InterruptedException
close but blocks until the websocket closed or failed to do so.InterruptedException - Thrown when the threads get interruptedpublic void send(String text) throws NotYetConnectedException
send 在接口中 WebSockettext - The string which will be transmitted.NotYetConnectedException - websocket is not yet connectedpublic void send(byte[] data)
throws NotYetConnectedException
send 在接口中 WebSocketdata - The byte-Array of data to send to the WebSocket server.NotYetConnectedException - websocket is not yet connectedpublic <T> T getAttachment()
WebSocketgetAttachment 在接口中 WebSocketT - The type of the attachmentpublic <T> void setAttachment(T attachment)
WebSocketsetAttachment 在接口中 WebSocketT - The type of the attachmentattachment - The object to be attached to the userprotected Collection<WebSocket> getConnections()
AbstractWebSocketgetConnections 在类中 AbstractWebSocketpublic void sendPing()
throws NotYetConnectedException
WebSocketsendPing 在接口中 WebSocketNotYetConnectedException - websocket is not yet connectedpublic ReadyState getReadyState()
getReadyState 在接口中 WebSocketpublic final void onWebsocketMessage(WebSocket conn, String message)
onWebsocketMessage 在接口中 WebSocketListenerconn - The WebSocket instance this event is occurring on.message - The UTF-8 decoded message that was received.public final void onWebsocketMessage(WebSocket conn, ByteBuffer blob)
WebSocketListeneronWebsocketMessage 在接口中 WebSocketListenerconn - The WebSocket instance this event is occurring on.blob - The binary message that was received.public final void onWebsocketOpen(WebSocket conn, Handshakedata handshake)
onWebsocketOpen 在接口中 WebSocketListenerconn - The WebSocket instance this event is occuring on.handshake - The handshake of the websocket instancepublic final void onWebsocketClose(WebSocket conn, int code, String reason, boolean remote)
onWebsocketClose 在接口中 WebSocketListenerconn - The WebSocket instance this event is occuring on.code - The codes can be looked up here: CloseFramereason - Additional information stringremote - Returns whether or not the closing of the connection was initiated by the remote host.public final void onWebsocketError(WebSocket conn, Exception ex)
onWebsocketError 在接口中 WebSocketListenerconn - The WebSocket instance this event is occuring on.ex - The exception that occurred. public final void onWriteDemand(WebSocket conn)
WebSocketListeneronWriteDemand 在接口中 WebSocketListenerconn - The WebSocket instance this event is occuring on.public void onWebsocketCloseInitiated(WebSocket conn, int code, String reason)
WebSocketListeneronWebsocketCloseInitiated 在接口中 WebSocketListenerconn - The WebSocket instance this event is occuring on.code - The codes can be looked up here: CloseFramereason - Additional information stringpublic void onWebsocketClosing(WebSocket conn, int code, String reason, boolean remote)
WebSocketListeneronWebsocketClosing 在接口中 WebSocketListenerconn - The WebSocket instance this event is occuring on.code - The codes can be looked up here: CloseFramereason - Additional information stringremote - Returns whether or not the closing of the connection was initiated by the remote host.public void onCloseInitiated(int code,
String reason)
code - The codes can be looked up here: CloseFramereason - Additional information stringpublic void onClosing(int code,
String reason,
boolean remote)
code - The codes can be looked up here: CloseFramereason - Additional information stringremote - Returns whether or not the closing of the connection was initiated by the remote host.public WebSocket getConnection()
public InetSocketAddress getLocalSocketAddress(WebSocket conn)
getLocalSocketAddress 在接口中 WebSocketListenerconn - The WebSocket instance this event is occuring on.WebSocket.getLocalSocketAddress()public InetSocketAddress getRemoteSocketAddress(WebSocket conn)
getRemoteSocketAddress 在接口中 WebSocketListenerconn - The WebSocket instance this event is occuring on.null if it is unconnected.WebSocket.getRemoteSocketAddress()public abstract void onOpen(ServerHandshake handshakedata)
handshakedata - The handshake of the websocket instancepublic abstract void onMessage(String message)
message - The UTF-8 decoded message that was received.onMessage(ByteBuffer)public abstract void onClose(int code,
String reason,
boolean remote)
code - The codes can be looked up here: CloseFramereason - Additional information stringremote - Returns whether or not the closing of the connection was initiated by the remote host.public abstract void onError(Exception ex)
onClose(int, String, boolean) will be called
additionally.ex - The exception causing this errorpublic void onMessage(ByteBuffer bytes)
bytes - The binary message that was received.onMessage(String)public void setProxy(Proxy proxy)
proxy - the proxy to use for this websocket clientpublic void setSocket(Socket socket)
connect. If the given socket is not yet bound
it will be bound to the uri specified in the constructor.socket - The socket which should be used for the connectionpublic void sendFragmentedFrame(Opcode op, ByteBuffer buffer, boolean fin)
WebSocketIf 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.
sendFragmentedFrame 在接口中 WebSocketop - 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.public boolean isOpen()
WebSocketpublic boolean isFlushAndClose()
WebSocketisFlushAndClose 在接口中 WebSocketpublic boolean isClosed()
WebSocketpublic boolean isClosing()
WebSocketpublic boolean hasBufferedData()
WebSockethasBufferedData 在接口中 WebSocketpublic void close(int code)
WebSocketpublic void close(int code,
String message)
WebSocketpublic void closeConnection(int code,
String message)
WebSocketcloseConnection 在接口中 WebSocketcode - the closing codemessage - the closing messagepublic void send(ByteBuffer bytes) throws IllegalArgumentException, NotYetConnectedException
WebSocketsend 在接口中 WebSocketbytes - the binary data to sendIllegalArgumentException - the data is nullNotYetConnectedException - websocket is not yet connectedpublic void sendFrame(Framedata framedata)
WebSocketpublic void sendFrame(Collection<Framedata> frames)
WebSocketpublic InetSocketAddress getLocalSocketAddress()
WebSocketgetLocalSocketAddress 在接口中 WebSocketpublic InetSocketAddress getRemoteSocketAddress()
WebSocketnull if it is unconnected.getRemoteSocketAddress 在接口中 WebSocketpublic String getResourceDescriptor()
WebSocketgetResourceDescriptor 在接口中 WebSocketCopyright © 2020. All rights reserved.