Assignment 2 - Office Depot Package Delivery

CMSC 204
Assignment #2

Office Depo an office supply retailing company donates its surpluses to colleges at the end of each year. Volunteers will help deliver packages of supplies to representative of colleges (Recipient of supplies). Write an application to simulate delivering packages from the container of packages by the volunteers to recipients.
Concepts tested:
Generic Queue, co
Generic Stack,
Exception handling,
Data Elements
Volunteer- Holds the relevant information for a Volunteer: name
DonationPackage- Holds the information of the package to be donated: description, weight
Recipient- Holds the information of the recipients: name

Data Structures
1. Create a generic queue class called MyQueue to implement the queue of volunteers and recipients line. MyQueue will implement the QueueInterface given you.
2. Create a generic stack class called MyStack to place the DonationPackage on a Container. MyStack will implement the Stack Interface given you.


There will be a VolunteerLine class, a RecipientLine Class and a Container class The VolunteerLine class will implement the VolunteerLineInterface , the RecipientLine class will implement the RecipientLineInterface class and the Container class will implement the ContainerInterface class

Limit the size of each collection to 5.

Data Manager
The DonationManager class will manage adding a new package to the container, a new volunteer to the volunteer queue line , a new recipient to the recipient queue and donating package by the volunteer to the recipient. DonationManager will implement the interface DonationManager Interface.
You may add additional methods and attributes to your classes


GUI Driver

1. Initially there is no package on the container, any volunteers and recipients on the queue.
2. Allow the user to load new package to the container and add new volunteers to volunteer’s line and new recipient to recipients’ line.
3. Do not allow packages heavier than 20lbs to be added to the container.
4. Allow the user to simulate process of donating the package from the container by volunteer on the queue to the recipient on the queue. When a volunteer helps donating the package to the recipient, he/she will be back to the queue of volunteers to continue the process of donation.

5. Provide three exception classes:
a. RecipientException: If the user attempts to add new Recipient and the recipient line is full (5 recipients).
b. VolunteerException – If the user attempts to add new Volunteer and the volunteer line is full (5 volunteers).
c. ContainerException – If the user attempts to add new Donation Package and the Container line is full (5 packages).



Examples:

At startup

















After selecting “Stack New Package”
Pen(first) and Books (second).





After adding new Volunteers John (first), after adding new Recipient MC,
Nicole (second) Maryland













After selecting Donate Package After selecting Donate Package Second time
First Time














After selecting Donate Package Third time















If the user tries to add a new volunteer:















Program Grade Sheet
Assignment #2
CMSC 204

Name _______________________________________________

DOCUMENTATION
CheckList for Assignment 2 is included and completed 1 pt _____
Class documentation - Javadoc for all user created classes 4 pt _____
Class Description, @author
Method description, @param, @return
Test Cases 6 pt _____
JUnit Test Class
Implement STUDENT test for DonationManagerTest
Create a MyQueueTest and MyStackTest
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
Internal class documentation (within source code) 6 pts _____
Class description using Javadoc
Author’s Name, Class, Class Time, @author
Methods commented using Javadoc, @param, @return
Compiles and Runs without errors 6 pts _____
Program user interface
Clear to user how data is to be entered 4 pts _____
Output is easy to understand 4 pts _____
Accuracy
Received correct output
a. Public tests (given to you and those you wrote) 10 pts _____
b. Private tests 10 pts _____
Program Details
Data Structures 10 pts _____
1. Stack class for Container
2. Queue for volunteer line
3. Queue for Recipient line
Data Elements – DonationPackage, Volunteer, Recipient
1. Contains required attributes 6 pts _____
2. Contains toString any other necessary methods

Data Manager - DonationManager 10 pts _____
1. Implements DonationManager Interface
2. Creates Volunteer, Recipient, and DonationPackage objects
3. Donate Package implemented
4. Correctly handles exceptions
GUI classes: 14pts _____
1. Displays information for the volunteers, recipients and packages
Correctly as queue and stack.
2. Provides buttons for user actions

Total 100 pts _____