com.pusher.java_websocket.drafts

Class Draft

java.lang.Object

com.pusher.java_websocket.drafts.Draft

Direct Known Subclasses:

Draft_10, Draft_75

public abstract class Draft
extends java.lang.Object

Base class for everything of a websocket specification which is not common such as the way the handshake is read or frames are transfered.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Draft.CloseHandshakeType
static class	Draft.HandshakeState

Field Summary

Fields

Modifier and Type	Field and Description
protected Framedata.Opcode	continuousFrameType
static byte[]	FLASH_POLICY_REQUEST
static int	INITIAL_FAMESIZE
static int	MAX_FAME_SIZE
protected WebSocket.Role	role In some cases the handshake will be parsed different depending on whether

Constructor Summary

Constructors

Constructor and Description
Draft()

Method Summary

Modifier and Type	Method and Description
abstract Draft.HandshakeState	acceptHandshakeAsClient(ClientHandshake request, ServerHandshake response)
abstract Draft.HandshakeState	acceptHandshakeAsServer(ClientHandshake handshakedata)
protected boolean	basicAccept(Handshakedata handshakedata)
int	checkAlloc(int bytecount)
java.util.List<Framedata>	continuousFrame(Framedata.Opcode op, java.nio.ByteBuffer buffer, boolean fin)
abstract Draft	copyInstance() Drafts must only be by one websocket at all.
abstract java.nio.ByteBuffer	createBinaryFrame(Framedata framedata)
abstract java.util.List<Framedata>	createFrames(java.nio.ByteBuffer binary, boolean mask)
abstract java.util.List<Framedata>	createFrames(java.lang.String text, boolean mask)
java.util.List<java.nio.ByteBuffer>	createHandshake(Handshakedata handshakedata, WebSocket.Role ownrole)
java.util.List<java.nio.ByteBuffer>	createHandshake(Handshakedata handshakedata, WebSocket.Role ownrole, boolean withcontent)
abstract Draft.CloseHandshakeType	getCloseHandshakeType()
WebSocket.Role	getRole()
abstract ClientHandshakeBuilder	postProcessHandshakeRequestAsClient(ClientHandshakeBuilder request)
abstract HandshakeBuilder	postProcessHandshakeResponseAsServer(ClientHandshake request, ServerHandshakeBuilder response)
static java.nio.ByteBuffer	readLine(java.nio.ByteBuffer buf)
static java.lang.String	readStringLine(java.nio.ByteBuffer buf)
abstract void	reset()
void	setParseMode(WebSocket.Role role)
abstract java.util.List<Framedata>	translateFrame(java.nio.ByteBuffer buffer)
Handshakedata	translateHandshake(java.nio.ByteBuffer buf)
static HandshakeBuilder	translateHandshakeHttp(java.nio.ByteBuffer buf, WebSocket.Role role)

Methods inherited from class java.lang.Object

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

Field Detail

MAX_FAME_SIZE

public static int MAX_FAME_SIZE

INITIAL_FAMESIZE

public static int INITIAL_FAMESIZE

FLASH_POLICY_REQUEST

public static final byte[] FLASH_POLICY_REQUEST

role

protected WebSocket.Role role

In some cases the handshake will be parsed different depending on whether

continuousFrameType

protected Framedata.Opcode continuousFrameType

Constructor Detail

Draft

public Draft()

Method Detail

readLine

public static java.nio.ByteBuffer readLine(java.nio.ByteBuffer buf)

readStringLine

public static java.lang.String readStringLine(java.nio.ByteBuffer buf)

translateHandshakeHttp

public static HandshakeBuilder translateHandshakeHttp(java.nio.ByteBuffer buf,
                                                      WebSocket.Role role)
                                               throws InvalidHandshakeException,
                                                      IncompleteHandshakeException

Throws:

InvalidHandshakeException

IncompleteHandshakeException

acceptHandshakeAsClient

public abstract Draft.HandshakeState acceptHandshakeAsClient(ClientHandshake request,
                                                             ServerHandshake response)
                                                      throws InvalidHandshakeException

Throws:

InvalidHandshakeException

acceptHandshakeAsServer

public abstract Draft.HandshakeState acceptHandshakeAsServer(ClientHandshake handshakedata)
                                                      throws InvalidHandshakeException

Throws:

InvalidHandshakeException

basicAccept

protected boolean basicAccept(Handshakedata handshakedata)

createBinaryFrame

public abstract java.nio.ByteBuffer createBinaryFrame(Framedata framedata)

createFrames

public abstract java.util.List<Framedata> createFrames(java.nio.ByteBuffer binary,
                                                       boolean mask)

createFrames

public abstract java.util.List<Framedata> createFrames(java.lang.String text,
                                                       boolean mask)

continuousFrame

public java.util.List<Framedata> continuousFrame(Framedata.Opcode op,
                                                 java.nio.ByteBuffer buffer,
                                                 boolean fin)

reset

public abstract void reset()

createHandshake

public java.util.List<java.nio.ByteBuffer> createHandshake(Handshakedata handshakedata,
                                                           WebSocket.Role ownrole)

createHandshake

public java.util.List<java.nio.ByteBuffer> createHandshake(Handshakedata handshakedata,
                                                           WebSocket.Role ownrole,
                                                           boolean withcontent)

postProcessHandshakeRequestAsClient

public abstract ClientHandshakeBuilder postProcessHandshakeRequestAsClient(ClientHandshakeBuilder request)
                                                                    throws InvalidHandshakeException

Throws:

InvalidHandshakeException

postProcessHandshakeResponseAsServer

public abstract HandshakeBuilder postProcessHandshakeResponseAsServer(ClientHandshake request,
                                                                      ServerHandshakeBuilder response)
                                                               throws InvalidHandshakeException

Throws:

InvalidHandshakeException

translateFrame

public abstract java.util.List<Framedata> translateFrame(java.nio.ByteBuffer buffer)
                                                  throws InvalidDataException

Throws:

InvalidDataException

getCloseHandshakeType

public abstract Draft.CloseHandshakeType getCloseHandshakeType()

copyInstance

public abstract Draft copyInstance()

Drafts must only be by one websocket at all. To prevent drafts to be used more than once the Websocket implementation should call this method in order to create a new usable version of a given draft instance.
The copy can be safely used in conjunction with a new websocket connection.

translateHandshake

public Handshakedata translateHandshake(java.nio.ByteBuffer buf)
                                 throws InvalidHandshakeException

Throws:

InvalidHandshakeException

checkAlloc

public int checkAlloc(int bytecount)
               throws LimitExedeedException,
                      InvalidDataException

Throws:

LimitExedeedException

InvalidDataException

setParseMode

public void setParseMode(WebSocket.Role role)

getRole

public WebSocket.Role getRole()