WebSocket

所有已知实现类:

WebSocketClient, WebSocketImpl
```
public interface WebSocket
```

嵌套类概要

嵌套类
限定符和类型	接口和说明
`static class`	`WebSocket.READYSTATE` Enum which represents the state a websocket may be in
`static class`	`WebSocket.Role` Enum which represents the states a websocket may be in

字段概要

字段
限定符和类型	字段和说明
`static int`	`DEFAULT_PORT` The default port of WebSockets, as defined in the spec.
`static int`	`DEFAULT_WSS_PORT` The default wss port of WebSockets, as defined in the spec.

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`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`	`closeConnection(int code, java.lang.String message)` This will close the connection immediately without a proper close handshake.
`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, or`null` 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.
`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`	`isConnecting()` Is the websocket in the state CONNECTING
`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.nio.ByteBuffer bytes)` Send Binary data (plain bytes) to the other end.
`void`	`send(java.lang.String text)` Send Text data to the other end.
`void`	`sendFragmentedFrame(Framedata.Opcode op, java.nio.ByteBuffer buffer, boolean fin)` Allows to send continuous/fragmented frames conveniently.
`void`	`sendFrame(Framedata framedata)` Send a frame to the other end
`void`	`sendPing()` Send a ping to the other end

- 字段详细资料
  - DEFAULT_PORT
```
static final int DEFAULT_PORT
```
    The default port of WebSockets, as defined in the spec. If the nullary constructor is used, DEFAULT_PORT will be the port the WebSocketServer is binded to. Note that ports under 1024 usually require root permissions.
    
    另请参阅:
    
    常量字段值
  - DEFAULT_WSS_PORT
```
static final int DEFAULT_WSS_PORT
```
    The default wss port of WebSockets, as defined in the spec. If the nullary constructor is used, DEFAULT_WSS_PORT will be the port the WebSocketServer is binded to. Note that ports under 1024 usually require root permissions.
    
    另请参阅:
    
    常量字段值
- 方法详细资料
  - close
```
void close(int code,
           java.lang.String message)
```
    sends the closing handshake. may be send in response to an other handshake.
    
    参数:
    
    code - the closing code
    
    message - the closing message
  - close
```
void close(int code)
```
    sends the closing handshake. may be send in response to an other handshake.
    
    参数:
    
    code - the closing code
  - close
```
void close()
```
    Convenience function which behaves like close(CloseFrame.NORMAL)
  - closeConnection
```
void closeConnection(int code,
                     java.lang.String message)
```
    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.
    
    参数:
    
    code - the closing code
    
    message - the closing message
  - send
```
void send(java.lang.String text)
   throws java.nio.channels.NotYetConnectedException
```
    Send Text data to the other end.
    
    参数:
    
    text - the text data to send
    
    抛出:
    
    java.nio.channels.NotYetConnectedException - websocket is not yet connected
  - send
```
void send(java.nio.ByteBuffer bytes)
   throws java.lang.IllegalArgumentException,
          java.nio.channels.NotYetConnectedException
```
    Send Binary data (plain bytes) to the other end.
    
    参数:
    
    bytes - the binary data to send
    
    抛出:
    
    java.lang.IllegalArgumentException - the data is null
    
    java.nio.channels.NotYetConnectedException - websocket is not yet connected
  - send
```
void send(byte[] bytes)
   throws java.lang.IllegalArgumentException,
          java.nio.channels.NotYetConnectedException
```
    Send Binary data (plain bytes) to the other end.
    
    参数:
    
    bytes - the byte array to send
    
    抛出:
    
    java.lang.IllegalArgumentException - the data is null
    
    java.nio.channels.NotYetConnectedException - websocket is not yet connected
  - sendFrame
```
void sendFrame(Framedata framedata)
```
    Send a frame to the other end
    
    参数:
    
    framedata - the frame to send to the other end
  - sendPing
```
void sendPing()
       throws java.nio.channels.NotYetConnectedException
```
    Send a ping to the other end
    
    抛出:
    
    java.nio.channels.NotYetConnectedException - websocket is not yet connected
  - sendFragmentedFrame
```
void sendFragmentedFrame(Framedata.Opcode op,
                         java.nio.ByteBuffer buffer,
                         boolean fin)
```
    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.
    
    参数:
    
    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.
  - hasBufferedData
```
boolean hasBufferedData()
```
    Checks if the websocket has buffered data
    
    返回:
    
    has the websocket buffered data
  - getRemoteSocketAddress
```
java.net.InetSocketAddress getRemoteSocketAddress()
```
    Returns the address of the endpoint this socket is connected to, ornull if it is unconnected.
    
    返回:
    
    never returns null
  - getLocalSocketAddress
```
java.net.InetSocketAddress getLocalSocketAddress()
```
    Returns the address of the endpoint this socket is bound to.
    
    返回:
    
    never returns null
  - isConnecting
```
boolean isConnecting()
```
    Is the websocket in the state CONNECTING
    
    返回:
    
    state equals READYSTATE.CONNECTING
  - isOpen
```
boolean isOpen()
```
    Is the websocket in the state OPEN
    
    返回:
    
    state equals READYSTATE.OPEN
  - isClosing
```
boolean isClosing()
```
    Is the websocket in the state CLOSING
    
    返回:
    
    state equals READYSTATE.CLOSING
  - isFlushAndClose
```
boolean isFlushAndClose()
```
    Returns true when no further frames may be submitted
    This happens before the socket connection is closed.
    
    返回:
    
    true when no further frames may be submitted
  - isClosed
```
boolean isClosed()
```
    Is the websocket in the state CLOSED
    
    返回:
    
    state equals READYSTATE.CLOSED
  - getDraft
```
Draft getDraft()
```
    Getter for the draft
    
    返回:
    
    the used draft
  - getReadyState
```
WebSocket.READYSTATE getReadyState()
```
    Retrieve the WebSocket 'readyState'. This represents the state of the connection. It returns a numerical value, as per W3C WebSockets specs.
    
    返回:
    
    Returns '0 = CONNECTING', '1 = OPEN', '2 = CLOSING' or '3 = CLOSED'
  - getResourceDescriptor
```
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.
    
    返回:
    
    Returns the decoded path component of this URI.

接口 WebSocket

嵌套类概要

字段概要

方法概要

字段详细资料

DEFAULT_PORT

DEFAULT_WSS_PORT

方法详细资料

close

close

close

closeConnection

send

send

send

sendFrame

sendPing

sendFragmentedFrame

hasBufferedData

getRemoteSocketAddress

getLocalSocketAddress

isConnecting

isOpen

isClosing

isFlushAndClose

isClosed

getDraft

getReadyState

getResourceDescriptor