Assignment 5 BASKETBALL TEAM ROSTER GENERATOR

CMSC203 Assignment 5

 

Concepts tested by this program

            Static variable and methods

            Multiple classes (Enumeration/Data Element/Data Structure/Data Manager/JavaFX driver)

            Class relationationships – Dependancy and Aggregation

            Enumerated Types

            ArrayLists

            JUnit Tests

            GUI:

Displaying Images

TextAreas

            Panes and Component Layout

            Borders (bordered radio group) use .setStyle

            Using the .setStyle for font size and color

 

Deliverables:

Java files - The src folder with your driver (javafx application), enumerated class, data element, data manager and Junit Test (.java) files

Javadoc files - The doc folder with your javadoc for student generated files

UML Class Diagram (an image, not the proprietary format, must be a .jpg)

 

Deliverable format: The above deliverables will be packaged as follows. Two compressed files in the following formats:

LastNameFirstName_AssignmentX_Complete.zip [a compressed file containing the following]

                        UML.jpg

Assignment 5 Checklist (filled in with YES or NO or ?)

                        doc [a directory] please include the entire doc folder with the javadoc for student

generated files

                                    file1.html (example)

                                    file2.html (example)

                        src [a directory] contains your driver (javafx application), enumerated class, data

element, data manager and Junit Test (.java) files

                                    File1.java (example)

                                    File2.java (example)

                                    File_Test.java (example)

LastNameFirstName_AssignmentX_Moss.zip [a compressed file containing only the following]

contains .java file which includes the driver (javafx application), enumerated

class, data element, data manager and Junit Test (.java) files – NO FOLDERS!!

                        File1.java (example)

                        File2.java (example)

 
 

BASKETBALL TEAM ROSTER GENERATOR

 

At the start of a basketball game, each coach writes out their players’ names on the scoresheet and gives it to the score-keeper. When a player enters the game, the scorekeeper must keep track of who is in the game. Your task is to write a GUI-driven program to enter the starting roster and positions of a basketball team.  Each team will include 2 forwards, 1 center and 2 guards. 

Notes:

1.      Your program ONLY records the starting team, not the entire team.

2.      Your program will also note each player’s position (although actual scorekeepers do not do this).

3.      Your program will not be required to keep track of the teams or players when the program goes on to the next team (the program would need to be extended to be useful to actual scorekeepers).

4.      Your program will be GUI-driven, not command-line.

5.      Your program will display an image of a basketball on the GUI.

Operation
The user will start the application by selecting New Team.  The user will then type in the Team’s name in the Team Name textbox.

The user will enter the first and last name of the team member and then indicate which position the member will play.  The user then selects the Add Player button.

If the position selected is already filled (1 center, or 2 forwards or guards), an error message is displayed.

When the user selects the Print Team button, the names of the team will be displayed with their position in the Team Roster textArea.

When the user selects the New Team button, the team name field becomes available for user to type in team name.

When the user closes the frame or presses the Exit button, the application exits.

 
Specifications
Enumerated Class - Position

Create an enumerated type called Position.  The valid values will be “GUARD”, “CENTER”, “FORWARD”. 

Data Element – Player class

Create a Player class.  It will contain instance variables of type String for the first name and last name.  It will contain an instance variable of type Position for the position.  Provide a constructor and a toString method.  Add any additional methods as required.

Data Manager – Team class

Create a Team class.  It will contain an ArrayList of Player Objects.  It will have a static variable that keeps track of the number of players that have been added to the team and a static method that returns the value of this variable.  Provide a constructor and a method to addPlayer, a method to printTeam and a toString method.  The addPlayer method will check that there is only 1 center, 2 forwards and 2 guards at a time and will check that there are no more than 5 members of the team.  The addPlayer method will return a String indicating what the error is (i.e. “There is already a center on this team”) or a null if the player was added.  Make sure your class names and method names and parameters match the Javadoc that I provided for this class, or the JUnit test will not run correctly.

GUI driver – JavaFX

Provide events/event handling for the following buttons:

Ø  addPlayer – extract first and last name from textboxes, determine which position, call the addPlayer method from the Team class

Ø  printTeam – call the printTeam method of the Team class and display results in the text area

Ø  clear – clear the first and last name and any error messages, do not clear the team name, don’t change the position

Ø  newTeam – make the teamName textbox editable.  Clear the team name, first name and last name fields and the text area for the team roster.  When the user types in the team name and hits enter, the teamName textbox becomes uneditable again and if the addPlayer, clear and printTeam buttons are disabled, enable them at this time (see event handling for teamName field).

Ø  exit – exit the application

Provide event handling for the following textboxes:

Ø  teamName – Extract the team name entered by user, create a new Team object with this team name, and make the teamName textbox uneditable. If the addPlayer, clear and printTeam buttons are disabled, enable them at this time. (Be aware that the user must press Enter after typing in the team name, for the event to be triggered)

Use Panes and Component Layout to organize your GUI (VBox and HBox, etc)

The teamName textbox is initially set to uneditable (.setEditable(false))

Use a border around the radio buttons box for Position (use .setStyle)

Display the basketball image at top of the panel. 

Use an instance variable of type Team.  Use the addPlayer and printTeam methods of the Team class. 

Display an error message at the bottom of the screen when there is an error. 

If the New Team button is selected, make the teamName textbox editable, after the user types in the team name, make the teamName textbox uneditable again.

 



Print Error messages here
 


Print Team Roster here
 


Select to add this player at this position
 


Team name
 


Player position
 


Player name
 
 

 

 

 

 

 

 



 
 
 
 
 
 
 
 
 
 

 

 

 

 

 


 



 
 
 
 
 

 
 

 
 




 

 

 

 

 

 

 



 
 

 

 

 


 

 


Documentation
Javadoc:

A set of html documents generated using Javadoc tags. 

Comments in source code:

      In addition to the documentation comments which are used by javadoc,  include in-line comments as needed to further explain your code

Testing
Your code should compile and run without errors.

You should test your GUI by manually selecting various sets of buttons and text entries.

JUnit Tests:

Check your program by running the JUnit tests found in BasketballTeamTest.java

Add STUDENT test(s) for the Team class in BasketballTeamTest.java.

Create a JUnit test for your Player class.

Include your updated version of BasketballTeamTest.java in your submission.

Program Grade Sheet Assignment #5

 

Name ________________________________          Submittal Date/Time ­­­­­­­­­­­­­­________________________

 

DOCUMENTATION                                                                                    Total 25 points

CheckList for Assignment 5 is included and completed                                            1 pt  _____

Class Documentation – Javadoc for all student generated classes                             10  pt  ____

            Class description, @author

            Method description, @param, @return                                                                                 

JUnit Test Classes                                                                                                       5  pt  _____

            Implement the Student test methods of BasketballTeamTest

                        Create a test for the Player class

UML Diagram                                                                                                            4 pt  _____

Lessons Learned                                                                                                         5  pt _____

In 3+ paragraphs, highlight your lessons learned and learning experience from working on this project.  How did you do?  What have you learned?  What did you struggle with? How will you approach your next project differently?

  

 

PROGRAMMING                                                                                         Total 75 points

     Internal class Javadoc documentation (within source code)                                 5 pts _____

            Description of what each class does                                                                 

            Author’s Name, @author                                                        

            Methods commented properly using Javadoc documents                                           

Description                                                                                

@param, @return                                                                     

     Compiles and Runs without runtime errors or warnings                                       10 pts  _____

    

     Accuracy                                                                                                   

            Public tests – JUnit test given to you                                                               6 pts  _____

            Your JUnit Tests – added to BasketballTeamTest and PlayerTest                  4 pts   _____

            Private tests – other tests run by the instructor                                               10 pts _____

    

     Program Details

            Data Element – Player class                                                                              7 pts _____

1.      Contains instance variable of type Position    

2.      Contains constructor and toString methods

3.      Contains getters and setters for instance variables

Data Manager – Team Class (use javadoc provided)                                      12 pts _____

1.      Contains at least one static variable and static method

2.      Contains methods to addPlayer, printTeam, etc

3.      Contains an ArrayList of Player object references

Enumerated Type – Position                                                                              5 pts   _____

1.      Enumerated type Position is created with enumerated values

GUI – JavaFX application                                                                              10 pts    _____

1.      Provide events/event handling for the following buttons:

addPlayer, printTeam, clear, newTeam, exit

2.      Provide event handling for the following textboxes: teamName

3.      Use Panes and Component Layout to organize your GUI (VBox and HBox, etc)

4.      The teamName textbox is initially set to uneditable (.setEditable(false))

5.      Use a border around the radio buttons box for Position (use .setStyle)

6.      Display the basketball image at top of the panel. 

7.      Use an instance variable of type Team.  Use the addPlayer and printTeam

methods of the Team class. 

8.      Display an error message at the bottom of the screen when there is an error. 

9.      If the New Team button is selected, make the teamName textbox editable,

after the user types in the team name, make the teamName textbox uneditable again.

10.  Program user interface                                                                        3 pt _____

          Clear to user how data is to be entered                                                     

          Output is easy to understand                                                                     

11.  Data Validations/Output formats                                                       3 pt ___

Program should only accept valid inputs

invalid data must be detected, warn user and then ignored. 

Program should not crash due to bad inputs.

Total                                                                                                                            100 pts   _____

 

Player
- firstName : String

- lastName : String

- playerPosition: Position
+ Player (first, last : String, pos: Position)

+ Player (info : Customer)

+ getFirstName () : String

+ getLastName () : String

+ getPosition() : String

+ toString () : String
 

 

Team
- teamName : String

- numPlayers : int

- numCenters : int

- numForwards: int

- numGuards: int

- currentPlayer: ArrayList<Player
+ Team (tm : String)

+ addPlayer(fName, lName, pos : String)

+ printTeam () : String

+ toString () : String
 

 

 

 

 

 

Diamond pointing up

<enumeration

Position
GUARD

FORWARD

CENTER
+ Position (pos : String)

+ getName() : String

+ toString () : String