wcg.games

Class ObservableGame

java.lang.Object

wcg.games.ObservableGame

Direct Known Subclasses:

GameMaster

public class ObservableGame
extends java.lang.Object

Observer management and event propagation in a game instance. This class provides methods to register observers and propagate 3 types of events SendCardsEvent, RoundUpdateEvent, RoundConclusionEvent and GameEndEvent -, using 2 different communication forms. The former is sent to a single user and the latter two are broadcast to all observers. No enable this 2 forms observers are associated with a nick that is used as an identifier (i.e. is assumed to be unique in a game).

This class is a participant in the Observable design pattern.

Author:

José Paulo Leal jpleal@fc.up.pt

Constructor Summary

Constructors

Constructor and Description
ObservableGame()

Method Summary

Modifier and Type	Method and Description
protected void	addObserver(java.lang.String nick, GameObserver observer) Add a GameObserver that will receive a notification when an event is broadcast.
protected void	broadcast(GameEndEvent event) Broadcast given GameEndEvent to all registered observers.
protected void	broadcast(RoundConclusionEvent event) Broadcast given RoundConclusionEvent to all registered observers.
protected void	broadcast(RoundUpdateEvent event) Broadcast given RoundUpdateEvent to all registered observers.
protected void	notify(java.lang.String nick, SendCardsEvent event) Notify a single observer with a send SendCardsEvent.

Methods inherited from class java.lang.Object

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

Constructor Detail

ObservableGame

public ObservableGame()

Method Detail

addObserver

protected void addObserver(java.lang.String nick,
                           GameObserver observer)

Add a GameObserver that will receive a notification when an event is broadcast.

Parameters:

nick - identifying observer

observer - that will receive the event

notify

protected void notify(java.lang.String nick,
                      SendCardsEvent event)

Notify a single observer with a send SendCardsEvent. Only previously registered observers will receive these notifications. Events to non-registered observers will be silently ignored.

Parameters:

nick - identifying observer

event - to send

broadcast

protected void broadcast(RoundUpdateEvent event)

Broadcast given RoundUpdateEvent to all registered observers.

Parameters:

event - to broadcast

broadcast

protected void broadcast(RoundConclusionEvent event)

Broadcast given RoundConclusionEvent to all registered observers.

Parameters:

event - to broadcast

broadcast

protected void broadcast(GameEndEvent event)

Broadcast given GameEndEvent to all registered observers.

Parameters:

event - to broadcast