Package org.atmosphere.websocket

Class WebSocket

java.lang.Object

org.atmosphere.cpr.AsyncIOWriterAdapter

org.atmosphere.cpr.AtmosphereInterceptorWriter

org.atmosphere.websocket.WebSocket

All Implemented Interfaces:

AsyncIOWriter, KeepOpenStreamAware

Direct Known Subclasses:

Grizzly2WebSocket, GrizzlyWebSocket, JBossWebSocket, Jetty8WebSocket, Jetty9WebSocket, JSR356WebSocket, TomcatWebSocket, WebLogicWebSocket

public abstract class WebSocket
extends AtmosphereInterceptorWriter
implements KeepOpenStreamAware

Represent a portable WebSocket implementation which can be used to write message.

Author:

Jeanfrancois Arcand

Field Summary

Fields

Modifier and Type	Field	Description
protected ByteBuffer	bb
protected boolean	binaryWrite
protected CharBuffer	cb
static final String	CLEAN_CLOSE
protected long	lastWrite
protected static final org.slf4j.Logger	logger
static final String	NOT_SUPPORTED
protected String	uuid
static final String	WEBSOCKET_ACCEPT_DONE
static final String	WEBSOCKET_INITIATED
static final String	WEBSOCKET_RESUME
static final String	WEBSOCKET_SUSPEND

Fields inherited from class org.atmosphere.cpr.AtmosphereInterceptorWriter

filters, reversedFilters

Constructor Summary

Constructors

Constructor	Description
WebSocket(AtmosphereConfig config)

Method Summary

Modifier and Type	Method	Description
Object	attachment()	Return the attachment
WebSocket	attachment(Object attachment)	Attach an object.
Map<String,Object>	attributes()	Return the attribute that was set during the websocket's open operation.
WebSocket	binaryWrite(boolean binaryWrite)	Switch to binary write, or go back to text write.
WebSocket	broadcast(Object o)	Broadcast, using the AtmosphereResource.getBroadcaster() the object to all WebSocket associated with the Broadcaster.
abstract void	close()	Close the underlying WebSocket
void	close(int statusCode, String reasonText)	Allow the underlying WebSocket to close with a code and a reason.
void	close(AtmosphereResponse r)	Close the underlying connection.
AtmosphereConfig	config()
WebSocket	flush(AtmosphereResponse r)	Flush the buffered content.
abstract boolean	isOpen()	Is the underlying WebSocket open.
long	lastWriteTimeStampInMilliseconds()	The last time, in milliseconds, a write operation occurred.
static void	notSupported(AtmosphereRequest request, AtmosphereResponse response)
WebSocket	redirect(AtmosphereResponse r, String location)	Redirect a WebSocket request to another location.
AtmosphereResource	resource()	Return the an AtmosphereResource used by this WebSocket, or null if the WebSocket has been closed before the WebSocket message has been processed.
WebSocket	resource(AtmosphereResource r)	Associate an AtmosphereResource to this WebSocket
WebSocket	sendPing(byte[] payload)	Send a WebSocket Ping
WebSocket	sendPong(byte[] payload)	Send a WebSocket Pong
void	shiftAttributes()	Copy AtmosphereRequestImpl.localAttributes() that where set when the websocket was opened.
protected byte[]	transform(byte[] b, int offset, int length)
protected byte[]	transform(AtmosphereResponse response, byte[] b, int offset, int length)
String	uuid()
WebSocketHandler	webSocketHandler()
protected WebSocket	webSocketHandler(WebSocketHandler webSocketHandler)
WebSocket	write(byte[] b)	Use the underlying container's websocket to write the byte.
abstract WebSocket	write(byte[] b, int offset, int length)	Use the underlying container's websocket to write the byte.
abstract WebSocket	write(String s)	Use the underlying container's websocket to write the String.
WebSocket	write(AtmosphereResponse r, byte[] data)	Write a WebSocket message.
WebSocket	write(AtmosphereResponse r, byte[] b, int offset, int length)	Write a WebSocket message.
WebSocket	write(AtmosphereResponse r, String data)	Write a WebSocket message.
WebSocket	writeError(AtmosphereResponse r, int errorCode, String message)	Write an error code.

Methods inherited from class org.atmosphere.cpr.AtmosphereInterceptorWriter

filters, interceptor, interceptor, invokeInterceptor, writeReady

Methods inherited from class java.lang.Object

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

Field Details

logger

protected static final org.slf4j.Logger logger

WEBSOCKET_INITIATED

public static final String WEBSOCKET_INITIATED

WEBSOCKET_SUSPEND

public static final String WEBSOCKET_SUSPEND

WEBSOCKET_RESUME

public static final String WEBSOCKET_RESUME

WEBSOCKET_ACCEPT_DONE

public static final String WEBSOCKET_ACCEPT_DONE

NOT_SUPPORTED

public static final String NOT_SUPPORTED

See Also:

• Constant Field Values

CLEAN_CLOSE

public static final String CLEAN_CLOSE

See Also:

• Constant Field Values

lastWrite

protected long lastWrite

binaryWrite

protected boolean binaryWrite

bb

protected ByteBuffer bb

cb

protected CharBuffer cb

uuid

protected String uuid

Constructor Details

WebSocket

public WebSocket(AtmosphereConfig config)

Method Details

config

public AtmosphereConfig config()

webSocketHandler

protected WebSocket webSocketHandler(WebSocketHandler webSocketHandler)

binaryWrite

public WebSocket binaryWrite(boolean binaryWrite)

Switch to binary write, or go back to text write. Default is false.

Parameters:

binaryWrite - true to switch to binary write.

Returns:

WebSocket

webSocketHandler

public WebSocketHandler webSocketHandler()

resource

public WebSocket resource(AtmosphereResource r)

Associate an AtmosphereResource to this WebSocket

Parameters:

r - an AtmosphereResource to this WebSocket

Returns:

this

shiftAttributes

public void shiftAttributes()

Copy AtmosphereRequestImpl.localAttributes() that where set when the websocket was opened.

attributes

public Map<String,Object> attributes()

Return the attribute that was set during the websocket's open operation.

Returns:

Map

resource

public AtmosphereResource resource()

Return the an AtmosphereResource used by this WebSocket, or null if the WebSocket has been closed before the WebSocket message has been processed.

Returns:

AtmosphereResource

lastWriteTimeStampInMilliseconds

public long lastWriteTimeStampInMilliseconds()

The last time, in milliseconds, a write operation occurred.

Returns:

this

transform

protected byte[] transform(byte[] b,
 int offset,
 int length)
                    throws IOException

Throws:

IOException

transform

protected byte[] transform(AtmosphereResponse response,
 byte[] b,
 int offset,
 int length)
                    throws IOException

Throws:

IOException

write

public WebSocket write(AtmosphereResponse r,
 String data)
                throws IOException

Description copied from interface: AsyncIOWriter

Write a WebSocket message.

Specified by:

write in interface AsyncIOWriter

Overrides:

write in class AtmosphereInterceptorWriter

Parameters:

data - the WebSocket message

Throws:

IOException

write

public WebSocket write(AtmosphereResponse r,
 byte[] data)
                throws IOException

Description copied from interface: AsyncIOWriter

Write a WebSocket message.

Specified by:

write in interface AsyncIOWriter

Overrides:

write in class AtmosphereInterceptorWriter

Parameters:

data - the WebSocket message

Throws:

IOException

write

public WebSocket write(AtmosphereResponse r,
 byte[] b,
 int offset,
 int length)
                throws IOException

Description copied from interface: AsyncIOWriter

Write a WebSocket message.

Specified by:

write in interface AsyncIOWriter

Overrides:

write in class AtmosphereInterceptorWriter

Parameters:

b - the WebSocket message

offset - offset of the message

length - length of the message

Throws:

IOException

broadcast

public WebSocket broadcast(Object o)

Broadcast, using the AtmosphereResource.getBroadcaster() the object to all WebSocket associated with the Broadcaster. This method does the same as websocket.resource().getBroadcaster().broadcast(o).

Parameters:

o - An object to broadcast to all WebSockets.

writeError

public WebSocket writeError(AtmosphereResponse r,
 int errorCode,
 String message)
                     throws IOException

Description copied from interface: AsyncIOWriter

Write an error code.

Specified by:

writeError in interface AsyncIOWriter

Overrides:

writeError in class AtmosphereInterceptorWriter

Parameters:

errorCode - the error code

message -

Throws:

IOException

redirect

public WebSocket redirect(AtmosphereResponse r,
 String location)
                   throws IOException

Description copied from interface: AsyncIOWriter

Redirect a WebSocket request to another location.

Specified by:

redirect in interface AsyncIOWriter

Overrides:

redirect in class AtmosphereInterceptorWriter

Parameters:

location -

Throws:

IOException

close

public void close(AtmosphereResponse r)
           throws IOException

Description copied from interface: AsyncIOWriter

Close the underlying connection.

Specified by:

close in interface AsyncIOWriter

Overrides:

close in class AtmosphereInterceptorWriter

Throws:

IOException

flush

public WebSocket flush(AtmosphereResponse r)
                throws IOException

Description copied from interface: AsyncIOWriter

Flush the buffered content.

Specified by:

flush in interface AsyncIOWriter

Overrides:

flush in class AtmosphereInterceptorWriter

Throws:

IOException

isOpen

public abstract boolean isOpen()

Is the underlying WebSocket open.

Returns:

true is opened

write

public abstract WebSocket write(String s)
                         throws IOException

Use the underlying container's websocket to write the String.

Parameters:

s - a websocket String message

Returns:

this

Throws:

IOException

write

public abstract WebSocket write(byte[] b,
 int offset,
 int length)
                         throws IOException

Use the underlying container's websocket to write the byte.

Parameters:

b - a websocket byte message

offset - start

length - end

Returns:

this

Throws:

IOException

write

public WebSocket write(byte[] b)
                throws IOException

Use the underlying container's websocket to write the byte.

Parameters:

b - a websocket byte message

Returns:

WebSocket

Throws:

IOException

close

public abstract void close()

Close the underlying WebSocket

close

public void close(int statusCode,
 String reasonText)

Allow the underlying WebSocket to close with a code and a reason.

uuid

public String uuid()

notSupported

public static void notSupported(AtmosphereRequest request,
 AtmosphereResponse response)
                         throws IOException

Throws:

IOException

sendPing

public WebSocket sendPing(byte[] payload)

Send a WebSocket Ping

Parameters:

payload - the bytes to send

Returns:

this

sendPong

public WebSocket sendPong(byte[] payload)

Send a WebSocket Pong

Parameters:

payload - the bytes to send

Returns:

this

attachment

public WebSocket attachment(Object attachment)

Attach an object. Be careful when attaching an object as it can cause memory leak

attachment

public Object attachment()

Return the attachment