wcg.main

Class User

java.lang.Object

wcg.main.User

All Implemented Interfaces:

java.io.Serializable, GameObserver, Player

public class User
extends java.lang.Object
implements Player, java.io.Serializable

A system user, with a user and password. This is a serializable class, hence the password is recorded as as MD5 digest.

Author:

José Paulo Leal jpleal@fc.up.pt

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
User(java.lang.String nick, java.lang.String password) Instantiates a user with given nick and password.

Method Summary

Modifier and Type	Method and Description
(package private) boolean	authenticate(java.lang.String password) Checks if given password authenticates this user.
(package private) byte[]	digest(java.lang.String password) Converts a passwords in a byte array using a MD5 digest (MessageDigest, MessageDigest.digest()).
java.lang.String	getNick() Players nick, it will used as an ID.
(package private) java.util.List<GameEvent>	getRecentEvents() A list of pending events received by this user.
void	notify(GameEndEvent event) Notify the observer that the game has ended.
void	notify(RoundConclusionEvent event) Notify the observer of the round conclusion.
void	notify(RoundUpdateEvent event) Notify the observer of updates in a round.
void	notify(SendCardsEvent event) Notify the observer and send her/him/it a list of cards.

Methods inherited from class java.lang.Object

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

Constructor Detail

User

User(java.lang.String nick,
     java.lang.String password)

Instantiates a user with given nick and password.

Parameters:

nick - of user.

password - of user.

Method Detail

authenticate

boolean authenticate(java.lang.String password)

Checks if given password authenticates this user.

Parameters:

password - to check.

Returns:

true if passwords match; false otherwise.

digest

byte[] digest(java.lang.String password)

Converts a passwords in a byte array using a MD5 digest (MessageDigest, MessageDigest.digest()).

Parameters:

password - to digest.

Returns:

byte array.

getNick

public java.lang.String getNick()

Description copied from interface: Player

Players nick, it will used as an ID.

Specified by:

getNick in interface Player

Returns:

nick of player,

notify

public void notify(SendCardsEvent event)

Description copied from interface: GameObserver

Notify the observer and send her/him/it a list of cards. This event is typically the first one received by a player in a particular game instance. In some games this method may be invoked several times during a game instance. The method is meant to be invoked in a single observer/player and not to be broadcast.

Specified by:

notify in interface GameObserver

Parameters:

event - to send.

notify

public void notify(RoundUpdateEvent event)

Description copied from interface: GameObserver

Notify the observer of updates in a round. This event trigger the player to play her/his/it cards. These updates are sent when a player plays and are broadcast to provide the same information to all players simultaneously.

Specified by:

notify in interface GameObserver

Parameters:

event - to send.

notify

public void notify(RoundConclusionEvent event)

Description copied from interface: GameObserver

Notify the observer of the round conclusion. The event provides information on the round status. These notifications are broadcast to provide the same information to all players simultaneously.

Specified by:

notify in interface GameObserver

Parameters:

event - to send.

notify

public void notify(GameEndEvent event)

Description copied from interface: GameObserver

Notify the observer that the game has ended. The event provides information on the final game status. This event is the last in a game instance and is broadcast to all players.

Specified by:

notify in interface GameObserver

Parameters:

event - to send.

getRecentEvents

java.util.List<GameEvent> getRecentEvents()

A list of pending events received by this user. The returned events are cleared and will not be returned again by this method.

Returns:

list of events.