/*
* Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
* Copyright (C) $$Year-Rel$$ The Jalview Authors
*
* This file is part of Jalview.
*
* Jalview 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.
*
* Jalview 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 Jalview. If not, see .
* The Jalview Authors are detailed in the 'AUTHORS' file.
*/
package jalview.gui;
import java.awt.Component;
import java.awt.Dialog.ModalityType;
import java.awt.HeadlessException;
import java.awt.Window;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.concurrent.Executors;
import javax.swing.Icon;
import javax.swing.JButton;
import javax.swing.JDialog;
import javax.swing.JInternalFrame;
import javax.swing.JOptionPane;
import javax.swing.JPanel;
import javax.swing.UIManager;
import jalview.util.Platform;
import jalview.util.dialogrunner.DialogRunnerI;
public class JvOptionPane extends JOptionPane
implements DialogRunnerI, PropertyChangeListener
{
private static final long serialVersionUID = -3019167117756785229L;
private static Object mockResponse = JvOptionPane.CANCEL_OPTION;
private static boolean interactiveMode = true;
private Component parentComponent;
private Map callbacks = new HashMap<>();
/*
* JalviewJS reports user choice in the dialog as the selected
* option (text); this list allows conversion to index (int)
*/
List ourOptions;
public JvOptionPane(final Component parent)
{
this.parentComponent = Platform.isJS() ? this : parent;
}
public static int showConfirmDialog(Component parentComponent,
Object message) throws HeadlessException
{
// only called by test
return isInteractiveMode()
? JOptionPane.showConfirmDialog(parentComponent, message)
: (int) getMockResponse();
}
/**
* Message, title, optionType
*
* @param parentComponent
* @param message
* @param title
* @param optionType
* @return
* @throws HeadlessException
*/
public static int showConfirmDialog(Component parentComponent,
Object message, String title, int optionType)
throws HeadlessException
{
if (!isInteractiveMode())
{
return (int) getMockResponse();
}
switch (optionType)
{
case JvOptionPane.YES_NO_CANCEL_OPTION:
// FeatureRenderer amendFeatures ?? TODO ??
// Chimera close
// PromptUserConfig
// $FALL-THROUGH$
default:
case JvOptionPane.YES_NO_OPTION:
// PromptUserConfig usage stats
// for now treated as "OK CANCEL"
// $FALL-THROUGH$
case JvOptionPane.OK_CANCEL_OPTION:
// will fall back to simple HTML
return JOptionPane.showConfirmDialog(parentComponent, message, title,
optionType);
}
}
/**
* Adds a message type. Fallback is to just add it in the beginning.
*
* @param parentComponent
* @param message
* @param title
* @param optionType
* @param messageType
* @return
* @throws HeadlessException
*/
public static int showConfirmDialog(Component parentComponent,
Object message, String title, int optionType, int messageType)
throws HeadlessException
{
// JalviewServicesChanged
// PromptUserConfig raiseDialog
return isInteractiveMode()
? JOptionPane.showConfirmDialog(parentComponent, message, title,
optionType, messageType)
: (int) getMockResponse();
}
/**
* Adds an icon
*
* @param parentComponent
* @param message
* @param title
* @param optionType
* @param messageType
* @param icon
* @return
* @throws HeadlessException
*/
public static int showConfirmDialog(Component parentComponent,
Object message, String title, int optionType, int messageType,
Icon icon) throws HeadlessException
{
// JvOptionPaneTest only
return isInteractiveMode()
? JOptionPane.showConfirmDialog(parentComponent, message, title,
optionType, messageType, icon)
: (int) getMockResponse();
}
/**
* Internal version "OK"
*
* @param parentComponent
* @param message
* @return
*/
public static int showInternalConfirmDialog(Component parentComponent,
Object message)
{
// JvOptionPaneTest only;
return isInteractiveMode()
? JOptionPane.showInternalConfirmDialog(parentComponent,
message)
: (int) getMockResponse();
}
/**
* Internal version -- changed to standard version for now
*
* @param parentComponent
* @param message
* @param title
* @param optionType
* @return
*/
public static int showInternalConfirmDialog(Component parentComponent,
String message, String title, int optionType)
{
if (!isInteractiveMode())
{
return (int) getMockResponse();
}
switch (optionType)
{
case JvOptionPane.YES_NO_CANCEL_OPTION:
// ColourMenuHelper.addMenuItmers.offerRemoval TODO
case JvOptionPane.YES_NO_OPTION:
// UserDefinedColoursSave -- relevant? TODO
// $FALL-THROUGH$
default:
case JvOptionPane.OK_CANCEL_OPTION:
// EditNameDialog --- uses panel for messsage TODO
// Desktop.inputURLMenuItem
// WsPreferenses
return JOptionPane.showConfirmDialog(parentComponent, message, title,
optionType);
}
}
/**
*
* @param parentComponent
* @param message
* @param title
* @param optionType
* @param messageType
* @return
*/
public static int showInternalConfirmDialog(Component parentComponent,
Object message, String title, int optionType, int messageType)
{
if (!isInteractiveMode())
{
return (int) getMockResponse();
}
switch (optionType)
{
case JvOptionPane.YES_NO_CANCEL_OPTION:
case JvOptionPane.YES_NO_OPTION:
// UserQuestionanaireCheck
// VamsasApplication
// $FALL-THROUGH$
default:
case JvOptionPane.OK_CANCEL_OPTION:
// will fall back to simple HTML
return JOptionPane.showConfirmDialog(parentComponent, message, title,
optionType, messageType);
}
}
/**
* adds icon; no longer internal
*
* @param parentComponent
* @param message
* @param title
* @param optionType
* @param messageType
* @param icon
* @return
*/
public static int showInternalConfirmDialog(Component parentComponent,
Object message, String title, int optionType, int messageType,
Icon icon)
{
if (!isInteractiveMode())
{
return (int) getMockResponse();
}
switch (optionType)
{
case JvOptionPane.YES_NO_CANCEL_OPTION:
case JvOptionPane.YES_NO_OPTION:
//$FALL-THROUGH$
default:
case JvOptionPane.OK_CANCEL_OPTION:
// Preferences editLink/newLink
return JOptionPane.showConfirmDialog(parentComponent, message, title,
optionType, messageType, icon);
}
}
/**
* custom options full-featured
*
* @param parentComponent
* @param message
* @param title
* @param optionType
* @param messageType
* @param icon
* @param options
* @param initialValue
* @return
* @throws HeadlessException
*/
public static int showOptionDialog(Component parentComponent,
String message, String title, int optionType, int messageType,
Icon icon, Object[] options, Object initialValue)
throws HeadlessException
{
if (!isInteractiveMode())
{
return (int) getMockResponse();
}
// two uses:
//
// TODO
//
// 1) AlignViewport for openLinkedAlignment
//
// Show a dialog with the option to open and link (cDNA <-> protein) as a
// new
// alignment, either as a standalone alignment or in a split frame. Returns
// true if the new alignment was opened, false if not, because the user
// declined the offer.
//
// 2) UserDefinedColors warning about saving over a name already defined
//
return JOptionPane.showOptionDialog(parentComponent, message, title,
optionType, messageType, icon, options, initialValue);
}
/**
* Just an OK message
*
* @param message
* @throws HeadlessException
*/
public static void showMessageDialog(Component parentComponent,
String message) throws HeadlessException
{
if (!isInteractiveMode())
{
outputMessage(message);
return;
}
// test class only
JOptionPane.showMessageDialog(parentComponent, message);
}
/**
* OK with message, title, and type
*
* @param parentComponent
* @param message
* @param title
* @param messageType
* @throws HeadlessException
*/
public static void showMessageDialog(Component parentComponent,
String message, String title, int messageType)
throws HeadlessException
{
// 30 implementations -- all just fine.
if (!isInteractiveMode())
{
outputMessage(message);
return;
}
JOptionPane.showMessageDialog(parentComponent,
getPrefix(messageType) + message, title, messageType);
}
/**
* adds title and icon
*
* @param parentComponent
* @param message
* @param title
* @param messageType
* @param icon
* @throws HeadlessException
*/
public static void showMessageDialog(Component parentComponent,
String message, String title, int messageType, Icon icon)
throws HeadlessException
{
// test only
if (!isInteractiveMode())
{
outputMessage(message);
return;
}
JOptionPane.showMessageDialog(parentComponent, message, title,
messageType, icon);
}
/**
* was internal
*
*/
public static void showInternalMessageDialog(Component parentComponent,
Object message)
{
// WsPreferences only
if (!isInteractiveMode())
{
outputMessage(message);
return;
}
JOptionPane.showMessageDialog(parentComponent, message);
}
/**
* Adds title and messageType
*
* @param parentComponent
* @param message
* @param title
* @param messageType
*/
public static void showInternalMessageDialog(Component parentComponent,
String message, String title, int messageType)
{
// 41 references
if (!isInteractiveMode())
{
outputMessage(message);
return;
}
JOptionPane.showMessageDialog(parentComponent,
getPrefix(messageType) + message, title, messageType);
}
/**
*
* @param parentComponent
* @param message
* @param title
* @param messageType
* @param icon
*/
public static void showInternalMessageDialog(Component parentComponent,
Object message, String title, int messageType, Icon icon)
{
// test only
if (!isInteractiveMode())
{
outputMessage(message);
return;
}
JOptionPane.showMessageDialog(parentComponent, message, title,
messageType, icon);
}
/**
*
* @param message
* @return
* @throws HeadlessException
*/
public static String showInputDialog(Object message)
throws HeadlessException
{
// test only
if (!isInteractiveMode())
{
return getMockResponse().toString();
}
return JOptionPane.showInputDialog(message);
}
/**
* adds inital selection value
*
* @param message
* @param initialSelectionValue
* @return
*/
public static String showInputDialog(String message,
String initialSelectionValue)
{
if (!isInteractiveMode())
{
return getMockResponse().toString();
}
// AnnotationPanel character option
return JOptionPane.showInputDialog(message, initialSelectionValue);
}
/**
* adds inital selection value
*
* @param message
* @param initialSelectionValue
* @return
*/
public static String showInputDialog(Object message,
Object initialSelectionValue)
{
if (!isInteractiveMode())
{
return getMockResponse().toString();
}
// AnnotationPanel character option
return JOptionPane.showInputDialog(message, initialSelectionValue);
}
/**
* centered on parent
*
* @param parentComponent
* @param message
* @return
* @throws HeadlessException
*/
public static String showInputDialog(Component parentComponent,
String message) throws HeadlessException
{
// test only
return isInteractiveMode()
? JOptionPane.showInputDialog(parentComponent, message)
: getMockResponse().toString();
}
/**
* input with initial selection
*
* @param parentComponent
* @param message
* @param initialSelectionValue
* @return
*/
public static String showInputDialog(Component parentComponent,
String message, String initialSelectionValue)
{
// AnnotationPanel
return isInteractiveMode()
? JOptionPane.showInputDialog(parentComponent, message,
initialSelectionValue)
: getMockResponse().toString();
}
/**
* input with initial selection
*
* @param parentComponent
* @param message
* @param initialSelectionValue
* @return
*/
public static String showInputDialog(Component parentComponent,
Object message, Object initialSelectionValue)
{
// AnnotationPanel
return isInteractiveMode()
? JOptionPane.showInputDialog(parentComponent, message,
initialSelectionValue)
: getMockResponse().toString();
}
/**
*
* @param parentComponent
* @param message
* @param title
* @param messageType
* @return
* @throws HeadlessException
*/
public static String showInputDialog(Component parentComponent,
String message, String title, int messageType)
throws HeadlessException
{
// test only
return isInteractiveMode()
? JOptionPane.showInputDialog(parentComponent, message, title,
messageType)
: getMockResponse().toString();
}
/**
* Customized input option
*
* @param parentComponent
* @param message
* @param title
* @param messageType
* @param icon
* @param selectionValues
* @param initialSelectionValue
* @return
* @throws HeadlessException
*/
public static Object showInputDialog(Component parentComponent,
Object message, String title, int messageType, Icon icon,
Object[] selectionValues, Object initialSelectionValue)
throws HeadlessException
{
// test only
return isInteractiveMode()
? JOptionPane.showInputDialog(parentComponent, message, title,
messageType, icon, selectionValues,
initialSelectionValue)
: getMockResponse().toString();
}
/**
* internal version
*
* @param parentComponent
* @param message
* @return
*/
public static String showInternalInputDialog(Component parentComponent,
String message)
{
// test only
return isInteractiveMode()
? JOptionPane.showInternalInputDialog(parentComponent, message)
: getMockResponse().toString();
}
/**
* internal with title and messageType
*
* @param parentComponent
* @param message
* @param title
* @param messageType
* @return
*/
public static String showInternalInputDialog(Component parentComponent,
String message, String title, int messageType)
{
// AlignFrame tabbedPane_mousePressed
return isInteractiveMode()
? JOptionPane.showInternalInputDialog(parentComponent,
getPrefix(messageType) + message, title, messageType)
: getMockResponse().toString();
}
/**
* customized internal
*
* @param parentComponent
* @param message
* @param title
* @param messageType
* @param icon
* @param selectionValues
* @param initialSelectionValue
* @return
*/
public static Object showInternalInputDialog(Component parentComponent,
String message, String title, int messageType, Icon icon,
Object[] selectionValues, Object initialSelectionValue)
{
// test only
return isInteractiveMode()
? JOptionPane.showInternalInputDialog(parentComponent, message,
title, messageType, icon, selectionValues,
initialSelectionValue)
: getMockResponse().toString();
}
///////////// end of options ///////////////
private static void outputMessage(Object message)
{
System.out.println(">>> JOption Message : " + message.toString());
}
public static Object getMockResponse()
{
return mockResponse;
}
public static void setMockResponse(Object mockOption)
{
JvOptionPane.mockResponse = mockOption;
}
public static void resetMock()
{
setMockResponse(JvOptionPane.CANCEL_OPTION);
setInteractiveMode(true);
}
public static boolean isInteractiveMode()
{
return interactiveMode;
}
public static void setInteractiveMode(boolean interactive)
{
JvOptionPane.interactiveMode = interactive;
}
private static String getPrefix(int messageType)
{
String prefix = "";
// JavaScript only
if (Platform.isJS())
{
switch (messageType)
{
case JvOptionPane.WARNING_MESSAGE:
prefix = "WARNING! ";
break;
case JvOptionPane.ERROR_MESSAGE:
prefix = "ERROR! ";
break;
default:
prefix = "Note: ";
}
}
return prefix;
}
/**
* create a new option dialog that can be used to register responses - along
* lines of showOptionDialog
*
* @param desktop
* @param question
* @param string
* @param defaultOption
* @param plainMessage
* @param object
* @param options
* @param string2
* @return
*/
public static JvOptionPane newOptionDialog(Component parentComponent)
{
return new JvOptionPane(parentComponent);
}
public void showDialog(String message, String title, int optionType,
int messageType, Icon icon, Object[] options, Object initialValue)
{
showDialog(message, title, optionType, messageType, icon, options,
initialValue, true);
}
public void showDialog(String message, String title, int optionType,
int messageType, Icon icon, Object[] options, Object initialValue,
boolean modal)
{
if (!isInteractiveMode())
{
handleResponse(getMockResponse());
}
// two uses:
//
// TODO
//
// 1) AlignViewport for openLinkedAlignment
//
// Show a dialog with the option to open and link (cDNA <-> protein) as a
// new
// alignment, either as a standalone alignment or in a split frame. Returns
// true if the new alignment was opened, false if not, because the user
// declined the offer.
//
// 2) UserDefinedColors warning about saving over a name already defined
//
ourOptions = Arrays.asList(options);
if (modal)
{
// use a JOptionPane as usual
int response = JOptionPane.showOptionDialog(parentComponent, message,
title, optionType, messageType, icon, options, initialValue);
/*
* In Java, the response is returned to this thread and handled here;
* (for Javascript, see propertyChange)
*/
if (!Platform.isJS())
/**
* Java only
*
* @j2sIgnore
*/
{
handleResponse(response);
}
}
else
{
/*
* This is java similar to the swingjs handling, with the callbacks
* attached to the button press of the dialog. This means we can use
* a non-modal JDialog for the confirmation without blocking the GUI.
*/
JOptionPane joptionpane = new JOptionPane();
// Make button options
int[] buttonActions = { JvOptionPane.YES_OPTION,
JvOptionPane.NO_OPTION, JvOptionPane.CANCEL_OPTION };
// we need the strings to make the buttons with actionEventListener
if (options == null)
{
ArrayList options_default = new ArrayList<>();
options_default
.add(UIManager.getString("OptionPane.yesButtonText"));
if (optionType == JvOptionPane.YES_NO_OPTION
|| optionType == JvOptionPane.YES_NO_CANCEL_OPTION)
{
options_default
.add(UIManager.getString("OptionPane.noButtonText"));
}
if (optionType == JvOptionPane.YES_NO_CANCEL_OPTION)
{
options_default
.add(UIManager.getString("OptionPane.cancelButtonText"));
}
options = options_default.toArray();
}
ArrayList options_btns = new ArrayList<>();
Object initialValue_btn = null;
if (!Platform.isJS()) // JalviewJS already uses callback, don't need to add them here
{
for (int i = 0; i < options.length && i < 3; i++)
{
Object o = options[i];
int buttonAction = buttonActions[i];
Runnable action = callbacks.get(buttonAction);
JButton jb = new JButton();
jb.setText((String) o);
jb.addActionListener(new ActionListener()
{
@Override
public void actionPerformed(ActionEvent e)
{
joptionpane.setValue(buttonAction);
if (action != null)
Executors.defaultThreadFactory().newThread(action).start();
// joptionpane.transferFocusBackward();
joptionpane.transferFocusBackward();
joptionpane.setVisible(false);
// put focus and raise parent window if possible, unless cancel
// button pressed
boolean raiseParent = (parentComponent != null);
if (buttonAction == JvOptionPane.CANCEL_OPTION)
raiseParent = false;
if (optionType == JvOptionPane.YES_NO_OPTION
&& buttonAction == JvOptionPane.NO_OPTION)
raiseParent = false;
if (raiseParent)
{
parentComponent.requestFocus();
if (parentComponent instanceof JInternalFrame)
{
JInternalFrame jif = (JInternalFrame) parentComponent;
jif.show();
jif.moveToFront();
jif.grabFocus();
}
else if (parentComponent instanceof Window)
{
Window w = (Window) parentComponent;
w.toFront();
w.requestFocus();
}
}
joptionpane.setVisible(false);
}
});
options_btns.add(jb);
if (o.equals(initialValue))
initialValue_btn = jb;
}
}
joptionpane.setMessage(message);
joptionpane.setMessageType(messageType);
joptionpane.setOptionType(optionType);
joptionpane.setIcon(icon);
joptionpane.setOptions(
Platform.isJS() ? options : options_btns.toArray());
joptionpane.setInitialValue(
Platform.isJS() ? initialValue : initialValue_btn);
JDialog dialog = joptionpane.createDialog(parentComponent, title);
dialog.setModalityType(modal ? ModalityType.APPLICATION_MODAL
: ModalityType.MODELESS);
dialog.setDefaultCloseOperation(JDialog.DISPOSE_ON_CLOSE);
dialog.setVisible(true);
}
}
public void showInternalDialog(JPanel mainPanel, String title,
int yesNoCancelOption, int questionMessage, Icon icon,
Object[] options, String initresponse)
{
if (!isInteractiveMode())
{
handleResponse(getMockResponse());
}
ourOptions = Arrays.asList(options);
int response;
if (parentComponent != this)
{
response = JOptionPane.showInternalOptionDialog(parentComponent,
mainPanel, title, yesNoCancelOption, questionMessage, icon,
options, initresponse);
}
else
{
response = JOptionPane.showOptionDialog(parentComponent, mainPanel,
title, yesNoCancelOption, questionMessage, icon, options,
initresponse);
}
if (!Platform.isJS())
/**
* Java only
*
* @j2sIgnore
*/
{
handleResponse(response);
}
}
@Override
public JvOptionPane setResponseHandler(Object response, Runnable action)
{
callbacks.put(response, action);
return this;
}
/**
* JalviewJS signals option selection by a property change event for the
* option e.g. "OK". This methods responds to that by running the response
* action that corresponds to that option.
*
* @param evt
*/
@Override
public void propertyChange(PropertyChangeEvent evt)
{
Object newValue = evt.getNewValue();
int ourOption = ourOptions.indexOf(newValue);
if (ourOption >= 0)
{
handleResponse(ourOption);
}
else
{
// try our luck..
handleResponse(newValue);
}
}
@Override
public void handleResponse(Object response)
{
/*
* this test is for NaN in Chrome
*/
if (response != null && !response.equals(response))
{
return;
}
Runnable action = callbacks.get(response);
if (action != null)
{
action.run();
parentComponent.requestFocus();
}
}
}