CMSC 203, Assignment 4

CMSC 203, Assignment 4



Concepts tested by this program
Aggregation
Passing object to method
Array Structure
Objects as elements of the Array
Processing array element
Copy Constructor
Junit test

Deliverables:
Week 1: Design
Week 2: Java files (source code)
JavaDoc Files

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

 LastNameFirstName_Assignment4.zip, a compressed file containing the following:
Javadoc doc [a directory]
file1.html (example)
file2.html (example)
src [a directory]
File1.java (example)
File2.java (example)

 LastNameFirstName_Assignment4_Moss.zip, a compressed file containing only the following:
File1.java (example)
File2.java (example)

Overview
A property management company manages personal rental properties and charges them a management fee as the percentages of the rent amount. Write an application that lets the user create a management company and add the properties managed by the company to its list. Assume the maximum properties handled by the company is 5.
Write a Data Manager Class named ManagementCompany that holds a list of properties in an array structure. This class will have methods to add a Property object to the company list, find property that has the highest rent amount, find the total rent of the properties and show the information of all the properties and the management fee earned by the management company. Follow the Javadoc file provided.

Write a Data Element Class named Property that has fields to hold the property name, the city where the property is located, the rent amount, and the owner's name, along with getters and setters to access and set these fields. Write a parameterized constructor (i.e., takes values for the fields as parameters) and a copy constructor (takes a Property object as the parameter). Follow the Javadoc file provided.

A driver class is provided that creates rental properties to test the property manager. You are also to write a Graphical User Interface using JavaFX which duplicates this driver’s functionality. You are not required to read in any data, but the GUI will allow you to enter the property management company and each property by hand.
Operation
When driver-driven application starts, a driver class (provided) creates rental properties, adds them to the property manager, and prints information about the properties using the property manager’s methods.
When the GUI-driven application starts, a window is created as in the following screen shots which allows the user to enter applicable data. The driver and the GUI will both use the same classes for their operation.
The JUnit test class also tests the same classes as the driver and the GUI.

Specifications
Data Element -Property
The class Property will contain:
1. Instance variables for property name, city, rent amount and owner. Refer to JavaDoc for the data types.
2. toString method to represent a Property object.
3. Constructors (a copy constructor and parameterized constructor) and getter and setter methods.

Data Structure – An Array of Property objects to hold the properties that the management company handles.
Data Manager – ManagementCompany, this class should not have any output functionality (e.g., no GUI-related or printing related functionality), but should take input, operate on the data structure, and return values or set variables that may be accessed with getters.
The class ManagementCompany will contain the following methods in addition to get and set methods:
1. Instance variables of name, tax Id, management fee, MAX_PROPERTY (a constant set to 5) and an array of size MAX_PROPERTY of Property objects.
2. Method managementCompany Constructor – pass in arguments for the name of the management company, tax Id and management Fee to create a ManagementCompany object.
3. Method addProperty – Pass in a parameter of type Property object. It will add the Property object to the properties array. It will return the index of the array where the property is added or -1 if the array is full.
4. Method totalRent– Returns the total rent of the properties in the properties array.
5. Method maxPropertyIndex- returns the index of the property within the properties array that has the highest rent amount. For simplicity assume that each "Property" object's rent amount is different.
6. Method displayPropertyAtIndex– pass in the index of the Property object in the properties array and return the string representation of the property.
You may need additional methods to include in this class. Follow the Javadoc files provided.

User Interface – Your graphical user interface or the provided PropertyMgmDriverNoGui.java are the only classes that interact with the user. The GUI will have the general structure of the below screen shots.

Expected output from running
PropertyMgmDriverNoGui.java
Expected output from running with GUI:
PropertyMgmGui.java at startup Add Management Co Info


Add property information Result of “Max Rent” button for a property







List of all properties when “Total Rent” is selected

 
Grading Rubric
CMSC 203 Project #4

Name _____________________________

Overview:

There are two parts to the rubric. First, the project is graded on whether it compiles, whether it runs without errors, and whether it satisfies the specifications. These points add up to 100. Second, the score is decremented if various requirements are not met, e.g., no Javadoc, no documentation, uses constructs that are not allowed, etc.


PROGRAMMING
Compiles 40 pts _____
Accuracy
Passes JUnit tests 15 pts _____ Passes private instructor tests 15 pts _____
Execution: runs without errors (either run-time or logic errors) 30 pts _____
Driver runs with results as required
GUI operates as required
Possible Sub-total 100 pts _____

REQUIREMENTS (Subtracts from Programming total)
Documentation:
Javadoc is not provided - 10 pts _____
Documentation within source code is missing or incorrect - 5 pts _____
Description of what class does is missing
Author’s Name, @author, is missing
Methods not commented properly using Javadoc @param, @return
Programming Style:
Incorrect use of indentation, statements, structures,etc. - 5 pts _____
User interface
Not clear to user how data is to be entered; GUI does not follow requirements - 15 pts _____
Output is easy to understand - 5 pts _____
Design:
Does not separate functionality (in Data Manager) from user interaction (in GUI) - 10 pts _____
Classes do not have the functionality specified - 10 pts _____

Possible decrements: -60 pts _____

Possible total grade: 100 pts _____