websocket.drawboard

Class Room

java.lang.Object

websocket.drawboard.Room

public final class Room
extends Object

A Room represents a drawboard where a number of users participate.

Note: Instance methods should only be invoked by calling invokeAndWait(Runnable) to ensure access is correctly synchronized.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Room.MessageType Specifies the type of a room message that is sent to a client. Note: Currently we are sending simple string messages - for production apps, a JSON lib should be used for object-level messages. The number (single char) will be prefixed to the string when sending the message.
class	Room.Player A Player participates in a Room.

Constructor Summary

Constructors

Constructor and Description
Room()

Method Summary

Methods

Modifier and Type	Method and Description
Room.Player	createAndAddPlayer(Client client) Creates a Player from the given Client and adds it to this room.
void	invokeAndWait(Runnable task) Submits the given Runnable to the Room Executor and waits until it has been executed.
void	shutdown() Shuts down the roomExecutor and the drawmessageBroadcastTimer.

Methods inherited from class java.lang.Object

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

Constructor Detail

Room

public Room()

Method Detail

createAndAddPlayer

public Room.Player createAndAddPlayer(Client client)

Creates a Player from the given Client and adds it to this room.

Parameters:

client - the client

invokeAndWait

public void invokeAndWait(Runnable task)

Submits the given Runnable to the Room Executor and waits until it has been executed. Currently, this simply means that the Runnable will be run directly inside of a synchronized() block.
Note that if a runnable recursively calls invokeAndWait() with another runnable on this Room, it will not be executed recursively, but instead cached until the original runnable is finished, to keep the behavior of using a Executor.

Parameters:

task -

shutdown

public void shutdown()

Shuts down the roomExecutor and the drawmessageBroadcastTimer.