Chapter: Hangman -- My Model

In an earlier lab you looked at a hangman program. The game is this:

• There is a target word or phrase to be guessed.
• The player begins with a number of lives.
• The player guesses letters one at a time.
  • If the letter appears anywhere in the target, then all occurences of the letter will be divulged.
  • If the letter does not appear in the target, the player loses a life.
• If the player still has at least one life left and all the letters are divulged, the player wins.
• If the player has no lives left, the player loses.

The model for this game needs the following state:

• The target
• A structure of all the letters guessed so far
• how many lives are left

In my model, I provide the following public methods:

public void guess(Character c); 
/* Process the letter c */

public int getLives();          
/* Return the number of lives the player has remaining */

public String getDisplayWord(); 
/*  Returns the string with all unguessed letters replaced by '_' */

public boolean playing();
/* Return true if the game has not ended */

public boolean win();
/* Return true if the player has won */

The constructor for my model passes in the initial number of lives the player is granted and the target word or phrase.