You have been employed by Vendomatic Inc. to design the Java control program for their latest vending machine. In Part II of the assignment, you will develop and test software for the Vendomatic 1000. Vendomatic 1000 is the cheapest Vendomatic product. It is designed to dispense free chilled beverages. The Vendomatic 1000 unit has a button and a dispensor. When a customer pushes the button, the unit dispenses a bottle and clears the button. If the Vendomatic 1000 is out of bottles, it prints a message that it cannot dispense a bottle and clears the button.

• Part I: Getting Started

  The button for the Vendomatic 1000 is already built (VendingButton.java and VendingButtonMain.java). Create a project Java Workshop containing these files and run and test this button. You can cut and paste, but also look at the code and try to understand what the button is doing. Ask questions in class. The button is documented using one of the standard Java documentation formats.

  • Put the class definition (blueprint) for the button VendingButton in a file named VendingButton.java:

    import java.util.*;
    import simpleIO.*;
    
    public class VendingButton extends SimpleGUI {
    
        private boolean myIamPushed; // keeps track of whether button is pushed (true) or clear (false)
        private String myName;       // name the user sees on the button
    
        /**
         * Makes a vending button with two possible choices
         * @param buttonName - is the prompt displayed with the button
         * @param firstChoice - names the first possible choice (0)
         * @param secondChoice - names the second possible choice (1)
         */  
        public VendingButton (String buttonName, String firstChoice, String secondChoice) {
            super();                // make sure the SimpleGUI constructor is called
            createMenu();           // create a menu window
            myName = new String(buttonName);  // make a new String name for the button
            addChoice(firstChoice);  // add menu option 0 with prompt firstChoice
            addChoice(secondChoice); // add menu option 1 with prompt secondChoice
            myIamPushed = false;     // button is cleared initially
        }
    
        /**
         * Returns true if button is pushed and false otherwise
         */  
        public boolean AmIPushed(){
            return myIamPushed;
        }
    
        /**
         * Returns the prompt that identifies the button on its menu
         */  
        public String GetButtonName() {
            return myName;
        }
    
        /**
         * Clears the button
         */  
        public void ClearButton() {
            myIamPushed = false;
        }
    
        /**
         * Pushes the button
         */  
        public void PushButton() {
            myIamPushed = true;
        }
    
        /**
         * Displays a pull down menu asking for two choices.  
         *    Pushes the button if the first choice is made 
         *    Clears the button if the second choice is made.
         *   
         * @return - returns whether the button was pushed (first choice) 
         *           or cleared (second choice)
         */  
        public boolean WaitForButtonPress() {
            int choice = getChoice(myName);
            if (choice == 0)
                myIamPushed = true;
            else
                myIamPushed = false;
            return myIamPushed;
        }
    }
    

  • Create the main test program VendingButtonMain as a standalone Java project called: VendingButtonMain.java:

    public class VendingButtonMain {
    
        /**
         * Constructor.
         */  
        public VendingButtonMain () {
        }
    
        public static void main(String args[]) {
            VendingButton selectionButton = new VendingButton("Make a selection",
                                                               "Clear", "Push");
            selectionButton.WaitForButtonPress();
        }
    }
    

  • After you set up the project, add more statements to VendingButtonMain in order to more completely test the button. Hand in your test program as part of your final assignment. Part I is worth 10 points. To get full credit you must perform at least 10 (reasonable) tests. Indicate what you tested.

• Part II: The Vendomatic 1000
  • To set up the skeleton for Part II, create a new project in Java WorkShop for your Vendomatic 1000 implementation. The project will have 4 files in it:
    • A main standalone program (Vendomatic1000Main.java):

      public class Vendomatic1000Main {
      
          /**
           * Constructor.
           */  
          public Vendomatic1000Main () {
          }
      
          public static void main(String args[]) {
                          // Make a vending machine holding 50 bottles of water.
              Vendomatic1000 aWaterMachine = new Vendomatic1000(50, "Water");
              aWaterMachine.Operate(); // Start the machine going
          }
      }
      

    • A file called VendingButton.java containing the class definition for VendingButton. (This is the code above that is already written for you.)
    • A file called Vendomatic1000.java containing the class definition for Vendomatic1000. (This class definition is mostly written. You will need to add a few lines of code to the Operate method of this class.)

      public class Vendomatic1000 {
          private VendingButton myAskForBeverage;     // Button to push to get beverage
          private BottleDispenser myDispenseWater;    // Dispenser to track number of bottles in the machine
      
          /**
           * Construct a vending machine that initially contains numbottles units of beverage.
           *   
           * @param numbottles - number of bottles initially in the machine.
           * @param beverage - names the beverage in the machine
           */  
          public Vendomatic1000 (int numbottles, String beverage) {
              myAskForBeverage = new VendingButton("Make a selection:",
                                                   "Push for " + beverage,
                                                   "Clear to reset machine");
              myDispenseWater = new BottleDispenser(numbottles);
          }
      
          /**
           * Wait for a selection and dispense the beverage.
           */  
          public void Operate() {
      
          }
      }
      

    • A file called BottleDispenser.java containing the class definition for BottleDispenser. This class has not been written. An empty shell is provided below for you to fill in.

      public class BottleDispenser {
      
          /**
           * Constructor - fill the dispenser with numbottles bottles 
           */ 
          public BottleDispenser(int numbottles) {
      
          }
      }
      

  • After you have added the four files to the project as described above, set up the project CLASSPATH to include simpleIO.

  • Build and run the project successfully before adding any of your own code.

  • Implement the Vendomatic 1000 as described using the skeleton you just set up in the previous step.

  • Test the program by building a number of different vending machines such as machines that start with no bottles or that dispense something other than water. (You will add statements to Vendomatic1000Main.java to do this.)

  • Hand in a printout of the source code for all of four files. Develop and write up at least 5 test scenarios for the program. A scenario specifies the state of the program, what was input, what should happen and what did happen. For example, the machine no bottles left. I pushed the button and I should get an error indication. Test the program using at least 5 different scenarios. This part is worth 20 points. To receive full credit, you must correctly implement the Vendomatic 1000 and test it with your 5 scenarios. Hand in all of your source code and your scenarios. If your program worked correctly indicate that it was working on the printout. If it was not working correctly, indicate what part you tested successfully.