Getting Started

Download CS201_Lab10_Gradle.zip. Copy and extract the zip file into your CS201-Fall2021 directory. Import it into your CS201-Fall2021 IntelliJ project using

File→New→Module from Existing Sources…

Select the CS201_Lab10_Gradle directory and in the Import Module dialog select Import module from external model→Gradle and click Finish.

You should see a project called CS201_Lab10_Gradle in the Project window.

There is no executable application for this lab. Instead, we will test the class implementation by running the unit tests by right-clicking on the file CardTest.java in the src/test/java/ directory, and then choosing

Run ‘CardTest’

Or subsequently by selecting CardTest from the dropdown list in the top right corner of the IDE and clicking the green arrow.

Your Task

Part 1 - Define a Card class

Define two enum types called Suit and Rank. The Suit enumeration should contain values for the suits clubs (lowest suit), diamonds, hearts, and spades (highest suit). The Rank enumeration should contain values for each playing card rank - two (lowest rank) through ten, jack, queen, king, then ace (highest rank).

Note: specify the members of each enumeration in order from lowest to highest. I.e., CLUBS should be the first value in Suit, and TWO should be the first value in Rank. This will make it easy to compare suit and rank values.

Define a class called Card. An instance of Card represents a playing card. It should have fields to store a Card’s suit and rank, and a constructor to initialize them. Add getter methods to get a card’s suit and rank.

Write JUnit tests to test the card class. You should create a number of Card objects with different suits and ranks, and test that the getter methods work on these objects.

Part 2 - Comparing Cards

Once you have Part 1 working, change the Card class to implement the java.lang.Comparable interface. The Card class’s compareTo method should compare first by suit, then by rank. So, a two of diamonds would compare as greater than an ace of clubs, because diamonds is a higher suit than clubs. Of course, three of diamonds would compare as greater than two of diamonds.

You will see a warning about Comparable being a raw type. Ignore this warning for now: we will see how to fix it in the next lab.

Note that enumeration types automatically implement the Comparable interface, so you can call the compareTo method on enumeration members. The comparison result will correspond to the order in which the enumeration members were defined, with earlier members comparing as less than later members.

Add some JUnit tests to test comparing Card objects using the compareTo method.

Part 3 - Sorting Cards

Finally, demonstrate that if you can compare cards, then an array of cards can be sorted using the java.util.Arrays.sort static method.

As one of the objects in your test fixture, create an array of Card objects. You can use the Card objects you’ve already created as element values. Make sure that the elements of the array are not already sorted.

Write a test method to sort the array. It should look something like this:

public void testSort() {
  Arrays.sort(myArray);

  // now verify that the elements of the array are in sorted order
  assertEquals(lowestCard, myArray[0]);
  assertEquals(secondLowestCard, myArray[1]);

  // etc...
}

Submitting

When you are done, submit the lab to the Marmoset server using the Terminal window in IntelliJ (click Terminal at the bottom left of the IDE). Navigate to the directory using

$ cd CS201_Lab10_Gradle
CS201-Fall2021/CS201_Lab10_Gradle
$ make submit

Enter your Marmoset username and password, if successful you should see

######################################################################
              >>>>>>>> Successful submission! <<<<<<<<<

Make sure that you log into the marmoset server to manually
check that the files you submitted are correct.

Details:

         Semester:   Fall 2021
         Course:     CS 201
         Assignment: lab10

######################################################################