Class SimpleGinRummyPlayer

java.lang.Object

SimpleGinRummyPlayer

All Implemented Interfaces:

GinRummyPlayer

public class SimpleGinRummyPlayer
extends java.lang.Object
implements GinRummyPlayer

Implements a random dummy Gin Rummy player that has the following trivial, poor play policy: Ignore opponent actions and cards no longer in play. Draw face up card only if it becomes part of a meld. Draw face down card otherwise. Discard a highest ranking unmelded card without regard to breaking up pairs, etc. Knock as early as possible.

Constructor Summary

Constructors

Constructor and Description
SimpleGinRummyPlayer()

Method Summary

Modifier and Type	Method and Description
Card	getDiscard() Get the player's discarded card.
java.util.ArrayList<java.util.ArrayList<Card>>	getFinalMelds() At the end of each turn, this method is called and the player that cannot (or will not) end the round will return a null value.
void	reportDiscard(int playerNum, Card discardedCard) Report that the given player has discarded a given card.
void	reportDraw(int playerNum, Card drawnCard) Report that the given player has drawn a given card and, if known, what the card is.
void	reportFinalMelds(int playerNum, java.util.ArrayList<java.util.ArrayList<Card>> melds) When an player has ended play and formed melds, the melds are reported to both players.
void	reportScores(int[] scores) Report current player scores, indexed by 0-based player number.
void	startGame(int playerNum, int startingPlayerNum, Card[] cards) Inform player of 0-based player number (0/1), starting player number (0/1), and dealt cards
boolean	willDrawFaceUpCard(Card card) Return whether or not player will draw the given face-up card on the draw pile.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleGinRummyPlayer

public SimpleGinRummyPlayer()

Method Detail

startGame

public void startGame(int playerNum,
                      int startingPlayerNum,
                      Card[] cards)

Description copied from interface: GinRummyPlayer

Inform player of 0-based player number (0/1), starting player number (0/1), and dealt cards

Specified by:

startGame in interface GinRummyPlayer

Parameters:

playerNum - player's 0-based player number (0/1)

startingPlayerNum - starting player number (0/1)

cards - dealt cards

willDrawFaceUpCard

public boolean willDrawFaceUpCard(Card card)

Description copied from interface: GinRummyPlayer

Return whether or not player will draw the given face-up card on the draw pile.

Specified by:

willDrawFaceUpCard in interface GinRummyPlayer

Parameters:

card - face-up card on the draw pile

Returns:

whether or not player will draw the given face-up card on the draw pile

reportDraw

public void reportDraw(int playerNum,
                       Card drawnCard)

Description copied from interface: GinRummyPlayer

Report that the given player has drawn a given card and, if known, what the card is. If the card is unknown because it is drawn from the face-down draw pile, the drawnCard is null. Note that a player that returns false for willDrawFaceUpCard will learn of their face-down draw from this method.

Specified by:

reportDraw in interface GinRummyPlayer

Parameters:

playerNum - - player drawing a card

drawnCard - - the card drawn or null, depending on whether the card is known to the player or not, respectively.

getDiscard

public Card getDiscard()

Description copied from interface: GinRummyPlayer

Get the player's discarded card. If you took the top card from the discard pile, you must discard a different card. If this is not a card in the player's possession, the player forfeits the game.

Specified by:

getDiscard in interface GinRummyPlayer

Returns:

the player's chosen card for discarding

reportDiscard

public void reportDiscard(int playerNum,
                          Card discardedCard)

Description copied from interface: GinRummyPlayer

Report that the given player has discarded a given card.

Specified by:

reportDiscard in interface GinRummyPlayer

Parameters:

playerNum - the discarding player

discardedCard - the card that was discarded

getFinalMelds

public java.util.ArrayList<java.util.ArrayList<Card>> getFinalMelds()

Description copied from interface: GinRummyPlayer

At the end of each turn, this method is called and the player that cannot (or will not) end the round will return a null value. However, the first player to "knock" (that is, end the round), and then their opponent, will return an ArrayList of ArrayLists of melded cards. All other cards are counted as "deadwood", unless they can be laid off (added to) the knocking player's melds. When final melds have been reported for the other player, a player should return their final melds for the round.

Specified by:

getFinalMelds in interface GinRummyPlayer

Returns:

null if continuing play and opponent hasn't melded, or an ArrayList of ArrayLists of melded cards.

reportFinalMelds

public void reportFinalMelds(int playerNum,
                             java.util.ArrayList<java.util.ArrayList<Card>> melds)

Description copied from interface: GinRummyPlayer

When an player has ended play and formed melds, the melds are reported to both players.

Specified by:

reportFinalMelds in interface GinRummyPlayer

Parameters:

playerNum - player that has revealed melds

melds - an ArrayList of ArrayLists of melded cards

reportScores

public void reportScores(int[] scores)

Description copied from interface: GinRummyPlayer

Report current player scores, indexed by 0-based player number.

Specified by:

reportScores in interface GinRummyPlayer

Parameters:

scores - current player scores, indexed by 0-based player number