public class WebSocketServerHandshaker13 extends WebSocketServerHandshaker
Performs server side opening and closing handshakes for RFC 6455 (originally web socket specification version draft-ietf-hybi-thewebsocketprotocol- 17).
Modifier and Type | Field and Description |
---|---|
static String |
WEBSOCKET_13_ACCEPT_GUID |
HANDSHAKE_LISTENER, SUB_PROTOCOL_WILDCARD
Constructor and Description |
---|
WebSocketServerHandshaker13(String webSocketURL,
String subprotocols,
boolean allowExtensions)
Constructor using defaults
|
WebSocketServerHandshaker13(String webSocketURL,
String subprotocols,
boolean allowExtensions,
long maxFramePayloadLength)
Constructor specifying the destination web socket location
|
Modifier and Type | Method and Description |
---|---|
ChannelFuture |
close(Channel channel,
CloseWebSocketFrame frame)
Echo back the closing frame and close the connection
|
ChannelFuture |
handshake(Channel channel,
HttpRequest req)
Handle the web socket handshake for the web socket specification HyBi
versions 13-17.
|
getMaxFramePayloadLength, getSelectedSubprotocol, getSubprotocols, getVersion, getWebSocketUrl, selectSubprotocol, setSelectedSubprotocol
public static final String WEBSOCKET_13_ACCEPT_GUID
public WebSocketServerHandshaker13(String webSocketURL, String subprotocols, boolean allowExtensions)
webSocketURL
- URL for web socket communications. e.g
"ws://myhost.com/mypath". Subsequent web socket frames will be
sent to this URL.subprotocols
- CSV of supported protocolsallowExtensions
- Allow extensions to be used in the reserved bits of the web
socket framepublic WebSocketServerHandshaker13(String webSocketURL, String subprotocols, boolean allowExtensions, long maxFramePayloadLength)
webSocketURL
- URL for web socket communications. e.g
"ws://myhost.com/mypath". Subsequent web socket frames will be
sent to this URL.subprotocols
- CSV of supported protocolsallowExtensions
- Allow extensions to be used in the reserved bits of the web
socket framemaxFramePayloadLength
- Maximum allowable frame payload length. Setting this value to
your application's requirement may reduce denial of service
attacks using long data frames.public ChannelFuture handshake(Channel channel, HttpRequest req)
Handle the web socket handshake for the web socket specification HyBi versions 13-17. Versions 13-17 share the same wire protocol.
Browser request to the server:
GET /chat HTTP/1.1 Host: server.example.com Upgrade: websocket Connection: Upgrade Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ== Sec-WebSocket-Origin: http://example.com Sec-WebSocket-Protocol: chat, superchat Sec-WebSocket-Version: 13
Server response:
HTTP/1.1 101 Switching Protocols Upgrade: websocket Connection: Upgrade Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo= Sec-WebSocket-Protocol: chat
handshake
in class WebSocketServerHandshaker
channel
- Channelreq
- HTTP requestpublic ChannelFuture close(Channel channel, CloseWebSocketFrame frame)
close
in class WebSocketServerHandshaker
channel
- Channelframe
- Web Socket frame that was receivedCopyright © 2008-2014 The Netty Project. All Rights Reserved.