Class Foundation

java.lang.Object

CardStack

Foundation

public class Foundation
extends CardStack

A Foundation is a specialized card stack where a card may be added if (1) it is empty and the card is an ace or (2) it is not empty and the card is the same suit as the top card with the next higher rank. Cards may not be played from a Foundation.

Field Summary

Fields inherited from class CardStack

stack

Constructor Summary

Constructors

Constructor and Description
Foundation()

Method Summary

Modifier and Type	Method and Description
boolean	canPlayFrom() Throws IllegalPlayException "That card stack cannot be played from."
boolean	playTo(Card card) Given a card to be played to the top of this card stack, either make the legal play and return true, or throw an appropriate Exception.

Methods inherited from class CardStack

addCard, getTopCard, isEmpty, playTo, removeTopCard, size, toArray, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Foundation

public Foundation()

Method Detail

canPlayFrom

public boolean canPlayFrom()
                    throws IllegalPlayException

Throws IllegalPlayException "That card stack cannot be played from."

Overrides:

canPlayFrom in class CardStack

Returns:

true if a card may be removed from this stack

Throws:

IllegalPlayException - thrown "That card stack cannot be played from."

playTo

public boolean playTo(Card card)
               throws java.lang.NullPointerException,
                      IllegalPlayException

Given a card to be played to the top of this card stack, either make the legal play and return true, or throw an appropriate Exception. For a Foundation, the play is legal if (1) it is empty and the card is an ace or (2) it is not empty and the card is the same suit as the top card with the next higher rank.

Overrides:

playTo in class CardStack

Parameters:

card - card to be played onto this card stack

Returns:

true if the card was played onto this card stack

Throws:

java.lang.NullPointerException - thrown if given Card parameter is null

IllegalPlayException - thrown if "The first foundation card must be an Ace." or "Plays to a foundation must match suit." / "Plays to a foundation must have the next increasing rank." in that order.