188 CHAPTER 5.
OBJECTS AND CLASSES
A Card object needs instance variables to represent its value and suit. I’ve made these
private so that they cannot be changed from outside the class, and I’ve provided getter methods
getSuit() and getValue() so that it will be possible to discover the suit and value from outside
the class. The instance variables are initialized in the constructor, and are never changed after
that. In fact, I’ve declared the instance variables suit and value to be final, since they are
never changed after they are initialized. (An instance variable can be declared final provided
it is either given an initial value in its declaration or is initialized in every constructor in the
class.)
Finally, I’ve added a few convenience methods to the class to make it easier to print out
cards in a human-readable form. For example, I want to be able to print out the suit of a
card as the word “Diamonds”, rather than as the meaningless code number 2, which is used
in the class to represent diamonds. Since this is something that I’ll probably have to do in
many programs, it makes sense to include support for it in the class. So, I’ve provided instance
methods getSuitAsString() and getValueAsString() to return string representations of the
suit and value of a card. Finally, I’ve defined the instance method toString() to return a
string with both the value and suit, such as “Queen of Hearts”. Recall that this method will be
used whenever a Card needs to be converted into a String, such as when the card is concatenated
onto a string with the + operator. Thus, the statement
System.out.println( "Your card is the " + card );
is equivalent to
System.out.println( "Your card is the " + card.toString() );
If the card is the queen of hearts, either of these will print out “Your card is the Queen of
Hearts”.
Here is the complete Card class. It is general enough to be highly reusable, so the work that
went into designing, writing, and testing it pays off handsomely in the long run.
/**
* An object of type Card represents a playing card from a
* standard Poker deck, including Jokers. The card has a suit, which
* can be spades, hearts, diamonds, clubs, or joker. A spade, heart,
* diamond, or club has one of the 13 values: ace, 2, 3, 4, 5, 6, 7,
* 8, 9, 10, jack, queen, or king. Note that "ace" is considered to be
* the smallest value. A joker can also have an associated value;
* this value can be anything and can be used to keep track of several
* different jokers.
*/
public class Card {
public final static int SPADES = 0; // Codes for the 4 suits, plus Joker.
public final static int HEARTS = 1;
public final static int DIAMONDS = 2;
public final static int CLUBS = 3;
public final static int JOKER = 4;
public final static int ACE = 1; // Codes for the non-numeric cards.
public final static int JACK = 11; // Cards 2 through 10 have their
public final static int QUEEN = 12; // numerical values for their codes.
public final static int KING = 13;
/**
