/*
 * This file is part of muCommander, http://www.mucommander.com
 * Copyright (C) 2002-2016 Maxence Bernard
 *
 * muCommander is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 3 of the License, or
 * (at your option) any later version.
 *
 * muCommander 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */


package com.mucommander.ui.dialog.server;

import com.mucommander.commons.file.FileURL;
import com.mucommander.ui.layout.XAlignedComponentPanel;
import com.mucommander.ui.main.MainFrame;

import javax.swing.*;
import javax.swing.event.ChangeEvent;
import javax.swing.event.ChangeListener;
import javax.swing.event.DocumentEvent;
import javax.swing.event.DocumentListener;
import java.awt.*;
import java.net.MalformedURLException;


/**
 * This abstract class represents a panel that helps the user initiate a connection to a servers using a certain file
 * protocol. This class is agnostic with respect to the file protocol used -- subclasses implement a specific file 
 * protocol.
 *
 * @author Maxence Bernard
 */
public abstract class ServerPanel extends XAlignedComponentPanel {

    protected ServerConnectDialog dialog;
    protected MainFrame mainFrame;
	
	
    protected ServerPanel(ServerConnectDialog dialog, MainFrame mainFrame) {
        // Add a 10-pixel gap label and text component
        super(10);
		
        this.dialog = dialog;
        this.mainFrame = mainFrame;
    }
	
	
    @Override
    public Insets getInsets() {
        return new Insets(8, 6, 8, 6);
    }

    protected JSpinner createPortSpinner(int portValue) {
        return createIntSpinner(portValue, 1, 65535, 1);
    }

    protected JSpinner createIntSpinner(int value, int minValue, int maxValue, int step) {
        JSpinner spinner = new JSpinner(new SpinnerNumberModel(value, minValue, maxValue, step));

        // Left-aligns the text within the text field, and use a simple decimal format with no thousand separator
        JSpinner.NumberEditor editor = new JSpinner.NumberEditor(spinner, "#####");
        editor.getTextField().setHorizontalAlignment(JTextField.LEADING);
        spinner.setEditor(editor);

        // Any changes made to the spinner will update the URL label
        spinner.addChangeListener(new ChangeListener(){
            public void stateChanged(ChangeEvent e) {
                dialog.updateURLLabel();
            }
        });

        return spinner;
    }
	
    protected void addTextFieldListeners(JTextField textField, boolean updateLabel) {
        textField.addActionListener(dialog);
        if(updateLabel) {
            textField.getDocument().addDocumentListener(new DocumentListener() {
                public void changedUpdate(DocumentEvent e) {
                    dialog.updateURLLabel();
                }

                public void insertUpdate(DocumentEvent e) {
                    dialog.updateURLLabel();
                }

                public void removeUpdate(DocumentEvent e) {
                    dialog.updateURLLabel();
                }
            });
        }
    }


    ///////////////////////
    // Abstract methoods //
    ///////////////////////

    /** 
     * Returns the current server URL represented by this panel, <code>null</code> if it is not available.
     * This method may be called at any time by {@link ServerConnectDialog}.
     *
     * @return the current server URL represented by this panel, <code>null</code> if it is not available
     * @throws MalformedURLException if an exception was thrown while creating the FileURL instance
     */
    abstract FileURL getServerURL() throws MalformedURLException;

    /**
     * Returns <code>true</code> if this panel allows the user to specify credentials for the file protocol.
     *
     * @return <code>true</code> if this panel allows the user to specify credentials for the file protocol
     */
    abstract boolean usesCredentials();

    /**
     * This method is called by {@link ServerConnectDialog} when the dialog has been validated by the user
     * ('OK' button or 'Enter' key pressed). This is where component values should be saved for when a
     * new instance of the panel is created.
     */
    abstract void dialogValidated();
}