Project 4

Due: Mon., April 9, 8 AM
Submit Project: Proj4
Required Files: Proj4.java
Grading Header: header.txt
Test data: testa.dat
Model Output: out.dat

Moving on with our new found skills, it's time to write a program incorporating the looping structures we've learned. Of course, we will build on old information too, incorporating into our program other structures like the if and switch statements as well as method creation and calling. There is only one file for this project, therefore the extra methods that you create must all be static methods. We will also define a few static variables. Arrays can NOT be used for this project.

Program Description

With this program you are going to keep track of the inventory of the Clipper Manufacturing Company (CMC). CMC manufactures five products:

Bicycles
Unicycles
Mopeds
Skateboards
Skates

CMC's warehouse has room for only 50 of each item. There is never a negative number of any of the products. CMC would like you to write a program to keep track of the number of each product in the warehouse. Your program should be able to display the amounts in a bar chart along with the number in the inventory for each product.

Project Specifications

Write a program that implements this inventory program.

Place all code in a file named Proj4.java.

All code must conform to the style guide in formatting and comments. Don't forget that every method must have a javadoc prologue which includes @param and @return tags if appropriate.

You should define 5 global static variables (inside the class but not inside main) which should be the number of bicycles, unicycles, mopeds, skateboards, and skates that the company has on hand. In addition there should be 1 static constant, MAXITEMS, which should be set to 50.

Within main, declare a Scanner object. There should only be one. Pass this as a parameter to the appropriate methods as needed.

The program should be a menu driven program. Within main, you should continually print a menu and get a response for what option the user would like to perform next. The menu should look like the following:

*** CMC Inventory System ***

A) Add to an item's inventory.
R) Remove from an item's inventory.
G) Graph the current items stored in the warehouse.
Q) Quit

The user should be allowed to enter a response. Don't forget to echo-print.

If the response above is 'A' or 'R', another menu should print that asks for which product's inventory is to be affected. This menu should look like:

1) Bicycle
2) Unicycle
3) Moped
4) Skateboard
5) Skates

The user should be allowed to enter a response. If this response is incorrect, (less than 1 or greater than 5), this menu should be repeated until a valid response has been entered. Again don't forget to echo-print.

Then the program should call upon the proper method to do what has been asked. (Use a switch statement here.) (The first three responses should each have an individual method that carries on the appropriate activity.) So if the user enters:

A - Add to the inventory amount of one of the products. This command should call upon a method that takes the item number and the Scanner object as parameters. It should ask for the amount to add. Enter it and echo-print it. If the amount entered will cause the inventory to exceed 50, an error message should print and the user should be returned to the main menu. You will need to switch on the item number, and then add to the appropriate item's current inventory total if the total does not exceed 50.
R - Remove from the inventory of one of the products. This command should call upon a method that takes the item number and the Scanner object as parameters. It should then ask for the amount to remove. Enter it and echo-print it. If the amount entered will cause the inventory to go below zero, an error message should print and the user should be returned to the menu. Again you will need to switch on the item number and then subtract from the appropriate item's current inventory total as long as the result is not less than zero.
G - Graph the number of all the products by using a bar graph. Display the numbers of all the products in a list along with a bar chart which prints a star (*) for each item in inventory. (You should use a for loop here and switch on the loop counter variable for each different item.) Of course the bar charts will be created using a for loop as well.
Q - Quit the program.

Output Specifications

A program run might look like the following (don't forget to echo-print all input):


*** CMC Inventory System ***

A) Add to an item's inventory.
R) Remove from an item's inventory.
G) Graph current items stored in warehouse.
Q) Quit.

Enter choice: a
a

1) Bicycle
2) Unicycle
3) Moped
4) Skateboard
5) Skates

Choose an item number: 1
1

Enter quantity to add to inventory: 20
20

*** CMC Inventory System ***

A) Add to an item's inventory.
R) Remove from an item's inventory.
G) Graph current items stored in warehouse.
Q) Quit.

Enter choice: a
a

1) Bicycle
2) Unicycle
3) Moped
4) Skateboard
5) Skates

Choose an item number: 3
3

Enter quantity to add to inventory: 10
10

*** CMC Inventory System ***

A) Add to an item's inventory.
R) Remove from an item's inventory.
G) Graph current items stored in warehouse.
Q) Quit.

Enter choice: a
a

1) Bicycle
2) Unicycle
3) Moped
4) Skateboard
5) Skates

Choose an item number: 1
1

Enter quantity to add to inventory: 40
40
*** ERROR: maximum items exceeded ***

*** CMC Inventory System ***

A) Add to an item's inventory.
R) Remove from an item's inventory.
G) Graph current items stored in warehouse.
Q) Quit.

Enter choice: r
r

1) Bicycle
2) Unicycle
3) Moped
4) Skateboard
5) Skates

Choose an item number: 3
3

Enter quantity to remove from inventory: 15
15
*** ERROR: Cannot remove that many items ***

*** CMC Inventory System ***

A) Add to an item's inventory.
R) Remove from an item's inventory.
G) Graph current items stored in warehouse.
Q) Quit.

Enter choice: G
G

Item         Number     Chart
Bicycle      20         ********************
Unicycle     0
Moped        10         **********
Skateboard   0
Skates       0


*** CMC Inventory System ***

A) Add to an item's inventory.
R) Remove from an item's inventory.
G) Graph current items stored in warehouse.
Q) Quit.

Enter choice: A
A

1) Bicycle
2) Unicycle
3) Moped
4) Skateboard
5) skates

Choose an item number: 6
6

Illegal item number entered.
Please try again.

1) Bicycle
2) Unicycle
3) Moped
4) Skateboard
5) skates

Choose an item number: 5
5

Enter quantity to add to inventory: 10
10

*** CMC Inventory System ***

A) Add to an item's inventory.
R) Remove from an item's inventory.
G) Graph current items stored in warehouse.
Q) Quit.

Enter choice: P

An illegal option has been entered.
Please try again.

*** CMC Inventory System ***

A) Add to an item's inventory.
R) Remove from an item's inventory.
G) Graph current items stored in warehouse.
Q) Quit.

Enter choice: Q
Q

Thank you for using the Inventory Control System.

Specifications for Documentation and Format

With the help of the Style Guide in your Lab manual, fully document your code following the javadoc conventions for prologues and include:

A class prologue at the top of your program file. The @author tag must contain your name, your e-mail address, your W&M phone extension. The prologue must also contain a full description of the project.
Each method must have a prologue written in javadoc with appropriate @return and @param tags.
All variables must be commented (DO NOT use javadoc for these).
Each closing brace must be commented, eg:
```
} // main
```
Make sure your lines are not too long. If they are going to cause a line-wrap problem, then break them someplace in the middle and continue the statement on the next line.
Correct formatting requires that the code must be reasonably and consistently indented.
Horizontal and vertical white space must be used reasonably and consistently.

Program Testing and Submission

Information needed for testing this program are linked from the top of the page. Test your program thoroughly with the data and sample output given before submitting.

Submit your program file electronically: In Eclipse, right click on the project and import the files from /home/f85/debbie/cs141/Proj4. Right click on the file submit.xml and select Run -> 1 Ant Build; Messages will appear in the Console window. Be sure to determine whether you got the Build successful message to ensure that your electronic file submission for this lab was successful.

Honor Code. The honor code applies to all programming done in this course. Reread the CS Department's document: Programming Assignments and the Honor Code.

Debbie Noonan, debbie@cs.wm.edu
March 20, 2007