wwwordz.game

Class Players

java.lang.Object

wwwordz.game.Players

All Implemented Interfaces:

java.io.Serializable

public class Players
extends java.lang.Object
implements java.io.Serializable

Persistent collection of players indexed by nick.

Each player has nick, password, points and accumulated points. Data is persisted using serialization and backup each time a new user is created or points are changed.

This class is a singleton

Author:

José Paulo Leal

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
void	addPoints(java.lang.String nick, int points) Add points to player
(package private) void	cleanup() Clears all players stored in this instances.
static java.io.File	getHome() Current home directory, where the data file is stored
static Players	getInstance() Get single instance of this class
Player	getPlayer(java.lang.String nick)
void	resetPoints(java.lang.String nick) Reset points of current round while keeping accumulated points
static void	setHome(java.io.File home) Update home directory, where the data file is stored
boolean	verify(java.lang.String nick, java.lang.String password) Verify player's password.

Methods inherited from class java.lang.Object

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

Method Detail

getHome

public static java.io.File getHome()

Current home directory, where the data file is stored

Returns:

home directory

setHome

public static void setHome(java.io.File home)

Update home directory, where the data file is stored

Parameters:

home - directory

getInstance

public static Players getInstance()

Get single instance of this class

Returns:

singleton

verify

public boolean verify(java.lang.String nick,
                      java.lang.String password)

Verify player's password. If player doesn't exist yet then it is created with given password.

Parameters:

nick - of player

password - of player

Returns:

true if passwords match; false otherwise

resetPoints

public void resetPoints(java.lang.String nick)
                 throws WWWordzException

Reset points of current round while keeping accumulated points

Parameters:

nick - of player

Throws:

WWWordzException - if player is unknown

addPoints

public void addPoints(java.lang.String nick,
                      int points)
               throws WWWordzException

Add points to player

Parameters:

nick - of player

points - to add

Throws:

WWWordzException - if player is unknown

getPlayer

public Player getPlayer(java.lang.String nick)

cleanup

void cleanup()

Clears all players stored in this instances. This method is used for testing purposes only.