Lab 6: Class Creation

You will implement a class given a description of its behavior, a partial class diagram (showing only required public methods), sample code that uses the class, and a sequence diagram that illustrates key elements of this sample code.

Your job is to complete a program that will allow a ground shipping company to do various calculations regarding shipping packages on its trucks. These calculations take into account the size and weight of the packages, the fee to ship each package (which is a function of the package's size and weight), and the capacity (in volume and weight) of each truck.

The design has been completed for you. See the class diagram for details. Another software developer has already completed a Truck class and a ShippingCalculator class that contains various static methods for testing the other classes. Your job is to implement the Package class. The class diagram shows which public methods you must implement. If needed you may implement other methods, but they must be private. Also, you will need to add some attributes, but they must also be private.

You should begin by reviewing the Truck.java source code and its documentation. Then, review the ShippingCalculator.java source code, its documentation, and the sequence diagram to see how the pieces fit together.

Create an Eclipse project by following these steps:

1. Download the file se1010lab6.zip and save it in a convenient location on your computer. (Depending on your browser, you may need to do a right click to save the file.) DO NOT save the file inside your Eclipse workspace.
2. From the File menu, select New⇒Java Project.
3. In the Project Name field, enter “Lab6” or a project name of your choice.
4. Make sure that the correct options are selected (see creatingaproject).
5. Click on Finish to create the project.
6. Right click on the project name (e.g., “Lab6”) in the Package Explorer, and select Import… from the pop-up menu.
7. In the Import dialog box, select General⇒Archive File and then click on Next.
8. In the From archive file: field, browse to the se1010lab6.zip file you previously downloaded and then click on Finish.
9. Go to the Package Explorer and open the src view.
10. Right-click on the “edu.msoe.se1010.shipping” package and select New | Class.
11. Enter “Package” as the class name and select Finish to create and begin editing the class. You will have numerous errors at this point as the imported code references methods in the Package class that you have not yet written.

• Definitions
  • Minimum billable volume = (6 in)³
  • Maximum standard density = 3 lb divided by “Minimum billable volume”

• Algorithm
  • Calculate the volume of the package.
  • For fee calculation purposes, treat smaller packages so they are billed at at least the “minimum billable volume”.
  • Calculate the base fee as US$25 per billable cubic foot.
  • Calculate the “density multiplier” as the actual package density (based on true volume, not billable volume) divided by the “maximum standard density”
  • If the “density multiplier” is greater than 1.0, calculate the actual package fee as the “base fee” times the “density multiplier”. Otherwise, the actual fee is equal to the base fee.

• Be careful of units. Some items are in inches while others are in feet.

• Do not include “magic numbers” in your code. For example, the literal constant “216” (minimum billable volume in cubic inches) should not appear in calculations. Instead, it should be defined as a class constant (final static) and referenced by name when needed. This way, if the parameters of the fee calculations ever change, only one well documented number needs to be updated in the code.

Upon implementing Package correctly, your output in the Console tab will look similar to the following. Since the second test uses a random number generator, your numbers should be similar, but will not match exactly. Note: achieving output that looks like this does not guarantee that you have implemented Package correctly.

10# box costs $38.89 to ship.
box of skis costs $62.50 to ship.
really, really dense package costs $1,041,666.67 to ship.
really, really long package costs $21,701.39 to ship.
10# box added
box of skis added
really, really dense package didn't fit
really, really long package added

A total of 4070 trucks were needed to contain 1000000 random packages that had a gross revenue of $77,198,100.37.