Poker game help needed!

Question

I am a beginning Java programmer. I am trying to teach myself and found an example of code for a Java poker program when I was looking online for things to do. It uses classes/methods (which I am still learning), and consists of: Card, Deck, and Hand (and PokerHand). Help with any of the sections would be excellent!
* Card
* Member Variables:
*   INSERT DESCRIPTION OF MEMBER VARIABLES
* Private Methods:
*   INSERT DESCRIPTION OF PRIVATE METHODS (IF ANY)
* Public Methods:
*   INSERT DESCRIPTION OF PUBLIC METHODS (IF ANY)
public class Card
    // constants representing the suits
    public static final int HEARTS = 0;
    public static final int CLUBS = 1;
    public static final int DIAMONDS = 2;
    public static final int SPADES = 3;
    // constants representing the named faces
    public static final int JACK = 11;
    public static final int QUEEN = 12;
    public static final int KING = 13;
    public static final int ACE = 14;
      public static final int CARD_PER_SUIT = 13;
    // member variabes
    // INSERT MEMBER VARIABLES HERE
     * Card Constructor
     * Takes as parameters the face and suit of the card
    public Card(int face, int suit)
        // INSERT CODE HERE
     * Card Constructor
     * Takes as parameter the card number
    public Card (int cardno)
     // INSERT CODE HERE
     * toString
     * Returns a String representation of the card
    public String toString()
        // return a String that contains a text representation of the card
            // INSERT CODE HERE
     * getFace
     * Returns the card's face value
    public int getFace()
        // return the face
        // INSERT CODE HERE
     * getSuit
     * Returns the card's suit value
    public int getSuit()
        // return the suit
        // INSERT CODE HERE
     * getCardNo
     * Returns the card number
      public int getCardNo()
             // return the card number
           // INSERT CODE HERE
} // end of class Card
* Hand
* Member Variables:
*   INSERT DESCRIPTION OF MEMBER VARIABLES
* Private Methods:
*   INSERT DESCRIPTION OF PRIVATE METHODS (IF ANY)
* Public Methods:
*   INSERT DESCRIPTION OF PUBLIC METHODS (IF ANY)
public class Hand
     public static final int HANDSIZE = 5;
     public static final int HIGH_CARD = 0;
     public static final int ONE_PAIR = 1;
     public static final int TWO_PAIRS = 2;
     public static final int THREE_OF_A_KIND = 3;
     public static final int STRAIGHT = 4;
     public static final int FLUSH = 5;
     public static final int FULL_HOUSE = 6;
     public static final int FOUR_OF_A_KIND = 7;
     public static final int STRAIGHT_FLUSH = 8;
     // member variables
     // INSERT MEMBER VARIABLES HERE
     // Hand Constructor
     // INSERT DESCRIPTION OF CONSTRUCTOR HERE
     public Hand()
          // instantiate a hand of cards
          // INSERT CODE HERE
     // resets a hand and throws away all cards in the hand
     // INSERT DESCRIPTION OF METHOD HERE
     public void resetHand()
          // INSERT CODE HERE
     // accepts a card to the hand
     // INSERT DESCRIPTION OF METHOD HERE
     public void TakeCard(Card card)
          // INSERT CODE HERE
     // How many cards does the hand have?
     // INSERT DESCRIPTION OF METHOD HERE
     public int getNumCards()
          // INSERT CODE HERE
     // return the card number of a card in a hand at a specified position
     // INSERT DESCRIPTION OF METHOD HERE
     public int getCard(int cardPosition)
          // INSERT CODE HERE
     // is this hand sorted?
     // INSERT DESCRIPTION OF METHOD HERE
     public boolean isSorted()
          // INSERT CODE HERE
     // sort the cards in this hand from low to high
     // INSERT DESCRIPTION OF METHOD HERE
     public void SortHand()
          // INSERT CODE HERE
     // returns a String that represents the hand
     // INSERT DESCRIPTION OF METHOD HERE
     public String toString()
          // INSERT CODE HERE
* Deck
* Member Variables:
*   INSERT DESCRIPTION OF MEMBER VARIABLES
* Private Methods:
*   INSERT DESCRIPTION OF PRIVATE METHODS (IF ANY)
* Public Methods:
*   INSERT DESCRIPTION OF PUBLIC METHODS (IF ANY)
public class Deck
     public static final int DECKSIZE = 52;
     public static final int SHUFFLE_TIMES = 1000000;
     // member variables
     /* INSERT MEMBER VARIABLES HERE */
     * Deck Constructor
     * INSERT DESCRIPTION OF CONSTRUCTOR HERE
     public Deck()
          // instantiate the deck of cards
             /* INSERT CODE HERE */
     // shuffle the deck
     // INSERT DESCRIPTION OF METHOD HERE
     public void Shuffle(int n)
          /* INSERT CODE HERE */
     // deal a card from the deck
     // INSERT DESCRIPTION OF METHOD HERE
     Card Deal()
          // INSERT CODE HERE
     // how many cards are left in the deck?
     // INSERT DESCRIPTION OF METHOD HERE
     public int cardsLeft()
          // INSERT CODE HERE
     // INSERT DESCRIPTION OF METHOD HERE
     public String toString()
          // INSERT CODE HERE
     // INSERT DESCRIPTION OF METHOD HERE
     public void swap(int i, int j)
          // INSERT CODE HERE
public class PokerHand
     public static void main (String[] args)
          Deck deck = new Deck();
          Hand hand;
          int i;
          String str;
          hand = new Hand();
          for (i = 0; i < Hand.HANDSIZE; i++) {
               hand.TakeCard(deck.Deal());
          System.out.println("Player's hand (unsorted): ");
          System.out.println(hand.toString());
          hand.SortHand();
          System.out.println("Player's hand (sorted): ");
          System.out.println(hand.toString());
}From what I can tell in the directions provided, what it has to do is display a list of the cards, both sorted and unsorted (in order of face value). I think it will be interesting (to my limited exposure), so, as said, any help with any of the classes would be appreciated. Thank you!

Answer 1

Here's some old code - a game of Pontoon (aka BlackJack, 21 etc)
a similar structure to your poker game, you'll just have to modify the hand values
for pairs/straights etc, sorting and a few other things, but it should show you the
relationship between the objects
import java.util.*;
import java.io.*;
class Pontoon
  BufferedReader input = new BufferedReader(new InputStreamReader(System.in));
  Deck deck = new Deck();
  public Pontoon()
    try
      String playAgain = "y";
      while(playAgain.equalsIgnoreCase("y"))
        playGame();
        System.out.print("\nAnother game? (y/n): ");
        playAgain = input.readLine();
    catch(Exception e){System.out.println("error - terminating");}
    System.exit(0);
  public void playGame() throws IOException
    Hand player = new Hand();
    Hand bank = new Hand();
    String anotherCard = "y";
    player.add(deck.drawCard());
    bank.add(deck.drawCard());
    player.add(deck.drawCard());
    bank.add(deck.drawCard());
    do
      for(int x = 0; x < 20; x++) System.out.println();
      if(player.getHandValue() > 21)
        for(int x = 0; x < 20; x++) System.out.println();
        bank.showHand(0,1);
        player.showHand(0,0);
        System.out.println("\nBank wins - player busted.\n");
        break;
      else
        for(int x = 0; x < 20; x++) System.out.println();
        bank.showHand(1,1);
        player.showHand(0,0);
        System.out.print("Draw another card? (y/n): ");
        anotherCard = input.readLine();
        if(anotherCard.equalsIgnoreCase("y"))
          player.add(deck.drawCard());
        else
          for(int x = 0; x < 20; x++) System.out.println();
          bank.showHand(0,1);
          while(bank.getHandValue() < 16)
            System.out.print("\npress [ENTER] to draw another card for bank.");
            String junk = input.readLine();
            bank.add(deck.drawCard());
            for(int x = 0; x < 20; x++) System.out.println();
            bank.showHand(0,1);
          if(bank.getHandValue() > 21)
            System.out.println("\nPlayer wins - bank busted.\n");
          else
            if(player.getHandValue() > bank.getHandValue())
              System.out.println("\nPlayer wins - " + player.getHandValue() +
                                       " to " + bank.getHandValue() + ".\n");
            else if(player.getHandValue() < bank.getHandValue())
              System.out.println("\nBank wins - " + bank.getHandValue() +
                                       " to " + player.getHandValue() + ".\n");
            else
              System.out.println("\nDraw - " + player.getHandValue() +
                                       " to " + bank.getHandValue() + ".\n");
    }while(anotherCard.equalsIgnoreCase("y"));
    player = null;
    bank = null;
  public static void main(String[] args){new Pontoon();}
class Hand
  java.util.List hand = new java.util.ArrayList();
  public Hand()
  public void add(Card card)
    hand.add(card);
  public int getHandValue()
    int handValue = 0;
    for(int x = 0; x < hand.size(); x++)
      handValue += ((Card)hand.get(x)).getValue();
    return handValue;
  public void showHand(int numberOfCards, int playerOrBanker)
    String whoseHand = playerOrBanker == 0? "Player":"Bank";
    System.out.println(whoseHand + "'s hand:");
    if(numberOfCards == 1)
      System.out.println(((Card)hand.get(0)).getName() + "\n");
    else
      for(int x = 0; x < hand.size(); x++)
        System.out.println(((Card)hand.get(x)).getName());
      System.out.println("\nHand total = " + getHandValue() + "\n");
class Deck
  String[] faces = {"Ace","Two","Three","Four","Five","Six","Seven",
                         "Eight","Nine","Ten","Jack","Queen","King"};
  String[] suits = {"Hearts","Diamonds","Clubs","Spades"};
  final int DECKSIZE = 52;
  int cardsDealt;
  Card[] cards = new Card[DECKSIZE];
  java.util.List random = new java.util.ArrayList();
  public Deck()
    int value;
    for(int x = 0; x < cards.length; x++)
      value = (x % faces.length) + 1;
      if(value > 10) value = 10;
      else if(value == 1) value = 11;
      cards[x] = new Card(faces[x % faces.length],suits[x / faces.length],value);
      random.add(new Integer(x));
    shuffleDeck();
  private void shuffleDeck()
    java.util.Collections.shuffle(random);
    cardsDealt = 0;
  public Card drawCard()
    if(cardsDealt > 40) shuffleDeck();
    Card cardDrawn = cards[((Integer)random.get(cardsDealt)).intValue()];
    cardsDealt++;
    return cardDrawn;
class Card
  private String name;
  private int value;
  public Card(String pFace, String pSuit, int pValue)
    name = pFace + " of " + pSuit;
    value = pValue;
  public String getName() {return name;}
  public int getValue() {return value;}
}