Assignment 1 Solution

Project Title: Shipping Store (stage 1)




Goal: The goal of this assignment is to help students familiarize themselves with the following

1Java. programming concepts:




Input/Output to and from the terminal.

Storing data in a file and reading data from a file.
Creating object-oriented classes and methods to handle data.
Using data structures to store data in main memory (e.g. ArrayList).
Working with character strings.
Using Javadoc comments and generating and html API of the program.



Description:




For this assignment you will create a program that simulates a shipping store database. The database will maintain records of the packages that are in the storage room. Your program should provide the user (shipping truck operator) with a command line choice menu about possible actions that they can perform. The choices should be the following:

Show all existing package records in the database (in any order).
Add new package record to the database.
3. Delete package record from a database.

54 Search for a package (given its tracking number).




Show a list of packages within a given weight range.

6. Exit program.




To represent a package in your program, create a class named Package with the following fields:




Tracking number (string of length 5)



Type (string)



Specification (string)



Mailing Class (string)
VolumeWeight(floating(integerpointnumber)number)–in –cubicinozinches, calculated as Width x Length x Height



 



Type: package can be one of the following types: Postcard, Letter, Envelope, Packet, Box, Crate, Drum, Roll, Tube.
Specification: Fragile, Books, Catalogs, Do-not-Bend, N/A – one per package.
Mailing class: First-Class, Priority, Retail, Ground, Metro.



When the program first loads, it reads all the saved records (if any) from a file named packages.txt into an ArrayList. While the program is running, the user can choose any of the 6 available options. When the user selects the option 6 (exit program), the program stores the current contents of the ArrayList to the file (replacing the old ones) and exits. During the program execution, if the user chooses to add or delete a package, only the ArrayList will be updated. The packages.txt file will be updated only when the program is about to exit. In other

words, when the user selects option 6, the program first saves all the contents of the ArrayList into the text file, and then exits.




The format of the contents of the packages.txt file should be in human readable plain text, one record per line. For example:




632VR Letter n/a First 1.55 6




H43SM Envelope Do-not-Bend Priority 3.0 12 83RS9 Packet Fragile Ground 55.0 24 GFR23 Box Books Retail 9500.00 45




When displaying package records, print headers and format the data to line up in columns under

the headers.

e.g.




----------------------------------------------------------------------




|TRACKING #| TYPE | SPECIFICATION | CLASS | WEIGHT | VOLUME |

----------------------------------------------------------------------




|
632VR
|
Letter
|
n/a
|
First
|
1.55
|
6
|
|
83RS9
|
Packet
|
Fragile
|
Ground
|
55.00
|
24
|
----------------------------------------------------------------------




NOTES:




This assignment can be done individually or with a partner.



You may use an IDE (BlueJ, Netbeans, etc) or just an editor and command line operations (javac, java) in Unix or Windows/DOS to develop your program.
Use good design (don’t put everything in one class).



Use a package for your classes and put your files in the appropriate directory structure.



Weight should be output in oz, showing two decimal digits: (e.g 99.95 oz).



Be sure to validate the user input.



You don't need to createcodingay GUI for this assignment. Command line operations are
Useenoughastandard. Javastyle to improve your program’s visual appearance and

make it more readable. I suggest the BlueJ coding
style: http://www.bluej.org/objects-first/styleguide.html







Use javadoc comments for all of your classes and methods.






Logistics:




Please submit your files in a single zip file (assign1_xxxxxx.zip or

assign1_xxxxxx_yyyyyy.zip). The xxxxxx and yyyyyy are your TX State NetIDs.




Submit: an electronic copy only, using the Assignments tool on the TRACS website. Submit using the TRACS account of just ONE member of your partnership. State both names in the comments.




Do NOT include executable .class or .jar files in your submission. Only .java files.