Introduction – the SeaPort Project series

Project 2

For this set of projects for the course, we wish to simulate some of the aspects of a number of Sea Ports. Here are the classes and their instance variables we wish to define:

 SeaPortProgram extends JFrame
o variables used by the GUI interfaceo world: World

 Thing implement Comparable <Thing>o index: int

o name: String

o parent: int
 World extends Thing

o ports: ArrayList <SeaPort>

o time: PortTime SeaPort extends Thing

o docks: ArrayList <Dock>
o que: ArrayList <Ship> // the list of ships waiting to dock
o ships: ArrayList <Ship> // a list of all the ships at this port
o persons: ArrayList <Person> // people with skills at this port

 Dock extends Thingo ship: Ship

 Ship extends Thing
o arrivalTime, dockTime: PortTime
o draft, length, weight, width: doubleo jobs: ArrayList <Job>

 PassengerShip extends Ship
o numberOfOccupiedRooms: into numberOfPassengers: int
o numberOfRooms: int

 CargoShip extends Ship
o cargoValue: double

o cargoVolume: double

o cargoWeight: double Person extends Thing

o skill: String
 Job extends Thing – optional till Projects 3 and 4

o duration: double
o requirements: ArrayList <String>

// should be some of the skills of the persons PortTime

o time: int
Eventually, in Projects 3 and 4, you will be asked to show the progress of the jobs using JProgressBar’s.

1

Here’s a very quick overview of all projects:

1. Read a data file, create the internal data structure, create a GUI to display the structure, and let the user search the structure.
2. Sort the structure, use hash maps to create the structure more efficiently.
3. Create a thread for each job, cannot run until a ship has a dock, create a GUI to show theprogress of each job.
4. Simulate competing for resources (persons with particular skills) for each job.

Project 2 General Objectives

Project 2 – Map class, Comparator, sorting

•  Use the JDK Map class to write more efficient code when constructing the internal data structures from the data file.
•  Implement SORTING using the Comparator interface together with the JDK support for sorting data structures, thus sorting on different fields of the classes from Project 1.
•  Extend the GUI from Project 1 to let the user sort the data at run-time.Documentation Requirements:You should start working on a documentation file before you do anything else with these projects, and fill in items as you go along. Leaving the documentation until the project is finished is not a good idea for any number of reasons.The documentation should include the following (graded) elements:

•  Cover page (including name, date, project, your class information)
•  Design

o including a UML class diagram
o classes, variables and methods: what they mean and why they are thereo tied to the requirements of the project

 User’s Guide
o how would a user start and run your project
o any special features
o effective screen shots are welcome, but don’t overdo this

 Test Plan
o do this BEFORE you code anything
o what do you EXPECT the project to do
o justification for various data files, for example

 Lessons Learned
o express yourself here

o a way to keep good memories of successes after hard work

2

Project 2 Specific Goals:

Extend Project 1 to use advanced data structures and support sorting on various keys.

1. Required data structure – the data structure specified in Project 1:
   1. World has SeaPort’s
   2. SeaPort has Dock’s, Ship’s, and Person’s
   3. Dock has a Ship
   4. Ship has Job’s
   5. PassengerShip
   6. CargoShip
   7. Person has a skill
   8. Job requires skills – optional until Project 3
   9. PortTime
2. Use the HashMap class to support efficient linking of the classes used in Project 1.
   1. The instances of the hash map class should be local to the readFile (Scanner) method.
   2. These instances should be passed as explicit parameters to other methods used whenreading the data file.
      1. For example, the body of the methods like the following should be replaced toeffectively use a <Integer, Ship> hash map, the surrounding code needs to support this structure:Ship getShipByIndex (int x, java.util.HashMap <Integer, Ship> hms) { return hms.get(x);} // end getDockByIndex
      2. Since the body of this method has become trivial, perhaps the call to thismethod can be simply replaced by the get method of the HashMap.
      3. Your code should be sure to handle a null return from this call gracefully.
   3. The instances should be released (go out of scope, hence available for garbage collection) when the readFile method returns.
   4. Comments: The idea here, besides getting some experience with an interesting JDK Collections class, is to change the operation of searching for an item with a particular index from an O(N) operation, ie searching through the entire data structure to see if the code can find the parent index parameter, to an O(1) operation, a hash map lookup. Of course, this isn’t so very interesting in such a small program, but consider what might happen with hundreds of ports, thousands of ships, and perhaps millions of persons and jobs.
   5. Comments: Also, after the readFile operation, the indices are no longer interesting, and could be completely eliminated from the program. In this program, removing the index references could be accomplished by removing those variables from the parent class, Thing.
3. Implement comparators to support sorting:o o

o OPTIONALLY: sorting by any other field that can be comparedo The sorting should be within the parent ArrayList

4. Extend the GUI from Project 1 to allow the user to:o sort by the comparators defined above.

5. Again, the GUI elements should be distinct from the other classes in the program.

ships in port que ArrayList’s by weight, length, width, draft within their port que

all items withing their ArrayList’s by name

3

Deliverables:

1. Java source code files
2. Data files used to test your program
3. Configuration files used
4. A well-written document including the following sections:
   1. Design: including a UML class diagram showing the type of the class relationships
   2. User’s Guide: description of how to set up and run your application
   3. Test Plan: sample input and expected results, and including test data and results, withscreen snapshots of some of your test cases
   4. Optionally, Comments: design strengths and limitations, and suggestions for futureimprovement and alternative approaches
   5. Lessons Learned
   6. Use one of the following formats: MS Word docx or PDF.

Your project is due by midnight, EST, on the day of the date posted in the class schedule. We do not recommend staying up all night working on your project – it is so very easy to really mess up a project at the last minute by working when one was overly tired.

Your instructor’s policy on late projects applies to this project.

Submitted projects that show evidence of plagiarism will be handled in accordance with UMUC Policy 150.25 — Academic Dishonesty and Plagiarism.

Format:

The documentation describing and reflecting on your design and approach should be written using Microsoft Word or PDF, and should be of reasonable length. The font size should be 12 point. The page margins should be one inch. The paragraphs should be double spaced. All figures, tables, equations, and references should be properly labeled and formatted using APA style.

Coding Hints:

 Code format: (See Google Java Style guide for specifics (https://google.github.io/styleguide/javaguide.html))

o o o o o o o o

o Your program should have no warnings

header comment block, including the following information in each source code file: file name
date
author

purpose
appropriate comments within the code appropriate variable and function names correct indentation

code submitted should have no compilation or run-time errors Warnings:

 Errors:o

4

o Use the following compiler flag to show all warnings: javac -Xlint *.java

o More about setting up IDE’s to show warnings
o Generics – your code should use generic declarations appropriately, and to eliminate all

warnings Elegance:

o just the right amount of code
o effective use of existing classes in the JDK
o effective use of the class hierarchy, including features related to polymorphism.

 GUI notes:
o GUI should resize nicely

o DO NOT use the GUI editor/generators in an IDE (integrated development environment, such as Netbeans and Eclipse)

o Do use JPanel, JFrame, JTextArea, JTextField, JButton, JLabel, JScrollPane

•  panels on panels gives even more control of the display during resizing
•  JTable and/or JTree for Projects 2, 3 and 4
•  Font using the following gives a nicer display for this program, setting for theJTextArea jta:
  jta.setFont (new java.awt.Font (“Monospaced”, 0, 12));

o GridLayout and BorderLayout – FlowLayout rarely resizes nicely GridBagLayoutforextremecontroloverthedisplays
 youmaywishtoexploreotherlayoutmanagers

o ActionListener, ActionEvent – responding to JButton events
 Starting with JDK 8, lambda expression make defining listeners MUCH simpler.

See the example below, with jbr (read), jbd (display) and jbs (search) three different JButtons.
jcb is a JComboBox <String> and jtf is a JTextField.

jbr.addActionListener (e -> readFile());
jbd.addActionListener (e -> displayCave ());
jbs.addActionListener (e -> search ((String)(jcb.getSelectedItem()),

jtf.getText()));
o JFileChooser – select data file at run time

o JSplitPane – optional, but gives user even more control over display panels