Java Notes

GUI-Model Rainfall program

This is an example serves two purposes, based on the very simple problem of recording rainfall statistics.

  1. Show an example of separating the GUI from the model.
  2. Show an example of a GUI generated by the NetBeans 5.0beta2 GUI editor. A complete, running, GUI program is built automatically, and it's only necessary to edit in a few things (instance variable for the model, and the contents of a method to handle the button click.

    Highlighting indicates sections of my code.

    I've written some notes about how this code is structured at NetBeans GUI Editor

window image

GUI class

I'm sorry about the long lines that won't show up on a portrait page, but this is what NetBeans generated.

  1 
  2 
  3 
  4 
  5 
  6 
  7 
  8 
  9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 
 18 
 19 
 20 
 21 
 22 
 23 
 24 
 25 
 26 
 27 
 28 
 29 
 30 
 31 
 32 
 33 
 34 
 35 
 36 
 37 
 38 
 39 
 40 
 41 
 42 
 43 
 44 
 45 
 46 
 47 
 48 
 49 
 50 
 51 
 52 
 53 
 54 
 55 
 56 
 57 
 58 
 59 
 60 
 61 
 62 
 63 
 64 
 65 
 66 
 67 
 68 
 69 
 70 
 71 
 72 
 73 
 74 
 75 
 76 
 77 
 78 
 79 
 80 
 81 
 82 
 83 
 84 
 85 
 86 
 87 
 88 
 89 
 90 
 91 
 92 
 93 
 94 
 95 
 96 
 97 
 98 
 99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
// RainfallGUI.java - Provides a GUI interface to the RainfallStats class.
// Fred Swartz - Nov 29, 2005
// This was generated by NetBeans 5.0 beta2 GUI editor, and a few 
//      additions were made to provide the "data binding" code.

public class RainfallGUI extends javax.swing.JFrame {
    
    //================================================ my instance variables
    private RainfallStats _rainLogic;  // Keeps data, calculates statistics.    //Note 1
    
    /** Creates new form RainfallGUI */
    public RainfallGUI() {
        _rainLogic = new RainfallStats(500);  // Initialize for 500 data points. //Note 2
        initComponents();
    }
    
    /** This method is called from within the constructor to
     * initialize the form.
     * WARNING: Do NOT modify this code. The content of this method is
     * always regenerated by the Form Editor.
     */
    // <editor-fold defaultstate="collapsed" desc=" Generated Code ">                          
    private void initComponents() {
        jLabel1 = new javax.swing.JLabel();
        jScrollPane1 = new javax.swing.JScrollPane();
        rainfallDataTA = new javax.swing.JTextArea();
        calcStatsBtn = new javax.swing.JButton();
        jLabel2 = new javax.swing.JLabel();
        jLabel3 = new javax.swing.JLabel();
        jLabel4 = new javax.swing.JLabel();
        averageTF = new javax.swing.JTextField();
        numberTF = new javax.swing.JTextField();
        totalTF = new javax.swing.JTextField();

        setDefaultCloseOperation(javax.swing.WindowConstants.EXIT_ON_CLOSE);
        setTitle("Rain Statistics");
        jLabel1.setText("Enter rainfall measurements separated by spaces");

        rainfallDataTA.setColumns(20);
        rainfallDataTA.setRows(5);
        jScrollPane1.setViewportView(rainfallDataTA);

        calcStatsBtn.setText("Calculate Statistics");
        calcStatsBtn.addActionListener(new java.awt.event.ActionListener() {
            public void actionPerformed(java.awt.event.ActionEvent evt) {
                calcStatsBtnActionPerformed(evt);
            }
        });

        jLabel2.setText("Total");

        jLabel3.setText("Number");

        jLabel4.setText("Average");

        org.jdesktop.layout.GroupLayout layout = new org.jdesktop.layout.GroupLayout(getContentPane());
        getContentPane().setLayout(layout);
        layout.setHorizontalGroup(
            layout.createParallelGroup(org.jdesktop.layout.GroupLayout.LEADING)
            .add(org.jdesktop.layout.GroupLayout.LEADING, layout.createSequentialGroup()
                .addContainerGap()
                .add(layout.createParallelGroup(org.jdesktop.layout.GroupLayout.LEADING)
                    .add(jScrollPane1, org.jdesktop.layout.GroupLayout.PREFERRED_SIZE, 249, org.jdesktop.layout.GroupLayout.PREFERRED_SIZE)
                    .add(jLabel1)
                    .add(org.jdesktop.layout.GroupLayout.LEADING, layout.createSequentialGroup()
                        .add(layout.createParallelGroup(org.jdesktop.layout.GroupLayout.LEADING)
                            .add(jLabel4)
                            .add(jLabel3)
                            .add(jLabel2))
                        .addPreferredGap(org.jdesktop.layout.LayoutStyle.RELATED)
                        .add(layout.createParallelGroup(org.jdesktop.layout.GroupLayout.LEADING, false)
                            .add(averageTF)
                            .add(totalTF)
                            .add(org.jdesktop.layout.GroupLayout.TRAILING, numberTF, org.jdesktop.layout.GroupLayout.DEFAULT_SIZE, 69, Short.MAX_VALUE)))
                    .add(calcStatsBtn))
                .addContainerGap(org.jdesktop.layout.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE))
        );
        layout.setVerticalGroup(
            layout.createParallelGroup(org.jdesktop.layout.GroupLayout.LEADING)
            .add(org.jdesktop.layout.GroupLayout.LEADING, layout.createSequentialGroup()
                .addContainerGap()
                .add(jLabel1)
                .addPreferredGap(org.jdesktop.layout.LayoutStyle.RELATED)
                .add(jScrollPane1, org.jdesktop.layout.GroupLayout.PREFERRED_SIZE, 81, org.jdesktop.layout.GroupLayout.PREFERRED_SIZE)
                .addPreferredGap(org.jdesktop.layout.LayoutStyle.RELATED)
                .add(calcStatsBtn)
                .addPreferredGap(org.jdesktop.layout.LayoutStyle.RELATED)
                .add(layout.createParallelGroup(org.jdesktop.layout.GroupLayout.BASELINE)
                    .add(jLabel2)
                    .add(totalTF, org.jdesktop.layout.GroupLayout.PREFERRED_SIZE, org.jdesktop.layout.GroupLayout.DEFAULT_SIZE, org.jdesktop.layout.GroupLayout.PREFERRED_SIZE))
                .addPreferredGap(org.jdesktop.layout.LayoutStyle.RELATED)
                .add(layout.createParallelGroup(org.jdesktop.layout.GroupLayout.BASELINE)
                    .add(jLabel3)
                    .add(numberTF, org.jdesktop.layout.GroupLayout.PREFERRED_SIZE, org.jdesktop.layout.GroupLayout.DEFAULT_SIZE, org.jdesktop.layout.GroupLayout.PREFERRED_SIZE))
                .addPreferredGap(org.jdesktop.layout.LayoutStyle.RELATED)
                .add(layout.createParallelGroup(org.jdesktop.layout.GroupLayout.BASELINE)
                    .add(jLabel4)
                    .add(averageTF, org.jdesktop.layout.GroupLayout.PREFERRED_SIZE, org.jdesktop.layout.GroupLayout.DEFAULT_SIZE, org.jdesktop.layout.GroupLayout.PREFERRED_SIZE))
                .addContainerGap(org.jdesktop.layout.GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE))
        );
        pack();
    }// </editor-fold>                        

    private void calcStatsBtnActionPerformed(java.awt.event.ActionEvent evt) {                                             
        String oneDataString = "";  // Defined outside try so catch can use it. //Note 3
        try {
            //... Start a new set of values.
            _rainLogic.clear();
            
            //... Get data values as strings.
            String inputData = rainfallDataTA.getText().trim();
            String[] inputStrings = inputData.split("\\s++");
            
            //... Loop over each value, convert it, add to stats.
            for (int i = 0; i < inputStrings.length; i++) {
                oneDataString = inputStrings[i];
                double data = Double.parseDouble(oneDataString);
                _rainLogic.add(data);
            }
            
            //... Update the display.
            totalTF.setText("" + _rainLogic.getTotal());
            numberTF.setText("" + _rainLogic.getNumber());
            averageTF.setText("" + _rainLogic.getAverage());
            
        } catch (NumberFormatException unused) {
            //... Come here if there was a conversion error.
            javax.swing.JOptionPane.showMessageDialog(this, 
                                          "Bad input value: " + oneDataString);
            totalTF.setText("");
            numberTF.setText("");
            averageTF.setText("");
        }
    }                                            
    
    /**
     * @param args the command line arguments
     */
    public static void main(String args[]) {
        java.awt.EventQueue.invokeLater(new Runnable() {
            public void run() {
                new RainfallGUI().setVisible(true);
            }
        });
    }
    
    // Variables declaration - do not modify                     
    private javax.swing.JTextField averageTF;
    private javax.swing.JButton calcStatsBtn;
    private javax.swing.JLabel jLabel1;
    private javax.swing.JLabel jLabel2;
    private javax.swing.JLabel jLabel3;
    private javax.swing.JLabel jLabel4;
    private javax.swing.JScrollPane jScrollPane1;
    private javax.swing.JTextField numberTF;
    private javax.swing.JTextArea rainfallDataTA;
    private javax.swing.JTextField totalTF;
    // End of variables declaration                   
    
}

Notes

  1. _rainLogic is the instance variable that allows the user interface to get to the model.
  2. You can add your own initializations to the constructor, as I did here.
  3. This "handler" is called by the button listener, and all the code it was written by me. This is the code that interfaces with the model (_rainLogic).

Model class

This class contains no user interface code. The user interface knows about it, but this code doesn't know who's using it. It would be just as easy to use this code with a console, dialog, GUI, or web-based interface.

  1 
  2 
  3 
  4 
  5 
  6 
  7 
  8 
  9 
 10 
 11 
 12 
 13 
 14 
 15 
 16 
 17 
 18 
 19 
 20 
 21 
 22 
 23 
 24 
 25 
 26 
 27 
 28 
 29 
 30 
 31 
 32 
 33 
 34 
 35 
 36 
 37 
 38 
 39 
 40 
 41 
 42 
 43 
 44 
 45 
 46 
 47 
 48 
 49 
 50 
 51 
 52 
 53 
 54 
 55 
// RainfallStats - Class for keeping the rainfall statistics.
// Fred Swartz - Nov 29, 2005
// Questions:
//   * How could this be modified to keep a running total?
//   * Is it reasonable to have getAverage call getNumber 
//     instead of using _numberOfDataPoints directly?
//   * What happens if there are no data points and getAverage
//     is called?  What should happen?

public class RainfallStats {
    
    //============================================== instance variables
    private double[] _rainMeasurements;
    private int      _numberOfDataPoints;
    
    //===================================================== constructor
    public RainfallStats(int maxSize) {
        _rainMeasurements = new double[maxSize];
        _numberOfDataPoints = 0;
    }
    
    // Adds a data point to the rain data.
    public void add(double rain) {
        _rainMeasurements[_numberOfDataPoints] = rain;
        _numberOfDataPoints++;
    }
    
    //======================================================= getNumber
    // Return number of data points.
    public int getNumber() {
        return _numberOfDataPoints;
    }
    
    //======================================================== getTotal
    // Returns total rainfall.
    public double getTotal() {
        double total = 0.0;
        for (int i = 0; i < _numberOfDataPoints; i++) {
            total += _rainMeasurements[i];
        }
        return total;
    }
    
    //====================================================== getAverage
    // Returns average rainfall
    public double getAverage() {
        return getTotal() / getNumber();   // Divide by zero bug.
    }
    
    //=========================================================== clear
    // Get rid of all data.
    public void clear() {
        _numberOfDataPoints = 0;
    }
}