Lab 8: Class/Static Variables
CS 141: Introduction to Programming , Fall 2017

Chapter 8 contains a number of important concepts about classes and objects which can be confusing such as static variables & methods and deep copying. In this lab, you will have the opportunity to practice some of these concepts.

You will also have more practice building Graphical User Interfaces (GUIs) in Netbeans.

Part 1: Card Class

• Create a new Netbeans project containing a main class. Copy your Card class from the BlackJack game and place it in the new project. Netbeans should ask you if you want to refactor the code (say yes) to insure that the package name is correct.

  Add to the Card class the following items:

  • A setIndex() method for the card index member variable if you don't already have one.

  • A copy constructor. A copy constructor takes a parameter which is of the same type as the object being created (in this case a Card). In the constructor you are to set the index to the index of the Card parameter.

    Note on Deep Copying: Objects can be complex in that they can contain many other objects and arrays. The contained objects can, in turn, contain other objects - it can get complicated! When you set an object equal to another, e.g.

    Card c1 = new Card();
    Card c2 = c1;

    You are not making a new copy of the first object (c1 in this case), but rather creating a second reference to the first object. A deep copy insures that when you copy an object, you are actually making a new copy of an object and its subobjects, and not just creating new references. This is the idea behind deep copying. When doing deep copying, it is very useful if all of your classes have a copy constructor because it will make it easier and safer to do deep copying.

    Note: Another way of implementing copying is to implement a clone method (See p. 479 of your text.) )

  • A static (class) variable, called numberOfCards initialized to zero, and which will keep track of the total number of Card objects whcih have been created. You will need to modify each of your constructors so they update numberOfCards each time a Card object is created.

  • A getter and setter for numberOfCards. These two methods should also be static.

• Unit testing: In main(), create at least 3 Card objects each one using a different constructor: the no parameter constructor which generates a random card, the constructor which takes an integer and uses it to initialize the card index, and the copy constructor which takes one of the previous cards and creates a new card which has the same index. Each time you createa new card, print it out along with the number of cards that have been created so far, e.g.

  
  Card c1 = new Card();    // randomly pick a card
  System.out.println("Card c1: " + c1 + ", number of cards = " + Card.getNumberOfCards());
  Card c2 = new Card(2);   // set card to the 2 of Spades
  System.out.println("Card c2: " + c2 + ", number of cards = " + Card.getNumberOfCards());
  Card c3 = new Card(c2);  // makes a copy of c2
  System.out.println("Card c3: " + c3 + ", number of cards = " + Card.getNumberOfCards());
  

  Note, to get the number of cards, we reference the class

  Card.getNumberOfCards()

  rather than the object,

  c1.getNumberOfCards()

  although using the object would have worked. Can you explain what is going on?

  Once the above is working, change the index of c2 using your setIndex() method, and then print out both c2 and c3 to make sure they are now different.

  The total output should now look something like:

  
  Card c1: 9♣, number of cards = 1
  Card c2: 2♠, number of cards = 2
  Card c3: 2♠, number of cards = 3
  Changing c3 to index 3
  Card c2: 2♠, number of cards = 3
  Card c3: 3♠, number of cards = 3
  

Part 2: Building a GUI

Creating a GUI: The purpose of this part of the lab is to introduce you to several more GUI components: TextAreas, ScrollPanes, and ComboBoxes.

• Your goal is to create a GUI that looks something like this:

  

  When you click the "Add a Card" button, it will add a card to the combobox and print the card to the output area. The "Print Cards" button prints out to the text area all the cards chosen so far. The clear button removes all cards added.

• Begin by adding a JFrame form (e.g. call it CardJFrame) to your existing Netbeans project which already contains your Card class. In order for Netbeans to use the correct main method when the program is run, right click on the project name (in the projects window), select properties, click on the Run category, and click the Browse button to the right of the Main Class textfield. Select your JFrame class. If you did this correctly, the JFrame window should appear when you build and run your program.

• Next, lay out your components as shown here.

  

  You have already worked with buttons and labels. Here, you will also add a ComboBox and a ScrollPane/TextArea. Don't forget to rename your components : for example
  addButton, outputTextArea, listButton, cardComboBox, titleLabel, etc

  Renaming your components makes it easier to read and write the code. The renaming can be done in the Navigator window. The instructions below will use these names.

• In the Design tab, select your cardComboBox. In the properties, click the "..." next to the model property. Remove item 1, item 2, .... When you first compile and run the code, there should not be anything in the drop down menu.

• In the Design tab, right-click your addButton and select Events->Action->actionPerformed. Netbeans will take you to the part of the code responsible for responding to clicking this button (i.e. the button's event handler). Add code that will 1) create a new random Card, 2) add its String name to the combobox, and 3) print the added card to the text area. To add an item to the combo box you want to use the addItem method: cardComboBox.addItem(card.toString()). Each time you add a card, you also want to print it out in the text area. Note, to add text to a TextArea without clearing the existing text, you call outputTextArea.append("my_text") . If you want to clear the existing text in a TextArea, you call outputTextArea.setText("") .

• Now, as you click the addButton, cards will be added to the combo box. Each time a card is added, it is also printed in the text area, as shown here:

  

• Add an actionPerformed event handler to the clearButton. In the code, add instructions to clear the outputTextArea and also to remove the items from the cardComboBox. To remove all of the items, you want to call cardComboBox.removeAllItems().

• Add an actionPerformed to the listButton which loops over the items in the combo box and prints them all to the output area (see first picture above).

• (Optional) If you complete the above tasks early, think about how you could use a similar interface to run your blackjack program.

Deliverables

To receive full credit, you need to:

1. Make sure that your Java code:

   • Is well commented, including at the top of each file, your name, lab name, program name, date, brief description of what the class does.
   • Is well formatted, i.e. proper indentation and line returns.

2. Demonstrate both Card programs (i.e. Parts 1 and Part 2) to the instructor or lab assistant during the lab on the due date.

3. Submit only the code for Part 2 to Wise as attachments to Lab 8:

   • Include your JFrame java file and your Card java file.