/*
 *    GeoTools - The Open Source Java GIS Toolkit
 *    http://geotools.org
 *
 *    (C) 2011, Open Source Geospatial Foundation (OSGeo)
 *
 *    This library is free software; you can redistribute it and/or
 *    modify it under the terms of the GNU Lesser General Public
 *    License as published by the Free Software Foundation;
 *    version 2.1 of the License.
 *
 *    This library is distributed in the hope that it will be useful,
 *    but WITHOUT ANY WARRANTY; without even the implied warranty of
 *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *    Lesser General Public License for more details.
 */

package org.geotools.swing.dialog;

import java.awt.BorderLayout;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

import javax.swing.JButton;
import javax.swing.JDialog;
import javax.swing.JFrame;
import javax.swing.JPanel;

import net.miginfocom.swing.MigLayout;

/**
 * An abstract base class for simple dialogs with a single control panel
 * (supplied by the sub-class) together with OK and Cancel buttons.
 * The sub-class must implement the {@linkplain #createControlPanel()}
 * and {@linkplain #onOK()} methods.
 *
 * @author Michael Bedward
 * @since 2.7
 *
 * @source $URL$
 * @version $Id$
 */
public abstract class AbstractSimpleDialog extends JDialog {
    private boolean initialized = false;

    /**
     * Creates a new modal, non-resizable dialog with a {@code null} parent.
     *
     * @param title dialog title
     */
    public AbstractSimpleDialog(String title) {
        this((JFrame) null, title);
    }

    /**
     * Creates a new modal, non-resizable dialog.
     *
     * @param parent parent frame
     * @param title dialog title
     */
    public AbstractSimpleDialog(JFrame parent, String title) {
        this(parent, title, true, false);
    }

    /**
     * Creates a new modal, non-resizable dialog.
     *
     * @param parent parent dialog
     * @param title dialog title
     */
    public AbstractSimpleDialog(JDialog parent, String title) {
        this(parent, title, true, false);
    }

    /**
     * Creates a new modal, non-resizable dialog.
     *
     * @param parent parent frame
     * @param title dialog title
     * @param modal whether to make the dialog application modal
     * @param resizable whether to make the dialog resizable
     */
    public AbstractSimpleDialog(JFrame parent, String title,
            boolean modal, boolean resizable) {

        super(parent, title);
        commonInit(modal, resizable);
    }

    /**
     * Creates a new modal, non-resizable dialog.
     *
     * @param parent parent dialog
     * @param title dialog title
     * @param modal whether to make the dialog application modal
     * @param resizable whether to make the dialog resizable
     */
    public AbstractSimpleDialog(JDialog parent, String title,
            boolean modal, boolean resizable) {

        super(parent, title);
        commonInit(modal, resizable);
    }

    private void commonInit(boolean modal, boolean resizable) {
        if (modal) {
            setModalityType(ModalityType.APPLICATION_MODAL);
        } else {
            setModalityType(ModalityType.MODELESS);
        }

        setResizable(resizable);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public void setVisible(boolean b) {
        if (b && !initialized) {
            throw new IllegalStateException(
                    "Sub-class did not call initComponents() before showing dialog");
        }

        super.setVisible(b);
    }

    /**
     * Creates the main control panel and components. This must be called
     * by the sub-class. We do this to give sub-classes the chance to initialize
     * fields which can be used within {@linkplain #createControlPanel()}
     * (called as part of this method).
     */
    protected void initComponents() {
        JPanel panel = new JPanel(new BorderLayout());

        panel.add(createControlPanel(), BorderLayout.CENTER);
        panel.add(createButtonPanel(), BorderLayout.SOUTH);

        add(panel);
        pack();

        initialized = true;
    }

    /**
     * Implemented by the sub-class to provide a panel with controls.
     *
     * @return panel with controls
     */
    public abstract JPanel createControlPanel();

    /**
     * Implemented by the sub-class to respond to the OK button.
     */
    public abstract void onOK();

    /**
     * Called when the cancel button is pressed. The base implementation
     * simply closes (disposes) the dialog.
     */
    public void onCancel() {
        closeDialog();
    }

    /**
     * Close the dialog using a call to {@linkplain JDialog#dispose()}.
     */
    public void closeDialog() {
        dispose();
    }

    /**
     * Creates the OK and Cancel buttons on a panel.
     *
     * @return the button panel
     */
    protected JPanel createButtonPanel() {
        JPanel panel = new JPanel(new MigLayout());

        JButton okBtn = new JButton("OK");
        okBtn.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                onOK();
            }
        });
        panel.add(okBtn, "align center");

        JButton cancelBtn = new JButton("Cancel");
        cancelBtn.addActionListener(new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                onCancel();
            }
        });
        panel.add(cancelBtn);

        return panel;
    }
}