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.
21 package jalview.io.cache;
23 import jalview.bin.Cache;
24 import jalview.util.MessageManager;
25 import jalview.util.Platform;
27 import java.awt.event.ActionEvent;
28 import java.awt.event.ActionListener;
29 import java.awt.event.FocusListener;
30 import java.awt.event.KeyAdapter;
31 import java.awt.event.KeyEvent;
32 import java.awt.event.KeyListener;
33 import java.util.ArrayList;
34 import java.util.Arrays;
35 import java.util.Collections;
36 import java.util.LinkedHashSet;
37 import java.util.List;
40 import javax.swing.JComboBox;
41 import javax.swing.JComponent;
42 import javax.swing.JMenuItem;
43 import javax.swing.JPopupMenu;
44 import javax.swing.JTextField;
45 import javax.swing.SwingUtilities;
46 import javax.swing.event.CaretListener;
47 import javax.swing.event.DocumentListener;
48 import javax.swing.text.JTextComponent;
51 * A class that provides an editable combobox with a memory of previous entries
52 * that may be persisted
59 * (temporary?) patches to wrap a JTextField instead when running as Javascript
61 public class JvCacheableInputBox<E>
63 protected JComboBox<String> comboBox; // used for Jalview
65 protected JTextField textField; // used for JalviewJS
67 protected JTextComponent textComponent; // used for both
69 protected String cacheKey;
71 protected AppCache appCache;
73 private JPopupMenu popup = new JPopupMenu();
75 private JMenuItem menuItemClearCache = new JMenuItem();
77 volatile boolean enterWasPressed = false;
79 private String prototypeDisplayValue;
82 * @return flag indicating if the most recent keypress was enter
84 public boolean wasEnterPressed()
86 return enterWasPressed;
90 * Constructor given the key to cached values, and the (approximate) length in
91 * characters of the input field
96 public JvCacheableInputBox(String newCacheKey, int length)
99 cacheKey = newCacheKey;
100 prototypeDisplayValue = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
103 StringBuilder sb = new StringBuilder();
104 for (int i = 0; i < length; i++)
108 setPrototypeDisplayValue(sb.toString());
110 boolean useTextField = Platform.isJS();
111 // BH 2019.03 only switch for JavaScript here
112 // SwingJS TODO implement editable combo box
116 textComponent = textField = new JTextField();
119 // public Dimension getPreferredSize() {
120 // return super.getPreferredSize();
121 //// FontMetrics fm = getFontMetrics(getFont());
122 //// return new Dimension(fm.stringWidth(prototypeDisplayValue),
129 appCache = AppCache.getInstance();
130 comboBox = new JComboBox<>();
131 textComponent = (JTextComponent) comboBox.getEditor()
132 .getEditorComponent();
133 comboBox.setEditable(true);
134 comboBox.addKeyListener(new KeyAdapter()
137 public void keyTyped(KeyEvent e)
139 enterWasPressed = false;
140 if (e.getKeyCode() == KeyEvent.VK_ENTER)
142 enterWasPressed = true;
144 // let event bubble up
147 comboBox.setPrototypeDisplayValue(prototypeDisplayValue);
148 initCachePopupMenu();
149 initCache(newCacheKey);
155 * Method for initialising cache items for a given cache key and populating
156 * the in-memory cache with persisted cache items
160 private void initCache(String cacheKey)
162 if (appCache == null)
166 // obtain persisted cache items from properties file as a delimited string
167 String delimitedCacheStr = Cache.getProperty(cacheKey);
168 if (delimitedCacheStr == null || delimitedCacheStr.isEmpty())
172 // convert delimited cache items to a list of strings
173 List<String> persistedCacheItems = Arrays
174 .asList(delimitedCacheStr.split(AppCache.CACHE_DELIMITER));
176 LinkedHashSet<String> foundCacheItems = appCache
177 .getAllCachedItemsFor(cacheKey);
178 if (foundCacheItems == null)
180 foundCacheItems = new LinkedHashSet<>();
182 // populate memory cache
183 for (String cacheItem : persistedCacheItems)
185 foundCacheItems.add(cacheItem);
187 appCache.putCache(cacheKey, foundCacheItems);
191 * Initialise this cache's pop-up menu
193 private void initCachePopupMenu()
195 if (appCache == null)
199 menuItemClearCache.setFont(new java.awt.Font("Verdana", 0, 12));
201 .setText(MessageManager.getString("action.clear_cached_items"));
202 menuItemClearCache.addActionListener(new ActionListener()
205 public void actionPerformed(ActionEvent e)
207 // jalview.bin.Console.outPrintln(">>>>> Clear cache items");
209 appCache.deleteCacheItems(cacheKey);
214 popup.add(menuItemClearCache);
215 comboBox.setComponentPopupMenu(popup);
220 * Answers true if input text is an integer
225 static boolean isInteger(String text)
229 Integer.parseInt(text);
231 } catch (NumberFormatException e)
238 * Method called to update the cache with the last user input
240 public void updateCache()
242 if (appCache == null)
246 SwingUtilities.invokeLater(new Runnable()
251 int cacheLimit = Integer.parseInt(appCache.getCacheLimit(cacheKey));
252 String userInput = getUserInput();
253 if (userInput != null && !userInput.isEmpty())
255 LinkedHashSet<String> foundCache = appCache
256 .getAllCachedItemsFor(cacheKey);
257 // remove old cache item so as to place current input at the top of
259 foundCache.remove(userInput);
260 foundCache.add(userInput);
261 appCache.putCache(cacheKey, foundCache);
264 String lastSearch = userInput;
265 if (comboBox.getItemCount() > 0)
267 comboBox.removeAllItems();
269 Set<String> cacheItems = appCache.getAllCachedItemsFor(cacheKey);
270 List<String> reversedCacheItems = new ArrayList<>();
271 reversedCacheItems.addAll(cacheItems);
273 Collections.reverse(reversedCacheItems);
274 if (lastSearch.isEmpty())
276 comboBox.addItem("");
279 if (reversedCacheItems != null && !reversedCacheItems.isEmpty())
281 LinkedHashSet<String> foundCache = appCache
282 .getAllCachedItemsFor(cacheKey);
283 boolean prune = reversedCacheItems.size() > cacheLimit;
285 boolean limitExceeded = false;
286 for (String cacheItem : reversedCacheItems)
288 limitExceeded = (count++ > cacheLimit);
293 foundCache.remove(cacheItem);
297 comboBox.addItem(cacheItem);
302 comboBox.addItem(cacheItem);
305 appCache.putCache(cacheKey, foundCache);
307 setSelectedItem(lastSearch.isEmpty() ? "" : lastSearch);
313 * This method should be called to persist the in-memory cache when this
314 * components parent frame is closed / exited
316 public void persistCache()
318 if (appCache == null)
322 appCache.persistCache(cacheKey);
326 * Returns the trimmed text in the input field
330 public String getUserInput()
332 if (comboBox == null)
334 return textField.getText().trim();
336 Object item = comboBox.getEditor().getItem();
337 return item == null ? "" : item.toString().trim();
340 public JComponent getComponent()
342 return (comboBox == null ? textField : comboBox);
345 public void addActionListener(ActionListener actionListener)
347 if (comboBox == null)
349 textField.addActionListener(actionListener);
353 comboBox.addActionListener(actionListener);
357 public void addDocumentListener(DocumentListener listener)
359 textComponent.getDocument().addDocumentListener(listener);
362 public void addFocusListener(FocusListener focusListener)
364 textComponent.addFocusListener(focusListener);
367 public void addKeyListener(KeyListener kl)
369 textComponent.addKeyListener(kl);
372 public void addCaretListener(CaretListener caretListener)
374 textComponent.addCaretListener(caretListener);
377 public void setEditable(boolean b)
379 if (comboBox != null)
381 comboBox.setEditable(b);
385 public void setPrototypeDisplayValue(String string)
387 prototypeDisplayValue = string;
388 if (comboBox != null)
390 comboBox.setPrototypeDisplayValue(string);
394 public void setSelectedItem(String userInput)
396 if (comboBox != null)
398 comboBox.setSelectedItem(userInput);
402 public boolean isPopupVisible()
404 return (comboBox != null && comboBox.isPopupVisible());
407 public void addItem(String item)
409 if (comboBox != null)
411 comboBox.addItem(item);