com.sun.sgs.example.hack.server

Class GameChangeManager

java.lang.Object

com.sun.sgs.example.hack.server.GameChangeManager

All Implemented Interfaces:

com.sun.sgs.app.ManagedObject, com.sun.sgs.app.Task, Serializable

public class GameChangeManager
extends Object
implements com.sun.sgs.app.Task, com.sun.sgs.app.ManagedObject, Serializable

This class acts as an aggregator for game updates. It is called when mambership counts change in any games, or when games are added or removed from the app. It collects the updates, and on regular intervals it sends the details to a set of listeners that it manages, and then clears its update list. Updates are compressed so there is only one update for each game. There is only one instance of GameChangeManager for each game app.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	CHANGE_MANAGER_FREQUENCY The default number of milliseconds between update calls.
static String	IDENTIFIER The identifier for the single manager.

Method Summary

Methods

Modifier and Type	Method and Description
void	addGameChangeListener(GameChangeListener listener) Adds a listener to this manager.
static GameChangeManager	getInstance() Provides access to the single instance of GameChangeManager.
void	notifyGameAdded(String game) Notifies the manager that a game was added to the app.
void	notifyGameRemoved(String game) Notifies the manager that a game was removed from the app.
void	notifyMembershipChanged(GameMembershipDetail detail) Notifies the manager that membership detail has changed in a specific game.
void	run() Called at periodic intervals by the system, this method notifies all registered listeners if there have been any updates since the last notification.

Methods inherited from class java.lang.Object

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

Field Detail

IDENTIFIER

public static final String IDENTIFIER

The identifier for the single manager.

See Also:

Constant Field Values

CHANGE_MANAGER_FREQUENCY

public static final int CHANGE_MANAGER_FREQUENCY

The default number of milliseconds between update calls.

See Also:

Constant Field Values

Method Detail

getInstance

public static GameChangeManager getInstance()

Provides access to the single instance of GameChangeManager. If a manager hasn't already been created, then a new instance is created and added as a registered ManagedObject. If the manager already exists then nothing new is created.

See the comment in Lobby.getInstance for more about the pattern used by these getInstance methods.

Returns:

a reference to the singleton GameChangeManager

addGameChangeListener

public void addGameChangeListener(GameChangeListener listener)

Adds a listener to this manager. All listeners are called back at regular intervals if there are any changes to report.

Parameters:

listener - the listener to add

notifyGameAdded

public void notifyGameAdded(String game)

Notifies the manager that a game was added to the app.

Parameters:

game - the name of the Game

notifyGameRemoved

public void notifyGameRemoved(String game)

Notifies the manager that a game was removed from the app.

Parameters:

game - the name of the Game

notifyMembershipChanged

public void notifyMembershipChanged(GameMembershipDetail detail)

Notifies the manager that membership detail has changed in a specific game.

Parameters:

detail - the update information

run

public void run()
         throws Exception

Called at periodic intervals by the system, this method notifies all registered listeners if there have been any updates since the last notification.

Specified by:

run in interface com.sun.sgs.app.Task

Throws:

Exception