2 * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3 * Copyright (C) $$Year-Rel$$ The Jalview Authors
5 * This file is part of Jalview.
7 * Jalview is free software: you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation, either version 3
10 * of the License, or (at your option) any later version.
12 * Jalview is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty
14 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15 * PURPOSE. See the GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
19 * The Jalview Authors are detailed in the 'AUTHORS' file.
22 package jalview.fts.core;
24 import jalview.fts.api.FTSDataColumnI;
25 import jalview.fts.api.GFTSPanelI;
26 import jalview.fts.core.FTSDataColumnPreferences.PreferenceSource;
27 import jalview.gui.Desktop;
28 import jalview.gui.IProgressIndicator;
29 import jalview.gui.JvSwingUtils;
30 import jalview.gui.SequenceFetcher;
31 import jalview.io.cache.JvCacheableInputBox;
32 import jalview.util.MessageManager;
34 import java.awt.BorderLayout;
35 import java.awt.CardLayout;
36 import java.awt.Dimension;
37 import java.awt.event.ActionEvent;
38 import java.awt.event.ActionListener;
39 import java.awt.event.FocusAdapter;
40 import java.awt.event.FocusEvent;
41 import java.awt.event.FocusListener;
42 import java.awt.event.ItemEvent;
43 import java.awt.event.ItemListener;
44 import java.awt.event.KeyAdapter;
45 import java.awt.event.KeyEvent;
46 import java.awt.event.MouseAdapter;
47 import java.awt.event.MouseEvent;
48 import java.text.DecimalFormat;
49 import java.util.ArrayList;
50 import java.util.Arrays;
51 import java.util.Collection;
52 import java.util.Collections;
53 import java.util.Comparator;
54 import java.util.HashSet;
55 import java.util.List;
57 import javax.swing.ImageIcon;
58 import javax.swing.JButton;
59 import javax.swing.JCheckBox;
60 import javax.swing.JComboBox;
61 import javax.swing.JFrame;
62 import javax.swing.JInternalFrame;
63 import javax.swing.JLabel;
64 import javax.swing.JPanel;
65 import javax.swing.JScrollPane;
66 import javax.swing.JTabbedPane;
67 import javax.swing.JTable;
68 import javax.swing.Timer;
69 import javax.swing.event.ChangeEvent;
70 import javax.swing.event.ChangeListener;
71 import javax.swing.event.DocumentEvent;
72 import javax.swing.event.DocumentListener;
73 import javax.swing.event.InternalFrameEvent;
74 import javax.swing.table.DefaultTableModel;
75 import javax.swing.table.TableColumn;
76 import javax.swing.text.JTextComponent;
79 * This class provides the swing GUI layout for FTS Panel and implements most of
80 * the contracts defined in GFSPanelI
86 @SuppressWarnings("serial")
87 public abstract class GFTSPanel extends JPanel implements GFTSPanelI
89 protected JInternalFrame mainFrame = new JInternalFrame(
92 protected IProgressIndicator progressIndicator;
94 protected JComboBox<FTSDataColumnI> cmb_searchTarget = new JComboBox<FTSDataColumnI>();
96 protected JButton btn_ok = new JButton();
98 protected JButton btn_back = new JButton();
100 protected JButton btn_cancel = new JButton();
102 protected JCheckBox btn_autosearch = new JCheckBox();
104 protected JvCacheableInputBox<String> txt_search;
106 protected SequenceFetcher seqFetcher;
108 protected Collection<FTSDataColumnI> wantedFields;
110 private String lastSearchTerm = "";
112 protected JButton btn_next_page = new JButton();
114 protected JButton btn_prev_page = new JButton();
116 protected StringBuilder errorWarning = new StringBuilder();
118 protected ImageIcon warningImage = new ImageIcon(
119 getClass().getResource("/images/warning.gif"));
121 protected ImageIcon loadingImage = new ImageIcon(
122 getClass().getResource("/images/loading.gif"));
124 protected ImageIcon balnkPlaceholderImage = new ImageIcon(
125 getClass().getResource("/images/blank_16x16_placeholder.png"));
127 protected JLabel lbl_warning = new JLabel(warningImage);
129 protected JLabel lbl_loading = new JLabel(loadingImage);
131 protected JLabel lbl_blank = new JLabel(balnkPlaceholderImage);
133 private JTabbedPane tabbedPane = new JTabbedPane();
135 private JPanel pnl_actions = new JPanel();
137 private JPanel pnl_results = new JPanel(new CardLayout());
139 private JPanel pnl_inputs = new JPanel();
141 private BorderLayout mainLayout = new BorderLayout();
143 protected Object[] previousWantedFields;
145 protected int resultSetCount;
147 protected int totalResultSetCount;
149 protected int offSet;
151 protected int pageLimit;
153 protected HashSet<String> paginatorCart = new HashSet<String>();
155 private static final int MIN_WIDTH = 670;
157 private static final int MIN_HEIGHT = 300;
159 protected static final DecimalFormat totalNumberformatter = new DecimalFormat(
162 private JTable tbl_summary = new JTable()
164 private boolean inLayout;
167 public boolean getScrollableTracksViewportWidth()
169 return hasExcessWidth();
174 public void doLayout()
176 if (hasExcessWidth())
178 autoResizeMode = AUTO_RESIZE_SUBSEQUENT_COLUMNS;
183 autoResizeMode = AUTO_RESIZE_OFF;
186 protected boolean hasExcessWidth()
188 return getPreferredSize().width < getParent().getWidth();
192 public void columnMarginChanged(ChangeEvent e)
198 TableColumn resizingColumn = getTableHeader().getResizingColumn();
199 // Need to do this here, before the parent's
200 // layout manager calls getPreferredSize().
201 if (resizingColumn != null && autoResizeMode == AUTO_RESIZE_OFF
204 resizingColumn.setPreferredWidth(resizingColumn.getWidth());
205 String colHeader = resizingColumn.getHeaderValue().toString();
206 getTempUserPrefs().put(colHeader, resizingColumn.getWidth());
212 public String getToolTipText(MouseEvent evt)
214 String toolTipText = null;
215 java.awt.Point pnt = evt.getPoint();
216 int rowIndex = rowAtPoint(pnt);
217 int colIndex = columnAtPoint(pnt);
221 if (getValueAt(rowIndex, colIndex) == null)
225 toolTipText = getValueAt(rowIndex, colIndex).toString();
227 } catch (Exception e)
231 toolTipText = (toolTipText == null ? null
232 : (toolTipText.length() > 500
233 ? JvSwingUtils.wrapTooltip(true,
234 toolTipText.subSequence(0, 500) + "...")
235 : JvSwingUtils.wrapTooltip(true, toolTipText)));
241 protected JScrollPane scrl_searchResult = new JScrollPane(tbl_summary);
248 mainFrame.setMinimumSize(new Dimension(MIN_WIDTH, MIN_HEIGHT));
249 mainFrame.addFocusListener(new FocusAdapter()
252 public void focusGained(FocusEvent e)
254 txt_search.requestFocusInWindow();
257 mainFrame.invalidate();
259 } catch (Exception e)
266 * Initializes the GUI default properties
270 private void jbInit() throws Exception
273 txt_search = new JvCacheableInputBox<String>(getCacheKey());
274 populateCmbSearchTargetOptions();
275 Integer width = getTempUserPrefs().get("FTSPanel.width") == null ? 800
276 : getTempUserPrefs().get("FTSPanel.width");
277 Integer height = getTempUserPrefs().get("FTSPanel.height") == null ? 400
278 : getTempUserPrefs().get("FTSPanel.height");
279 lbl_warning.setVisible(false);
280 lbl_warning.setFont(new java.awt.Font("Verdana", 0, 12));
281 lbl_loading.setVisible(false);
282 lbl_loading.setFont(new java.awt.Font("Verdana", 0, 12));
283 lbl_blank.setVisible(true);
284 lbl_blank.setFont(new java.awt.Font("Verdana", 0, 12));
286 tbl_summary.setAutoCreateRowSorter(true);
287 tbl_summary.getTableHeader().setReorderingAllowed(false);
288 tbl_summary.addMouseListener(new MouseAdapter()
291 public void mouseClicked(MouseEvent e)
297 public void mouseReleased(MouseEvent e)
302 tbl_summary.addKeyListener(new KeyAdapter()
305 public void keyPressed(KeyEvent evt)
308 switch (evt.getKeyCode())
310 case KeyEvent.VK_ESCAPE: // escape key
311 btn_back_ActionPerformed();
313 case KeyEvent.VK_ENTER: // enter key
314 if (btn_ok.isEnabled())
320 case KeyEvent.VK_TAB: // tab key
321 if (evt.isShiftDown())
323 tabbedPane.requestFocus();
327 btn_back.requestFocus();
337 btn_autosearch.setText("");
338 btn_autosearch.setToolTipText(
339 MessageManager.getString("option.enable_disable_autosearch"));
340 btn_back.setFont(new java.awt.Font("Verdana", 0, 12));
341 btn_back.setText(MessageManager.getString("action.back"));
342 btn_back.addActionListener(new java.awt.event.ActionListener()
345 public void actionPerformed(ActionEvent e)
347 btn_back_ActionPerformed();
350 btn_back.addKeyListener(new KeyAdapter()
353 public void keyPressed(KeyEvent evt)
355 if (evt.getKeyCode() == KeyEvent.VK_ENTER)
357 btn_back_ActionPerformed();
362 btn_ok.setEnabled(false);
363 btn_ok.setFont(new java.awt.Font("Verdana", 0, 12));
364 btn_ok.setText(MessageManager.getString("action.ok"));
365 btn_ok.addActionListener(new java.awt.event.ActionListener()
368 public void actionPerformed(ActionEvent e)
373 btn_ok.addKeyListener(new KeyAdapter()
376 public void keyPressed(KeyEvent evt)
378 if (evt.getKeyCode() == KeyEvent.VK_ENTER)
384 btn_next_page.setEnabled(false);
385 btn_next_page.setToolTipText(
386 MessageManager.getString("label.next_page_tooltip"));
387 btn_next_page.setFont(new java.awt.Font("Verdana", 0, 12));
388 btn_next_page.setText(MessageManager.getString("action.next_page"));
389 btn_next_page.addActionListener(new java.awt.event.ActionListener()
392 public void actionPerformed(ActionEvent e)
397 btn_next_page.addKeyListener(new KeyAdapter()
400 public void keyPressed(KeyEvent evt)
402 if (evt.getKeyCode() == KeyEvent.VK_ENTER)
409 btn_prev_page.setEnabled(false);
410 btn_prev_page.setToolTipText(
411 MessageManager.getString("label.prev_page_tooltip"));
412 btn_prev_page.setFont(new java.awt.Font("Verdana", 0, 12));
413 btn_prev_page.setText(MessageManager.getString("action.prev_page"));
414 btn_prev_page.addActionListener(new java.awt.event.ActionListener()
417 public void actionPerformed(ActionEvent e)
422 btn_prev_page.addKeyListener(new KeyAdapter()
425 public void keyPressed(KeyEvent evt)
427 if (evt.getKeyCode() == KeyEvent.VK_ENTER)
434 if (isPaginationEnabled())
436 btn_prev_page.setVisible(true);
437 btn_next_page.setVisible(true);
441 btn_prev_page.setVisible(false);
442 btn_next_page.setVisible(false);
445 btn_cancel.setFont(new java.awt.Font("Verdana", 0, 12));
446 btn_cancel.setText(MessageManager.getString("action.cancel"));
447 btn_cancel.addActionListener(new java.awt.event.ActionListener()
450 public void actionPerformed(ActionEvent e)
452 btn_cancel_ActionPerformed();
455 btn_cancel.addKeyListener(new KeyAdapter()
458 public void keyPressed(KeyEvent evt)
460 if (evt.getKeyCode() == KeyEvent.VK_ENTER)
462 btn_cancel_ActionPerformed();
466 scrl_searchResult.setPreferredSize(new Dimension(width, height));
468 cmb_searchTarget.setFont(new java.awt.Font("Verdana", 0, 12));
469 cmb_searchTarget.addItemListener(new ItemListener()
472 public void itemStateChanged(ItemEvent e)
474 if (e.getStateChange() == ItemEvent.SELECTED)
477 if ("all".equalsIgnoreCase(
478 getCmbSearchTarget().getSelectedItem().toString()))
480 tooltipText = MessageManager.getString("label.search_all");
482 else if ("pdb id".equalsIgnoreCase(
483 getCmbSearchTarget().getSelectedItem().toString()))
485 tooltipText = MessageManager
486 .getString("label.separate_multiple_accession_ids");
490 tooltipText = MessageManager.formatMessage(
491 "label.separate_multiple_query_values", new Object[]
492 { getCmbSearchTarget().getSelectedItem().toString() });
494 txt_search.setToolTipText(
495 JvSwingUtils.wrapTooltip(true, tooltipText));
501 txt_search.setFont(new java.awt.Font("Verdana", 0, 12));
503 txt_search.getEditor().getEditorComponent()
504 .addKeyListener(new KeyAdapter()
507 public void keyPressed(KeyEvent e)
509 if (e.getKeyCode() == KeyEvent.VK_ENTER)
511 if (getTypedText() == null || getTypedText().isEmpty())
515 String primaryKeyName = getFTSRestClient()
516 .getPrimaryKeyColumn().getName();
517 if (primaryKeyName.equalsIgnoreCase(getCmbSearchTarget()
518 .getSelectedItem().toString()))
520 transferToSequenceFetcher(getTypedText());
525 final DeferredTextInputListener listener = new DeferredTextInputListener(
526 1500, new ActionListener()
529 public void actionPerformed(ActionEvent e)
531 if (btn_autosearch.isSelected()
532 || txt_search.wasEnterPressed())
534 performSearchAction();
538 ((JTextComponent) txt_search.getEditor().getEditorComponent())
539 .getDocument().addDocumentListener(listener);
541 txt_search.addFocusListener(new FocusListener()
544 public void focusGained(FocusEvent e)
550 public void focusLost(FocusEvent e)
556 final String searchTabTitle = MessageManager
557 .getString("label.search_result");
558 final String configureCols = MessageManager
559 .getString("label.configure_displayed_columns");
560 ChangeListener changeListener = new ChangeListener()
563 public void stateChanged(ChangeEvent changeEvent)
565 JTabbedPane sourceTabbedPane = (JTabbedPane) changeEvent
567 int index = sourceTabbedPane.getSelectedIndex();
569 btn_back.setVisible(true);
570 btn_cancel.setVisible(true);
571 btn_ok.setVisible(true);
572 if (sourceTabbedPane.getTitleAt(index).equals(configureCols))
574 btn_back.setVisible(false);
575 btn_cancel.setVisible(false);
576 btn_ok.setVisible(false);
577 btn_back.setEnabled(false);
578 btn_cancel.setEnabled(false);
579 btn_ok.setEnabled(false);
580 btn_next_page.setEnabled(false);
581 btn_prev_page.setEnabled(false);
582 txt_search.setEnabled(false);
583 cmb_searchTarget.setEnabled(false);
584 previousWantedFields = getFTSRestClient()
585 .getAllDefaultDisplayedFTSDataColumns()
586 .toArray(new Object[0]);
588 if (sourceTabbedPane.getTitleAt(index).equals(searchTabTitle))
590 btn_back.setEnabled(true);
591 btn_cancel.setEnabled(true);
592 refreshPaginatorState();
593 txt_search.setEnabled(true);
594 cmb_searchTarget.setEnabled(true);
595 if (wantedFieldsUpdated())
598 paginatorCart.clear();
607 tabbedPane.addChangeListener(changeListener);
608 tabbedPane.setPreferredSize(new Dimension(width, height));
609 tabbedPane.add(searchTabTitle, scrl_searchResult);
610 tabbedPane.add(configureCols, new FTSDataColumnPreferences(
611 PreferenceSource.SEARCH_SUMMARY, getFTSRestClient()));
613 pnl_actions.add(btn_back);
614 pnl_actions.add(btn_ok);
615 pnl_actions.add(btn_cancel);
617 pnl_results.add(tabbedPane);
618 pnl_inputs.add(cmb_searchTarget);
619 pnl_inputs.add(txt_search);
620 pnl_inputs.add(btn_autosearch);
621 pnl_inputs.add(lbl_loading);
622 pnl_inputs.add(lbl_warning);
623 pnl_inputs.add(lbl_blank);
624 pnl_inputs.add(btn_prev_page);
625 pnl_inputs.add(btn_next_page);
627 this.setLayout(mainLayout);
628 this.add(pnl_inputs, java.awt.BorderLayout.NORTH);
629 this.add(pnl_results, java.awt.BorderLayout.CENTER);
630 this.add(pnl_actions, java.awt.BorderLayout.SOUTH);
631 mainFrame.setVisible(true);
632 mainFrame.setContentPane(this);
633 mainFrame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
634 mainFrame.addInternalFrameListener(
635 new javax.swing.event.InternalFrameAdapter()
638 public void internalFrameClosing(InternalFrameEvent e)
643 mainFrame.setVisible(true);
644 mainFrame.setContentPane(this);
645 mainFrame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
646 Integer x = getTempUserPrefs().get("FTSPanel.x");
647 Integer y = getTempUserPrefs().get("FTSPanel.y");
648 if (x != null && y != null)
650 mainFrame.setLocation(x, y);
652 Desktop.addInternalFrame(mainFrame, getFTSFrameTitle(), width, height);
655 protected void closeAction()
657 getTempUserPrefs().put("FTSPanel.width", this.getWidth());
658 getTempUserPrefs().put("FTSPanel.height", pnl_results.getHeight());
659 getTempUserPrefs().put("FTSPanel.x", mainFrame.getX());
660 getTempUserPrefs().put("FTSPanel.y", mainFrame.getY());
662 txt_search.persistCache();
665 public class DeferredTextInputListener implements DocumentListener
667 private final Timer swingTimer;
669 public DeferredTextInputListener(int timeOut, ActionListener listener,
672 swingTimer = new Timer(timeOut, listener);
673 swingTimer.setRepeats(repeats);
687 public void insertUpdate(DocumentEvent e)
689 swingTimer.restart();
693 public void removeUpdate(DocumentEvent e)
695 swingTimer.restart();
699 public void changedUpdate(DocumentEvent e)
701 swingTimer.restart();
706 void performSearchAction()
708 String typed = getTypedText();
709 if (typed != null && typed.length() > 0
710 && !typed.equalsIgnoreCase(lastSearchTerm))
713 paginatorCart.clear();
714 lastSearchTerm = typed;
718 public boolean wantedFieldsUpdated()
720 if (previousWantedFields == null)
725 return Arrays.equals(getFTSRestClient()
726 .getAllDefaultDisplayedFTSDataColumns().toArray(new Object[0]),
727 previousWantedFields) ? false : true;
731 public void validateSelection()
733 if (tbl_summary.getSelectedRows().length > 0
734 || !paginatorCart.isEmpty())
736 btn_ok.setEnabled(true);
740 btn_ok.setEnabled(false);
744 public JComboBox<FTSDataColumnI> getCmbSearchTarget()
746 return cmb_searchTarget;
749 public JComboBox<String> getTxtSearch()
754 public JInternalFrame getMainFrame()
759 protected void delayAndEnableActionButtons()
769 } catch (InterruptedException e)
773 btn_ok.setEnabled(true);
774 btn_back.setEnabled(true);
775 btn_cancel.setEnabled(true);
780 protected void checkForErrors()
782 lbl_warning.setVisible(false);
783 lbl_blank.setVisible(true);
784 if (errorWarning.length() > 0)
786 lbl_loading.setVisible(false);
787 lbl_blank.setVisible(false);
788 lbl_warning.setToolTipText(
789 JvSwingUtils.wrapTooltip(true, errorWarning.toString()));
790 lbl_warning.setVisible(true);
794 protected void btn_back_ActionPerformed()
797 new SequenceFetcher(progressIndicator);
800 protected void disableActionButtons()
802 btn_ok.setEnabled(false);
803 btn_back.setEnabled(false);
804 btn_cancel.setEnabled(false);
807 protected void btn_cancel_ActionPerformed()
813 * Populates search target combo-box options
815 public void populateCmbSearchTargetOptions()
817 List<FTSDataColumnI> searchableTargets = new ArrayList<FTSDataColumnI>();
820 Collection<FTSDataColumnI> foundFTSTargets = getFTSRestClient()
821 .getSearchableDataColumns();
822 searchableTargets.addAll(foundFTSTargets);
823 } catch (Exception e)
828 Collections.sort(searchableTargets, new Comparator<FTSDataColumnI>()
831 public int compare(FTSDataColumnI o1, FTSDataColumnI o2)
833 return o1.getName().compareTo(o2.getName());
837 for (FTSDataColumnI searchTarget : searchableTargets)
839 cmb_searchTarget.addItem(searchTarget);
843 public void transferToSequenceFetcher(String ids)
845 seqFetcher.getTextArea().setText(ids);
846 Thread worker = new Thread(seqFetcher);
851 public String getTypedText()
853 return txt_search.getUserInput();
857 public JTable getResultTable()
864 lbl_loading.setVisible(false);
865 errorWarning.setLength(0);
866 lbl_warning.setVisible(false);
867 lbl_blank.setVisible(true);
868 btn_ok.setEnabled(false);
869 mainFrame.setTitle(getFTSFrameTitle());
871 tbl_summary.setModel(new DefaultTableModel());
872 tbl_summary.setVisible(false);
876 public void setPrevPageButtonEnabled(boolean isEnabled)
878 btn_prev_page.setEnabled(isEnabled);
882 public void setNextPageButtonEnabled(boolean isEnabled)
884 btn_next_page.setEnabled(isEnabled);
888 public void setErrorMessage(String message)
890 errorWarning.append(message);
894 public void updateSearchFrameTitle(String title)
896 mainFrame.setTitle(title);
900 public void setSearchInProgress(Boolean isSearchInProgress)
902 lbl_blank.setVisible(!isSearchInProgress);
903 lbl_loading.setVisible(isSearchInProgress);
904 txt_search.setEditable(!isSearchInProgress);
908 public void prevPageAction()
910 updatePaginatorCart();
911 if (offSet >= pageLimit)
913 offSet = offSet - pageLimit;
918 refreshPaginatorState();
923 public void nextPageAction()
925 updatePaginatorCart();
926 offSet = offSet + pageLimit;
930 public void updatePaginatorCart()
932 int primaryKeyColIndex = 0;
933 JTable resultTable = getResultTable();
934 int totalRows = resultTable.getRowCount();
937 primaryKeyColIndex = getFTSRestClient()
938 .getPrimaryKeyColumIndex(wantedFields, false);
939 } catch (Exception e)
944 for (int row = 0; row < totalRows; row++)
946 String id = (String) resultTable.getValueAt(row, primaryKeyColIndex);
947 if (paginatorCart.contains(id))
949 paginatorCart.remove(id);
952 int[] selectedRows = resultTable.getSelectedRows();
953 for (int summaryRow : selectedRows)
955 String idStr = resultTable.getValueAt(summaryRow, primaryKeyColIndex)
957 paginatorCart.add(idStr);
961 public void updateSummaryTableSelections()
963 JTable resultTable = getResultTable();
964 if (paginatorCart.isEmpty())
968 int primaryKeyColIndex = 0;
971 primaryKeyColIndex = getFTSRestClient()
972 .getPrimaryKeyColumIndex(wantedFields, false);
973 } catch (Exception e)
977 int totalRows = resultTable.getRowCount();
978 for (int row = 0; row < totalRows; row++)
980 String id = (String) resultTable.getValueAt(row, primaryKeyColIndex);
981 if (paginatorCart.contains(id))
983 resultTable.addRowSelectionInterval(row, row);
989 public void refreshPaginatorState()
991 setPrevPageButtonEnabled(false);
992 setNextPageButtonEnabled(false);
993 if (resultSetCount == 0 && pageLimit == 0)
997 if (resultSetCount >= pageLimit)
999 setNextPageButtonEnabled(true);
1001 if (offSet >= pageLimit)
1003 setPrevPageButtonEnabled(true);
1007 public void referesh()
1009 mainFrame.setTitle(getFTSFrameTitle());