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.
23 import jalview.jbgui.GWebserviceInfo;
24 import jalview.util.MessageManager;
25 import jalview.ws.WSClientI;
27 import java.awt.BorderLayout;
28 import java.awt.Color;
30 import java.awt.Graphics;
31 import java.awt.Graphics2D;
32 import java.awt.GridLayout;
33 import java.awt.Image;
34 import java.awt.MediaTracker;
35 import java.awt.event.ActionEvent;
36 import java.awt.image.BufferedImage;
37 import java.util.Vector;
39 import javax.swing.JComponent;
40 import javax.swing.JEditorPane;
41 import javax.swing.JInternalFrame;
42 import javax.swing.JOptionPane;
43 import javax.swing.JPanel;
44 import javax.swing.JScrollPane;
45 import javax.swing.JTabbedPane;
46 import javax.swing.JTextArea;
47 import javax.swing.event.HyperlinkEvent;
48 import javax.swing.event.HyperlinkListener;
49 import javax.swing.text.html.HTMLEditorKit;
50 import javax.swing.text.html.StyleSheet;
53 * Base class for web service client thread and gui TODO: create StAX parser to
54 * extract html body content reliably when preparing html formatted job statuses
59 public class WebserviceInfo extends GWebserviceInfo implements
60 HyperlinkListener, IProgressIndicator
64 public static final int STATE_QUEUING = 0;
67 public static final int STATE_RUNNING = 1;
69 /** Job has finished with no errors */
70 public static final int STATE_STOPPED_OK = 2;
72 /** Job has been cancelled with no errors */
73 public static final int STATE_CANCELLED_OK = 3;
75 /** job has stopped because of some error */
76 public static final int STATE_STOPPED_ERROR = 4;
78 /** job has failed because of some unavoidable service interruption */
79 public static final int STATE_STOPPED_SERVERERROR = 5;
81 int currentStatus = STATE_QUEUING;
89 jalview.ws.WSClientI thisService;
91 boolean serviceIsCancellable;
95 private IProgressIndicator progressBar;
98 public void setVisible(boolean aFlag)
100 super.setVisible(aFlag);
101 frame.setVisible(aFlag);
104 JTabbedPane subjobs = null;
106 java.util.Vector jobPanes = null;
108 private boolean serviceCanMergeResults = false;
110 private boolean viewResultsImmediatly = true;
116 * to indicate if results will be shown in a new window as soon as
117 * they are available.
119 public boolean isViewResultsImmediatly()
121 return viewResultsImmediatly;
128 * to indicate if results will be shown in a new window as soon as
129 * they are available.
131 public void setViewResultsImmediatly(boolean viewResultsImmediatly)
133 this.viewResultsImmediatly = viewResultsImmediatly;
136 private StyleSheet getStyleSheet(HTMLEditorKit editorKit)
139 // Copied blatantly from
140 // http://www.velocityreviews.com/forums/t132265-string-into-htmldocument.html
141 StyleSheet myStyleSheet = new StyleSheet();
143 myStyleSheet.addStyleSheet(editorKit.getStyleSheet());
145 editorKit.setStyleSheet(myStyleSheet);
148 * Set the style sheet rules here by reading them from the constants
152 * for (int ix=0; ix<CSS_RULES.length; ix++) {
154 * myStyleSheet.addRule(CSS_RULES[ix]);
163 public synchronized int addJobPane()
165 JScrollPane jobpane = new JScrollPane();
166 JComponent _progressText;
169 JEditorPane progressText = new JEditorPane("text/html", "");
170 progressText.addHyperlinkListener(this);
171 _progressText = progressText;
172 // progressText.setFont(new java.awt.Font("Verdana", 0, 10));
173 // progressText.setBorder(null);
174 progressText.setEditable(false);
176 * HTMLEditorKit myEditorKit = new HTMLEditorKit();
178 * StyleSheet myStyleSheet = getStyleSheet(myEditorKit);
180 * HTMLDocument tipDocument = (HTMLDocument)
181 * (myEditorKit.createDefaultDocument());
183 * progressText.setDocument(tipDocument);
184 */progressText.setText("<html><h1>WS Job</h1></html>");
188 JTextArea progressText = new JTextArea();
189 _progressText = progressText;
191 progressText.setFont(new java.awt.Font("Verdana", 0, 10));
192 progressText.setBorder(null);
193 progressText.setEditable(false);
194 progressText.setText("WS Job");
195 progressText.setLineWrap(true);
196 progressText.setWrapStyleWord(true);
198 jobpane.setName("JobPane");
199 jobpane.getViewport().add(_progressText, null);
200 jobpane.setBorder(null);
201 if (jobPanes == null)
203 jobPanes = new Vector();
205 int newpane = jobPanes.size();
206 jobPanes.add(jobpane);
210 this.add(jobpane, BorderLayout.CENTER);
216 // revert to a tabbed pane.
217 JScrollPane firstpane;
218 this.remove(firstpane = (JScrollPane) jobPanes.get(0));
219 subjobs = new JTabbedPane();
220 this.add(subjobs, BorderLayout.CENTER);
221 subjobs.add(firstpane);
222 subjobs.setTitleAt(0, firstpane.getName());
224 subjobs.add(jobpane);
226 return newpane; // index for accessor methods below
230 * Creates a new WebserviceInfo object.
233 * short name and job type
235 * reference or other human readable description
237 * true to display the webservices window immediatly (otherwise need
238 * to call setVisible(true))
240 public WebserviceInfo(String title, String info, boolean makeVisible)
242 init(title, info, 520, 500, makeVisible);
246 * Creates a new WebserviceInfo object.
257 public WebserviceInfo(String title, String info, int width, int height,
260 init(title, info, width, height, makeVisible);
266 * @return DOCUMENT ME!
268 public jalview.ws.WSClientI getthisService()
274 * Update state of GUI based on client capabilities (like whether the job is
275 * cancellable, whether the 'merge results' button is shown.
278 * service client to query for capabilities
280 public void setthisService(jalview.ws.WSClientI newservice)
282 thisService = newservice;
283 serviceIsCancellable = newservice.isCancellable();
284 frame.setClosable(!serviceIsCancellable);
285 serviceCanMergeResults = newservice.canMergeResults();
286 rebuildButtonPanel();
289 private void rebuildButtonPanel()
291 if (buttonPanel != null)
293 buttonPanel.removeAll();
294 if (serviceIsCancellable)
296 buttonPanel.add(cancel);
297 frame.setClosable(false);
301 frame.setClosable(true);
318 void init(String title, String info, int width, int height,
321 frame = new JInternalFrame();
322 frame.setContentPane(this);
323 Desktop.addInternalFrame(frame, title, makeVisible, width, height);
324 frame.setClosable(false);
326 progressBar = new ProgressBar(statusPanel, statusBar);
331 java.net.URL url = getClass().getResource(
332 "/images/Jalview_Logo_small.png");
333 image = java.awt.Toolkit.getDefaultToolkit().createImage(url);
335 MediaTracker mt = new MediaTracker(this);
336 mt.addImage(image, 0);
341 } catch (Exception ex)
345 AnimatedPanel ap = new AnimatedPanel();
346 titlePanel.add(ap, BorderLayout.CENTER);
348 Thread thread = new Thread(ap);
350 final WebserviceInfo thisinfo = this;
351 frame.addInternalFrameListener(new javax.swing.event.InternalFrameAdapter()
353 public void internalFrameClosed(
354 javax.swing.event.InternalFrameEvent evt)
356 // System.out.println("Shutting down webservice client");
357 WSClientI service = thisinfo.getthisService();
358 if (service != null && service.isCancellable())
372 * integer status from state constants
374 public void setStatus(int status)
376 currentStatus = status;
380 * subjob status indicator
385 public void setStatus(int jobpane, int status)
387 if (jobpane < 0 || jobpane >= jobPanes.size())
389 throw new Error(MessageManager.formatMessage(
390 "error.setstatus_called_non_existent_job_pane",
391 new String[] { Integer.valueOf(jobpane).toString() }));
396 setProgressName(jobpane + " - QUEUED", jobpane);
399 setProgressName(jobpane + " - RUNNING", jobpane);
401 case STATE_STOPPED_OK:
402 setProgressName(jobpane + " - FINISHED", jobpane);
404 case STATE_CANCELLED_OK:
405 setProgressName(jobpane + " - CANCELLED", jobpane);
407 case STATE_STOPPED_ERROR:
408 setProgressName(jobpane + " - BROKEN", jobpane);
410 case STATE_STOPPED_SERVERERROR:
411 setProgressName(jobpane + " - ALERT", jobpane);
414 setProgressName(jobpane + " - UNKNOWN STATE", jobpane);
421 * @return DOCUMENT ME!
423 public String getInfoText()
425 return infoText.getText();
434 public void setInfoText(String text)
436 infoText.setText(text);
445 public void appendInfoText(String text)
447 infoText.append(text);
453 * @return DOCUMENT ME!
455 public String getProgressText(int which)
457 if (jobPanes == null)
463 return ((JEditorPane) ((JScrollPane) jobPanes.get(which))
464 .getViewport().getComponent(0)).getText();
468 return ((JTextArea) ((JScrollPane) jobPanes.get(which)).getViewport()
469 .getComponent(0)).getText();
479 public void setProgressText(int which, String text)
481 if (jobPanes == null)
487 ((JEditorPane) ((JScrollPane) jobPanes.get(which)).getViewport()
488 .getComponent(0)).setText(ensureHtmlTagged(text));
492 ((JTextArea) ((JScrollPane) jobPanes.get(which)).getViewport()
493 .getComponent(0)).setText(text);
498 * extract content from <body> content </body>
502 * - set to leave the initial html tag intact
504 * - set to leave the final html tag intact
507 private String getHtmlFragment(String text, boolean leaveFirst,
514 String lowertxt = text.toLowerCase();
515 int htmlpos = leaveFirst ? -1 : lowertxt.indexOf("<body");
517 int htmlend = leaveLast ? -1 : lowertxt.indexOf("</body");
518 int htmlpose = lowertxt.indexOf(">", htmlpos), htmlende = lowertxt
519 .indexOf(">", htmlend);
520 if (htmlend == -1 && htmlpos == -1)
526 return text.substring((htmlpos == -1 ? 0 : htmlpose + 1), htmlend);
528 return text.substring(htmlpos == -1 ? 0 : htmlpose + 1);
532 * very simple routine for adding/ensuring html tags are present in text.
535 * @return properly html tag enclosed text
537 private String ensureHtmlTagged(String text)
543 String lowertxt = text.toLowerCase();
544 int htmlpos = lowertxt.indexOf("<body");
545 int htmlend = lowertxt.indexOf("</body");
546 int doctype = lowertxt.indexOf("<!doctype");
547 int xmltype = lowertxt.indexOf("<?xml");
550 text = text + "</body></html>";
554 if ((doctype > -1 && htmlpos > doctype)
555 || (xmltype > -1 && htmlpos > xmltype))
557 text = "<html><head></head><body>\n" + text.substring(htmlpos - 1);
562 text = "<html><head></head><body>\n" + text;
564 if (text.indexOf("<meta") > -1)
566 System.err.println("HTML COntent: \n" + text
567 + "<< END HTML CONTENT\n");
579 public void appendProgressText(int which, String text)
581 if (jobPanes == null)
587 String txt = getHtmlFragment(
588 ((JEditorPane) ((JScrollPane) jobPanes.get(which))
589 .getViewport().getComponent(0)).getText(), true,
591 ((JEditorPane) ((JScrollPane) jobPanes.get(which)).getViewport()
592 .getComponent(0)).setText(ensureHtmlTagged(txt
593 + getHtmlFragment(text, false, true)));
597 ((JTextArea) ((JScrollPane) jobPanes.get(which)).getViewport()
598 .getComponent(0)).append(text);
603 * setProgressText(0, text)
605 public void setProgressText(String text)
607 setProgressText(0, text);
611 * appendProgressText(0, text)
613 public void appendProgressText(String text)
615 appendProgressText(0, text);
621 public String getProgressText()
623 return getProgressText(0);
627 * get the tab title for a subjob
633 public String getProgressName(int which)
635 if (jobPanes == null)
641 return subjobs.getTitleAt(which);
645 return ((JScrollPane) jobPanes.get(which)).getViewport()
646 .getComponent(0).getName();
651 * set the tab title for a subjob
658 public void setProgressName(String name, int which)
662 subjobs.setTitleAt(which, name);
663 subjobs.revalidate();
666 JScrollPane c = (JScrollPane) jobPanes.get(which);
667 c.getViewport().getComponent(0).setName(name);
672 * Gui action for cancelling the current job, if possible.
677 protected void cancel_actionPerformed(ActionEvent e)
679 if (!serviceIsCancellable)
681 // JBPNote : TODO: We should REALLY just tell the WSClientI to cancel
682 // anyhow - it has to stop threads and clean up
683 // JBPNote : TODO: Instead of a warning, we should have an optional 'Are
687 .getString("warn.job_cannot_be_cancelled_close_window"),
688 MessageManager.getString("action.cancel_job"));
692 thisService.cancelJob();
694 frame.setClosable(true);
698 * Spawns a thread that pops up a warning dialog box with the given message
704 public void warnUser(final String message, final String title)
706 javax.swing.SwingUtilities.invokeLater(new Runnable()
710 JOptionPane.showInternalMessageDialog(Desktop.desktop, message,
711 title, JOptionPane.WARNING_MESSAGE);
718 * Set up GUI for user to get at results - and possibly automatically display
719 * them if viewResultsImmediatly is set.
721 public void setResultsReady()
723 frame.setClosable(true);
724 buttonPanel.remove(cancel);
725 buttonPanel.add(showResultsNewFrame);
726 if (serviceCanMergeResults)
728 buttonPanel.add(mergeResults);
729 buttonPanel.setLayout(new GridLayout(2, 1, 5, 5));
731 buttonPanel.validate();
733 if (viewResultsImmediatly)
735 showResultsNewFrame.doClick();
740 * called when job has finished but no result objects can be passed back to
743 public void setFinishedNoResults()
745 frame.setClosable(true);
746 buttonPanel.remove(cancel);
747 buttonPanel.validate();
751 class AnimatedPanel extends JPanel implements Runnable
755 BufferedImage offscreen;
759 startTime = System.currentTimeMillis();
761 while (currentStatus < STATE_STOPPED_OK)
767 int units = (int) ((System.currentTimeMillis() - startTime) / 10f);
770 startTime = System.currentTimeMillis();
772 if (currentStatus >= STATE_STOPPED_OK)
778 } catch (Exception ex)
783 cancel.setEnabled(false);
788 if (offscreen == null || offscreen.getWidth(this) != getWidth()
789 || offscreen.getHeight(this) != getHeight())
791 offscreen = new BufferedImage(getWidth(), getHeight(),
792 BufferedImage.TYPE_INT_ARGB);
795 Graphics2D g = (Graphics2D) offscreen.getGraphics();
797 g.setColor(Color.white);
798 g.fillRect(0, 0, getWidth(), getHeight());
800 g.setFont(new Font("Arial", Font.BOLD, 12));
801 g.setColor(Color.black);
803 switch (currentStatus)
807 title.concat(" - ").concat(
808 MessageManager.getString("label.state_queueing")),
815 title.concat(" - ").concat(
816 MessageManager.getString("label.state_running")),
821 case STATE_STOPPED_OK:
823 title.concat(" - ").concat(
824 MessageManager.getString("label.state_completed")),
829 case STATE_CANCELLED_OK:
831 title.concat(" - ").concat(
833 .getString("label.state_job_cancelled")),
838 case STATE_STOPPED_ERROR:
840 title.concat(" - ").concat(
841 MessageManager.getString("label.state_job_error")),
846 case STATE_STOPPED_SERVERERROR:
848 title.concat(" - ").concat(
850 .getString("label.server_error_try_later")),
858 int x = image.getWidth(this) / 2, y = image.getHeight(this) / 2;
859 g.rotate(Math.toRadians(angle), 10 + x, 10 + y);
860 g.drawImage(image, 10, 10, this);
861 g.rotate(-Math.toRadians(angle), 10 + x, 10 + y);
865 public void paintComponent(Graphics g1)
869 g1.drawImage(offscreen, 0, 0, this);
873 boolean renderAsHtml = false;
875 public void setRenderAsHtml(boolean b)
880 public void hyperlinkUpdate(HyperlinkEvent e)
882 Desktop.hyperlinkUpdate(e);
888 * @see jalview.gui.IProgressIndicator#setProgressBar(java.lang.String, long)
891 public void setProgressBar(String message, long id)
893 progressBar.setProgressBar(message, id);
897 public void registerHandler(final long id,
898 final IProgressIndicatorHandler handler)
900 progressBar.registerHandler(id, handler);
905 * @return true if any progress bars are still active
908 public boolean operationInProgress()
910 return progressBar.operationInProgress();