Project 4
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:
Project 4 General Objectives
Project 4 – Concurrency
ï‚· Resource pools
o Threads competing for multiple resources
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 4 Specific Goals:
Extend project 3 to include making jobs wait until people with the resources required by the job are available at the port.
Elaboration:
o Resources in pools – how many people with skill are currently available
o Thread progress, resources acquired, and resources requests still outstanding
Deliverables:
3
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
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
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
 Font using the following gives a nicer display for this program, setting for the JTextArea 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