]> git.mxchange.org Git - addressbook-lib.git/blobdiff - Addressbook/src/org/mxchange/addressbook/client/gui/AddressbookFrame.java
Added a lot trace messages + sanity checks for null references and such things
[addressbook-lib.git] / Addressbook / src / org / mxchange / addressbook / client / gui / AddressbookFrame.java
index fdc59e1e990e50d7e1e4b377e3e83552f1011e7a..4a7a9c8a85e5abd99c433d576a4d409788f4a70a 100644 (file)
@@ -46,6 +46,7 @@ import javax.swing.table.TableModel;
 import org.mxchange.addressbook.BaseFrameworkSystem;
 import org.mxchange.addressbook.application.AddressbookApplication;
 import org.mxchange.addressbook.client.Client;
+import org.mxchange.addressbook.contact.Contact;
 import org.mxchange.addressbook.contact.Gender;
 import org.mxchange.addressbook.exceptions.FrameAlreadyInitializedException;
 import org.mxchange.addressbook.model.contact.ContactTableModel;
@@ -113,6 +114,11 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
         */
        private boolean isInitialized;
 
+       /**
+        * Layout instance
+        */
+       private GridLayout layout;
+
        /**
         * Status label needs to be updated
         */
@@ -125,14 +131,41 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
         */
        private AddressbookFrame (final Client client) {
                // Debug line
-               this.getLogger().trace(MessageFormat.format("client={0}: CALLED!", client));
+               this.getLogger().trace(MessageFormat.format("client={0}: CALLED!", client)); //NOI18N
 
                // Set frame instance
                this.frame = new JFrame();
-               this.frame.setTitle(this.generateFrameTitle("main"));
+               this.frame.setTitle(this.generateFrameTitle("main")); //NOI18N
 
                // Set client here
                this.setClient(client);
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
+       }
+
+       @Override
+       public Contact doEnterOwnData () {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
+               // Is the "add contact" window visible?
+               if (this.addContact.isVisible()) {
+                       // Something bad happened
+                       throw new IllegalStateException("Window addContact is already visible.");
+               }
+
+               // Disable main window
+               this.frame.setEnabled(false);
+
+               // Make other window visible
+               this.addContact.setVisible(true);
+
+               // Trace message
+               this.getLogger().trace("Returning null : EXIT!"); //NOI18N
+
+               // Return value is not supported
+               return null;
        }
 
        /**
@@ -140,8 +173,33 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
         */
        @Override
        public void doShutdown () {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
                // First only show shutdown status
-               this.updateStatus("shutdown");
+               this.updateStatus("shutdown"); //NOI18N
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
+       }
+
+
+       /**
+        * Enables main window (frame)
+        */
+       @Override
+       public void enableMainWindow () {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
+               // Enable it again
+               this.frame.setEnabled(true);
+
+               // Request focus for this window
+               this.frame.requestFocus();
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
@@ -152,12 +210,12 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
        @Override
        public void setupFrame (final Client client) {
                // Debug line
-               this.getLogger().trace(MessageFormat.format("client={0}: CALLED!", client));
+               this.getLogger().trace(MessageFormat.format("client={0}: CALLED!", client)); //NOI18N
 
                // Has the user entered own data?
                if (this.getClient().getContactManager().isOwnContactAdded()) {
                        // Debug message
-                       this.getLogger().debug("Disabling menus: isOwnContactAdded()=false");
+                       this.getLogger().debug("Disabling menus: isOwnContactAdded()=false"); //NOI18N
 
                        // Not entered yet, so disable "add" menu
                        this.addOwnItem.setEnabled(false);
@@ -170,7 +228,10 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
                this.frame.setVisible(true);
 
                // All done here
-               this.updateStatus("done");
+               this.updateStatus("done"); //NOI18N
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
@@ -185,7 +246,7 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
        @Override
        public void init () throws FrameAlreadyInitializedException {
                // Debug line
-               this.getLogger().trace("CALLED!");
+               this.getLogger().trace("CALLED!"); //NOI18N
 
                // Has this frame been initialized?
                if (this.isInitialized()) {
@@ -198,6 +259,9 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
 
                // Set flag
                this.isInitialized = true;
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
@@ -216,29 +280,38 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
         */
        @Override
        public void shutdownApplication () {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
                // To do this, the frame must be initialized
                if (!this.isInitialized()) {
                        // Not initalized, so bad call
-                       this.getLogger().fatal("Bad call of shutdownApplication(). Please report this.");
+                       this.getLogger().fatal("Bad call of shutdownApplication(). Please report this."); //NOI18N
                        return;
                }
+
+               // Call shutdown method
                this.getClient().getApplication().doShutdown();
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
         * Generates a title for borders
+        *
         * @param key Key part to look for
         * @return Human-readable title
         */
        private String generateBorderTitle (final String key) {
                // Call bundle instance
-               return this.getBundle().getString(String.format("AddressbookFrame.border.%s.title.text", key));
+               return this.getBundle().getString(String.format("AddressbookFrame.border.%s.title.text", key)); //NOI18N
        }
 
        /**
         * Generates a title for all frames based on given sub title key. If null is
         * given, the sub title is not generated.
-        * 
+        *
         * @param subKey Key for sub title resource
         * @return A full application title
         */
@@ -249,21 +322,32 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
                // Is key given?
                if (subKey != null) {
                        // Add sub title
-                       title = String.format("%s - %s", title, this.getBundle().getString(String.format("AddressbookFrame.%s.title.text", subKey)));
+                       title = String.format("%s - %s", title, this.getBundle().getString(String.format("AddressbookFrame.%s.title.text", subKey))); //NOI18N
                }
 
                // Return it
                return title;
        }
 
+       /**
+        * Initializes "add" and "cancel" buttons
+        */
+       private void initAddCancelButtons () {
+       }
+
        /**
         * Initializes "add contact" dialog
         */
        private void initAddContactDialog () {
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
+
                // Instance dialog and set title
                this.addContact = new JDialog();
-               this.addContact.setTitle(this.generateFrameTitle("dialog.addContact"));
-               this.addContact.setLayout(new GridLayout(4, 1));
+               this.addContact.setTitle(this.generateFrameTitle("dialog.addContact")); //NOI18N
+
+               // Set layout
+               this.addContact.setLayout(new GridLayout(0, 1, 2, 2));
 
                // Only hide it on close and make it appear in middle of screen
                this.addContact.setDefaultCloseOperation(JFrame.HIDE_ON_CLOSE);
@@ -274,7 +358,10 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
                this.addContact.setAutoRequestFocus(true);
 
                // Initial dimension
-               this.addContact.setSize(500, 400);
+               this.addContact.setSize(500, 500);
+
+               // And it is not resizeable
+               this.addContact.setResizable(false);
 
                /*
                 * Add listener which asks for confirmation, if data has been entered
@@ -282,33 +369,66 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
                 *
                 * @TODO Unfinished
                 */
+               this.addContact.addWindowListener(new WindowAdapter() {
+                       /**
+                        * Invoked when a window has been closed.
+                        */
+                       @Override
+                       public void windowClosed (final WindowEvent e) {
+                               // Enable main window again
+                               AddressbookFrame.getSelfInstance(null).enableMainWindow();
+                       }
+
+                       /**
+                        * Invoked when a window is in the process of being closed. The
+                        * close operation can be overridden at this point.
+                        */
+                       @Override
+                       public void windowClosing (final WindowEvent e) {
+                               e.getWindow().dispose();
+                       }
+               });
 
                // Init 3 panels:
                // 1) "name" panel
-               initNamePanel();
+               initNameDataPanel(this.addContact);
 
                // 2) "address" panel
-               initAddressPanel();
+               initAddressDataPanel(this.addContact);
+
+               // 3) "other" panel
+               initOtherDataPanel(this.addContact);
+
+               // 4) "Add" and "Cancel" buttons
+               initAddCancelButtons();
 
                // x)Only for developing:
                /* DEBUG: */ this.addContact.setVisible(true);
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
         * Initializes address panel
+        *
+        * @param dialog A JDialog instance to this components to
         */
-       private void initAddressPanel () {
+       private void initAddressDataPanel (final JDialog dialog) {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
                // Panel "address" input boxes
                JPanel addressPanel = new JPanel();
                addressPanel.setLayout(new BoxLayout(addressPanel, BoxLayout.Y_AXIS));
-               
+
                // Set border to titled version
-               addressPanel.setBorder(new TitledBorder(this.generateBorderTitle("address")));
+               addressPanel.setBorder(new TitledBorder(this.generateBorderTitle("address"))); //NOI18N
 
                // Init all elements:
                // 1) Street and number together
                JPanel streetNumberPanel = new JPanel();
-               streetNumberPanel.setLayout(new GridLayout(1, 4));
+               streetNumberPanel.setLayout(new GridLayout(1, 4, 5, 5));
 
                // Label for street
                JLabel streetLabel = new JLabel(this.getBundle().getString("AddressbookFrame.street.text"));
@@ -333,7 +453,7 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
 
                        /**
                         * Method to verify that the entered data is a number.
-                        * 
+                        *
                         * @param input Input to verify
                         * @return Whether the data is a number
                         */
@@ -367,7 +487,7 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
 
                // 2) ZIP code and ccity name
                JPanel zipCityPanel = new JPanel();
-               zipCityPanel.setLayout(new GridLayout(1, 4));
+               zipCityPanel.setLayout(new GridLayout(1, 4, 5, 5));
 
                // Label for ZIP code, again numbers only
                JLabel zipLabel = new JLabel(this.getBundle().getString("AddressbookFrame.zip.text"));
@@ -381,7 +501,7 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
 
                        /**
                         * Method to verify that the entered data is a number.
-                        * 
+                        *
                         * @param input Input to verify
                         * @return Whether the data is a number
                         */
@@ -425,7 +545,10 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
                addressPanel.add(zipCityPanel);
 
                // Add panel to dialog
-               this.addContact.add(addressPanel);
+               dialog.add(addressPanel);
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
@@ -433,7 +556,7 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
         */
        private void initComponents () {
                // Debug line
-               this.getLogger().trace("CALLED!");
+               this.getLogger().trace("CALLED!"); //NOI18N
 
                // Set default close operation
                this.frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
@@ -480,21 +603,27 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
 
                // Init other windows
                initOtherDialogs();
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
         * Initializes the menu system
         */
        private void initMenuSystem () {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
                // Init menu bar, menu and item instances
                JMenuBar menuBar = new JMenuBar();
                JMenu menu;
                JMenuItem item;
-               
+
                // Init some menus:
                // 1) File menu
                menu = new JMenu(this.getBundle().getString("AddressbookFrame.menu.file.text"));
-               
+
                // Add menu items:
                // 1.x) Exit program (should be last)
                item = new JMenuItem(this.getBundle().getString("AddressbookFrame.menuItem.exitProgram.text"));
@@ -518,7 +647,7 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
 
                // Add menu -> menu bar
                menuBar.add(menu);
-               
+
                // Init some menus:
                // 2) Addressbook menu
                menu = new JMenu(this.getBundle().getString("AddressbookFrame.menu.addressbook.text"));
@@ -568,29 +697,37 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
 
                // Add menu bar -> frame
                this.frame.add(menuBar, BorderLayout.NORTH);
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
         * Initializes name panel
+        *
+        * @param dialog A JDialog instance to this components to
         */
-       private void initNamePanel () {
+       private void initNameDataPanel (final JDialog dialog) {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
                // Panel "name" input boxes
                JPanel namePanel = new JPanel();
                namePanel.setLayout(new BoxLayout(namePanel, BoxLayout.Y_AXIS));
 
                // Set border to titled version
-               namePanel.setBorder(new TitledBorder(this.generateBorderTitle("name")));
+               namePanel.setBorder(new TitledBorder(this.generateBorderTitle("name"))); //NOI18N
 
                // Panel for gender
                JPanel gPanel = new JPanel();
-               gPanel.setLayout(new GridLayout(1, 2));
-               
+               gPanel.setLayout(new GridLayout(1, 2, 5, 5));
+
                // Gender text field
                JLabel gLabel = new JLabel(this.getBundle().getString("AddressbookFrame.gender.text"));
-               
+
                // Get all genders
                Gender[] genders = Gender.values();
-               
+
                // Init gender combo box with tool tip
                JComboBox<Gender> gender = new JComboBox<>(new DefaultComboBoxModel<>(genders));
                gender.setToolTipText(this.getBundle().getString("AddressbookFrame.gender.tooltipText"));
@@ -604,7 +741,7 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
 
                // Panel for surname
                JPanel sPanel = new JPanel();
-               sPanel.setLayout(new GridLayout(1, 2));
+               sPanel.setLayout(new GridLayout(1, 2, 5, 5));
 
                // New label for surname is not needed
                JLabel sLabel = new JLabel(this.getBundle().getString("AddressbookFrame.surname.text"));
@@ -639,25 +776,61 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
                namePanel.add(fPanel);
 
                // Finally add panel to dialog
-               this.addContact.add(namePanel);
+               dialog.add(namePanel);
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
+       }
+
+       /**
+        * Initializes "other" data panel
+        *
+        * @param dialog A JDialog instance to this components to
+        * @todo Fill this with life
+        */
+       private void initOtherDataPanel (final JDialog dialog) {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
+               // Panel "other" input boxes
+               JPanel otherPanel = new JPanel();
+               otherPanel.setLayout(new BoxLayout(otherPanel, BoxLayout.Y_AXIS));
+
+               // Set border to titled version
+               otherPanel.setBorder(new TitledBorder(this.generateBorderTitle("other"))); //NOI18N
+
+               // Finally add panel to dialog
+               dialog.add(otherPanel);
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
         * Initialize other dialogs (e.g. "Add contact")
         */
        private void initOtherDialogs () {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
                // Init other windows:
                // 1) Add contact
                initAddContactDialog();
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
         * Initializes status panel
         */
        private void initStatusPanel () {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
                // Init status label (which needs to be updated
                this.statusLabel = new JLabel();
-               this.updateStatus("initializing");
+               this.updateStatus("initializing"); //NOI18N
 
                // Init status bar in south
                JPanel panel = new JPanel();
@@ -667,12 +840,18 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
 
                // Add panel to frame
                this.frame.add(panel, BorderLayout.SOUTH);
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
         * Initializes the table which will show all contacts
         */
        private void initTable () {
+               // Trace message
+               this.getLogger().trace("CALLED!"); //NOI18N
+
                // Instance table model
                this.dataModel = new ContactTableModel(this.getClient());
 
@@ -688,7 +867,7 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
                         */
                        @Override
                        public void mouseClicked (final MouseEvent e) {
-                               throw new UnsupportedOperationException("Unfinished.");
+                               throw new UnsupportedOperationException("Unfinished."); //NOI18N
                        }
                });
 
@@ -702,6 +881,9 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
 
                // Add pane to frame
                this.frame.add(scroller, BorderLayout.CENTER);
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 
        /**
@@ -710,7 +892,13 @@ public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame
         * @param type Status type
         */
        private void updateStatus (final String type) {
+               // Trace message
+               this.getLogger().trace(MessageFormat.format("type={0} - CALLED!", type)); //NOI18N
+
                // Set status message
-               this.statusLabel.setText(this.getBundle().getString(String.format("AddressbookFrame.statusLabel.%s.text", type)));
+               this.statusLabel.setText(this.getBundle().getString(String.format("AddressbookFrame.statusLabel.%s.text", type))); //NOI18N
+
+               // Trace message
+               this.getLogger().trace("EXIT!"); //NOI18N
        }
 }