]> git.mxchange.org Git - addressbook-lib.git/blobdiff - Addressbook/src/org/mxchange/addressbook/client/gui/AddressbookFrame.java
Moved default close operation into init method to keep constructors small
[addressbook-lib.git] / Addressbook / src / org / mxchange / addressbook / client / gui / AddressbookFrame.java
index 451d52503e4e22f30bfca99fd27b6639897dc03d..679684641897d4b3963daf725b13775f1612de93 100644 (file)
  */
 package org.mxchange.addressbook.client.gui;
 
-import java.awt.Color;
-import java.awt.Cursor;
+import java.awt.BorderLayout;
 import java.awt.event.ActionEvent;
 import java.awt.event.ActionListener;
-import java.awt.event.InputEvent;
-import java.awt.event.KeyEvent;
 import java.awt.event.WindowAdapter;
 import java.awt.event.WindowEvent;
-import java.util.ResourceBundle;
+import java.text.MessageFormat;
 import javax.swing.BorderFactory;
 import javax.swing.BoxLayout;
-import javax.swing.GroupLayout;
+import javax.swing.JFrame;
 import javax.swing.JLabel;
 import javax.swing.JMenu;
 import javax.swing.JMenuBar;
 import javax.swing.JMenuItem;
 import javax.swing.JPanel;
-import javax.swing.JScrollPane;
-import javax.swing.JTable;
-import javax.swing.JToolBar;
-import javax.swing.KeyStroke;
-import javax.swing.LayoutStyle;
-import javax.swing.ListSelectionModel;
-import javax.swing.SwingConstants;
-import javax.swing.UIManager;
-import javax.swing.WindowConstants;
-import org.apache.logging.log4j.LogManager;
-import org.apache.logging.log4j.Logger;
+import org.mxchange.addressbook.BaseFrameworkSystem;
+import org.mxchange.addressbook.FrameAlreadyInitializedException;
 import org.mxchange.addressbook.application.AddressbookApplication;
-import org.mxchange.addressbook.application.Application;
 import org.mxchange.addressbook.client.Client;
-import org.mxchange.addressbook.manager.contact.ManageableContact;
-import org.mxchange.addressbook.model.address.AddressTableModel;
 
 /**
  *
  * @author Roland Haeder
  */
-public class AddressbookFrame extends javax.swing.JFrame implements ClientFrame {
+public class AddressbookFrame extends BaseFrameworkSystem implements ClientFrame {
+
     /**
-     * Class' logger
+     * Own instance
      */
-    private final Logger LOG;
+    private static ClientFrame self;
 
     /**
-     * Client instance
+     * Singelton getter for this frame instance.
+     *
+     * @param client Client instance
+     * @return Returns a singelton instance of this frame
      */
-    private final Client client;
+    public static final ClientFrame getSelfInstance (final Client client) {
+       // Is it set?
+       if (!(self instanceof ClientFrame)) {
+           // Create new instance
+           self = new AddressbookFrame(client);
+       }
+       
+       // Return instance
+       return self;
+    }
 
     /**
-     * Own instance
+     * Frame instance
      */
-    private static ClientFrame self;
+    private final JFrame frame;
 
     /**
-     * Bundle instance
+     * Whether this frame has been initialized
      */
-    private final ResourceBundle bundle;
+    private boolean isInitialized;
 
     /**
-     * Initialize object
+     * Status label needs to be updated
      */
-    {
-       LOG = LogManager.getLogger(this);
-       bundle = ResourceBundle.getBundle("org/mxchange/addressbook/localization/bundle"); // NOI18N
-    }
+    private JLabel statusLabel;
 
     /**
      * Creates an instance of this frame with a client instance
-     * @param client 
+     * 
+     * @param client
      */
     private AddressbookFrame (final Client client) {
        // Debug line
-       this.getLogger().debug("Initializing Swing frame ...");
+       this.getLogger().trace(MessageFormat.format("client={0}: CALLED!", client));
 
-       // Set client here
-       this.client = client;
-    }
+       // Set frame instance
+       this.frame = new JFrame(AddressbookApplication.printableTitle());
 
-    @Override
-    public Application getApplication () {
-       throw new UnsupportedOperationException("Not implemented.");
-    }
-
-    @Override
-    public final Client getClient () {
-       return this.client;
-    }
-
-    @Override
-    public ManageableContact getContactManager () {
-       throw new UnsupportedOperationException("Not implemented.");
-    }
-
-    @Override
-    public void initFrame () {
-       // Init components
-       this.initComponents();
+       // Set client here
+       this.setClient(client);
     }
 
     /**
-     * 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.
+     * Shutdown this frame
      */
-    @SuppressWarnings ("unchecked")
-    // <editor-fold defaultstate="collapsed" desc="Generated Code">//GEN-BEGIN:initComponents
-    private void initComponents() {
-
-        statusPanel = new JPanel();
-        statusLabel = new JLabel();
-        listAddressesPanel = new JScrollPane();
-        addressesTable = new JTable();
-        toolBar = new JToolBar();
-        menuBar = new JMenuBar();
-        mainMenu = new JMenu();
-        exitProgram = new JMenuItem();
-        addressbookMenu = new JMenu();
-        addOwnData = new JMenuItem();
-
-        setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE);
-        setTitle(AddressbookApplication.printableTitle());
-        setCursor(new Cursor(Cursor.DEFAULT_CURSOR));
-        setName("main"); // NOI18N
-        addWindowListener(new WindowAdapter() {
-            public void windowClosed(WindowEvent evt) {
-                exitProgram(evt);
-            }
-            public void windowClosing(WindowEvent evt) {
-                AddressbookFrame.this.windowClosing(evt);
-            }
-        });
-
-        statusPanel.setBorder(BorderFactory.createEtchedBorder(Color.lightGray, new Color(153, 153, 153)));
-        statusPanel.setAutoscrolls(true);
-        statusPanel.setCursor(new Cursor(Cursor.DEFAULT_CURSOR));
-        statusPanel.setFocusable(false);
-        statusPanel.setName("status"); // NOI18N
-        statusPanel.setLayout(new BoxLayout(statusPanel, BoxLayout.X_AXIS));
-
-        ResourceBundle bundle = ResourceBundle.getBundle("org/mxchange/addressbook/localization/bundle"); // NOI18N
-        statusLabel.setText(bundle.getString("AddressbookFrame.statusLabel.text_1")); // NOI18N
-        statusLabel.setHorizontalTextPosition(SwingConstants.LEFT);
-        statusLabel.setName("statusLabel"); // NOI18N
-        statusPanel.add(statusLabel);
-
-        listAddressesPanel.setName("listAddressesPanel"); // NOI18N
-
-        addressesTable.setModel(new AddressTableModel(this.getClient()));
-        addressesTable.setColumnSelectionAllowed(true);
-        addressesTable.setFillsViewportHeight(true);
-        addressesTable.setFocusable(false);
-        addressesTable.setName("addressesTable"); // NOI18N
-        listAddressesPanel.setViewportView(addressesTable);
-        addressesTable.getColumnModel().getSelectionModel().setSelectionMode(ListSelectionModel.SINGLE_INTERVAL_SELECTION);
-
-        toolBar.setFloatable(false);
-        toolBar.setRollover(true);
-        toolBar.setName("toolBar"); // NOI18N
-
-        menuBar.setName("menuBar"); // NOI18N
-
-        ResourceBundle bundle1 = ResourceBundle.getBundle("org/mxchange/addressbook/client/gui/Bundle"); // NOI18N
-        mainMenu.setText(bundle1.getString("AddressbookFrame.text")); // NOI18N
-        mainMenu.setFocusable(false);
-        mainMenu.setName(""); // NOI18N
-
-        exitProgram.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_X, InputEvent.ALT_MASK));
-        exitProgram.setText(bundle.getString("AddressbookFrame.exitProgram.text_1")); // NOI18N
-        exitProgram.setName("exitProgram"); // NOI18N
-        exitProgram.addActionListener(new ActionListener() {
-            public void actionPerformed(ActionEvent evt) {
-                exitProgramActionPerformed(evt);
-            }
-        });
-        mainMenu.add(exitProgram);
-
-        menuBar.add(mainMenu);
-
-        addressbookMenu.setText(bundle.getString("AddressbookFrame.addressbookMenu.text_1")); // NOI18N
-        addressbookMenu.setName("addressbookMenu"); // NOI18N
-
-        addOwnData.setText(bundle1.getString("AddressbookFrame.addOwn.text")); // NOI18N
-        addOwnData.setName("addOwn"); // NOI18N
-        addOwnData.addActionListener(new ActionListener() {
-            public void actionPerformed(ActionEvent evt) {
-                addOwnDataActionPerformed(evt);
-            }
-        });
-        addressbookMenu.add(addOwnData);
-        addOwnData.getAccessibleContext().setAccessibleName(bundle.getString("AddressbookFrame.addOwnData.AccessibleContext.accessibleName_1")); // NOI18N
-
-        menuBar.add(addressbookMenu);
-
-        setJMenuBar(menuBar);
-
-        GroupLayout layout = new GroupLayout(getContentPane());
-        getContentPane().setLayout(layout);
-        layout.setHorizontalGroup(layout.createParallelGroup(GroupLayout.Alignment.LEADING)
-            .addComponent(statusPanel, GroupLayout.DEFAULT_SIZE, GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
-            .addComponent(listAddressesPanel, GroupLayout.DEFAULT_SIZE, 700, Short.MAX_VALUE)
-            .addComponent(toolBar, GroupLayout.DEFAULT_SIZE, GroupLayout.DEFAULT_SIZE, Short.MAX_VALUE)
-        );
-        layout.setVerticalGroup(layout.createParallelGroup(GroupLayout.Alignment.LEADING)
-            .addGroup(GroupLayout.Alignment.TRAILING, layout.createSequentialGroup()
-                .addComponent(toolBar, GroupLayout.PREFERRED_SIZE, 25, GroupLayout.PREFERRED_SIZE)
-                .addPreferredGap(LayoutStyle.ComponentPlacement.RELATED)
-                .addComponent(listAddressesPanel, GroupLayout.PREFERRED_SIZE, GroupLayout.DEFAULT_SIZE, GroupLayout.PREFERRED_SIZE)
-                .addGap(1, 1, 1)
-                .addComponent(statusPanel, GroupLayout.PREFERRED_SIZE, 23, GroupLayout.PREFERRED_SIZE))
-        );
-
-        statusPanel.getAccessibleContext().setAccessibleName(bundle1.getString("AddressbookFrame.status.AccessibleContext.accessibleName")); // NOI18N
-        statusPanel.getAccessibleContext().setAccessibleDescription(bundle1.getString("AddressbookFrame.status.AccessibleContext.accessibleDescription")); // NOI18N
-
-        pack();
-    }// </editor-fold>//GEN-END:initComponents
-
-    private void exitProgramActionPerformed(ActionEvent evt) {//GEN-FIRST:event_exitProgramActionPerformed
-        // Close application instance
-       dispose();
-    }//GEN-LAST:event_exitProgramActionPerformed
-
-    private void addOwnDataActionPerformed(ActionEvent evt) {//GEN-FIRST:event_addOwnDataActionPerformed
-        // Asks the user to enter own data
-       this.getClient().getContactManager().doEnterOwnData();
-    }//GEN-LAST:event_addOwnDataActionPerformed
-
-    private void windowClosing(WindowEvent evt) {//GEN-FIRST:event_windowClosing
-        // TODO add your handling code here:
-       dispose();
-    }//GEN-LAST:event_windowClosing
-
-    private void exitProgram(WindowEvent evt) {//GEN-FIRST:event_exitProgram
-        // TODO add your handling code here:
-       this.getClient().getApplication().doShutdown();
-    }//GEN-LAST:event_exitProgram
+    @Override
+    public void doShutdown () {
+       // First only show shutdown status
+       this.statusLabel.setText(this.getBundle().getString("AddressbookFrame.statusLabel.shutdown.text"));
+    }
 
     /**
-     * Setups the frame
+     * Setups the frame, do not set isInitialized here
      * 
      * @param client Client instance
      */
     @Override
     public void setupFrame (final Client client) {
+       // Debug line
+       this.getLogger().trace(MessageFormat.format("client={0}: CALLED!", client));
+
        // Has the user entered own data?
        if (this.getClient().getContactManager().isOwnContactAdded()) {
            // Debug message
            this.getLogger().debug("Disabling menus: isOwnContactAdded()=false");
 
            // Not entered yet, so enable menu
-           addOwnData.setEnabled(false);
+           //addOwnData.setEnabled(false);
        }
 
-       /*
-        * Set the Nimbus look and feel
-        */
-       //<editor-fold defaultstate="collapsed" desc=" Look and feel setting code (optional) ">
-       /*
-        * If Nimbus (introduced in Java SE 6) is not available, stay with the
-        * default look and feel. For details see
-        * http://download.oracle.com/javase/tutorial/uiswing/lookandfeel/plaf.html
-        */
-       try {
-           for (UIManager.LookAndFeelInfo info : javax.swing.UIManager.getInstalledLookAndFeels()) {
-               if ("Nimbus".equals(info.getName())) {
-                   UIManager.setLookAndFeel(info.getClassName());
-                   break;
-               }
-           }
-       } catch (final ClassNotFoundException ex) {
-           this.getLogger().catching(ex);
-       } catch (final InstantiationException ex) {
-           this.getLogger().catching(ex);
-       } catch (final IllegalAccessException ex) {
-           this.getLogger().catching(ex);
-       } catch (final javax.swing.UnsupportedLookAndFeelException ex) {
-           this.getLogger().catching(ex);
-       }
-        //</editor-fold>
+       // Make the frame visible
+       this.frame.setVisible(true);
 
        // All done here
-       statusLabel.setText(bundle.getString("AddressbookFrame.status.done.text"));
+       this.statusLabel.setText(this.getBundle().getString("AddressbookFrame.statusLabel.done.text"));
+    }
 
+    /**
+     * Initalizes this frame. Having initComponents() exposed (publicly
+     * accessible) means that any other object can initialize components which
+     * you may not want.
+     * 
+     * @throws org.mxchange.addressbook.FrameAlreadyInitializedException If this method has been called twice
+     */
+    @Override
+    public void initFrame () throws FrameAlreadyInitializedException {
        // Debug line
-       this.getLogger().debug("Displaying form ...");
+       this.getLogger().trace("CALLED!");
 
-       /*
-        * Create and display the form
-        */
-       java.awt.EventQueue.invokeLater(new Runnable() {
-           @Override
-           public void run () {
-               AddressbookFrame.getSelfInstance(client).setVisible(true);
-           }
-       });
+       // Has this frame been initialized?
+       if (this.isInitialized()) {
+           // Throw exception
+           throw new FrameAlreadyInitializedException();
+       }
+
+       // Init components
+       this.initComponents();
+
+       // Set flag
+       this.isInitialized = true;
     }
 
     /**
-     * Singelton getter for this frame instance.
+     * Returns field isInitialized. This flag indicates whether this frame has been initialized or not.
      * 
-     * @param client Client instance
-     * @return Returns a singelton instance of this frame
+     * @return Field isInitialized
      */
-    public static final ClientFrame getSelfInstance (final Client client) {
-       // Is it set?
-       if (!(self instanceof ClientFrame)) {
-           // Create new instance
-           self = new AddressbookFrame(client);
-       }
-    
-       // Return instance
-       return self;
+    @Override
+    public final boolean isInitialized () {
+       return this.isInitialized;
     }
 
     /**
-     * Getter for logger
-     *
-     * @return Logger
+     * Initialize components
      */
-    protected final Logger getLogger () {
-       return this.LOG;
+    private void initComponents () {
+       // Debug line
+       this.getLogger().trace("CALLED!");
+
+       // Set default close operation
+       this.frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
+
+       // Register shutdown listener
+       this.frame.addWindowListener(new WindowAdapter() {
+           /**
+            * Invoked when a window has been closed.
+            */
+           @Override
+           public void windowClosed(final WindowEvent e) {
+               // Shutdown application cleanly
+               self.getClient().getApplication().doShutdown();
+           }
+
+           /**
+            * 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) {
+               // Also shutdown cleanly here
+               self.getClient().getApplication().doShutdown();
+           }
+       });
+
+       // Setup layout manager
+       this.frame.setLayout(new BorderLayout(2, 2));
+
+       // Set window size
+       this.frame.setSize(700, 400);
+
+       // Center window in middle of screen, instead of top-left corner
+       this.frame.setLocationRelativeTo(null);
+
+       // 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"));
+       item.setToolTipText(this.getBundle().getString("AddressbookFrame.menuItem.exitProgram.toolTipText"));
+
+       // Add listener to exit menu
+       item.addActionListener(new ActionListener() {
+           /**
+            * If the user has performed this action
+            *
+            * @param e An instance of an ActionEvent class
+            */
+           @Override
+           public void actionPerformed (final ActionEvent e) {
+               self.getClient().getApplication().doShutdown();
+           }
+       });
+
+       // Add item -> menu
+       menu.add(item);
+
+       // Add menu -> menu bar
+       menuBar.add(menu);
+
+       // Add menu bar -> frame
+       this.frame.add(menuBar, BorderLayout.NORTH);
+
+       // Init status label (which needs to be updated
+       this.statusLabel = new JLabel(this.getBundle().getString("AddressbookFrame.statusLabel.initializing.text"));
+
+       // Init status bar in south
+       JPanel panel = new JPanel();
+       panel.setLayout(new BoxLayout(panel, BoxLayout.X_AXIS));
+       panel.add(this.statusLabel);
+       panel.setBorder(BorderFactory.createEtchedBorder());
+
+       // Add panel to frame
+       this.frame.add(panel, BorderLayout.SOUTH);
     }
 
-    // Variables declaration - do not modify//GEN-BEGIN:variables
-    private JMenuItem addOwnData;
-    private JMenu addressbookMenu;
-    private JTable addressesTable;
-    private JMenuItem exitProgram;
-    private JScrollPane listAddressesPanel;
-    private JMenu mainMenu;
-    private JMenuBar menuBar;
-    private JLabel statusLabel;
-    private JPanel statusPanel;
-    private JToolBar toolBar;
-    // End of variables declaration//GEN-END:variables
 }