/* * Jalview - A Sequence Alignment Editor and Viewer (Version 2.7) * Copyright (C) 2011 J Procter, AM Waterhouse, J Engelhardt, LM Lui, G Barton, M Clamp, S Searle * * 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 . */ package jalview.ws.jws2; import java.awt.Color; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; import java.beans.PropertyChangeEvent; import java.beans.PropertyChangeListener; import java.io.Closeable; import java.net.ConnectException; import java.net.URL; import java.util.ArrayList; import java.util.HashSet; import java.util.Hashtable; import java.util.List; import java.util.StringTokenizer; import java.util.Vector; import javax.swing.JMenu; import javax.swing.JMenuItem; import javax.swing.event.MenuEvent; import javax.swing.event.MenuListener; import org.apache.log4j.Level; import jalview.bin.Cache; import jalview.datamodel.AlignmentView; import jalview.gui.AlignFrame; import jalview.gui.Desktop; import jalview.gui.JalviewChangeSupport; import jalview.gui.JvSwingUtils; import jalview.ws.WSMenuEntryProviderI; import jalview.ws.jws2.Jws2Discoverer.Jws2Instance; import jalview.ws.params.ParamDatastoreI; import compbio.data.msa.MsaWS; import compbio.metadata.Option; import compbio.metadata.Preset; import compbio.metadata.PresetManager; import compbio.metadata.RunnerConfig; import compbio.ws.client.Jws2Client; import compbio.ws.client.Services; /** * discoverer for jws2 services. Follows the lightweight service discoverer * pattern (archetyped by EnfinEnvision2OneWay) * * @author JimP * */ public class Jws2Discoverer implements Runnable, WSMenuEntryProviderI { private java.beans.PropertyChangeSupport changeSupport = new java.beans.PropertyChangeSupport( this); /** * change listeners are notified of "services" property changes * * @param listener * to be added that consumes new services Hashtable object. */ public void addPropertyChangeListener( java.beans.PropertyChangeListener listener) { changeSupport.addPropertyChangeListener(listener); } /** * * * @param listener * to be removed */ public void removePropertyChangeListener( java.beans.PropertyChangeListener listener) { changeSupport.removePropertyChangeListener(listener); } boolean running = false, aborted = false; /** * @return the aborted */ public boolean isAborted() { return aborted; } /** * @param aborted * the aborted to set */ public void setAborted(boolean aborted) { this.aborted = aborted; } Thread oldthread = null; public void run() { if (running && oldthread != null && oldthread.isAlive()) { if (!aborted) { return; } while (running) { try { Cache.log .debug("Waiting around for old discovery thread to finish."); // wait around until old discoverer dies Thread.sleep(100); } catch (Exception e) { } } Cache.log.debug("Old discovery thread has finished."); } running = true; oldthread = Thread.currentThread(); try { Class foo = getClass().getClassLoader().loadClass( "compbio.ws.client.Jws2Client"); } catch (ClassNotFoundException e) { System.err .println("Not enabling JABA Webservices : client jar is not available." + "\nPlease check that your webstart JNLP file is up to date!"); running = false; return; } // reinitialise records of good and bad service URLs if (services != null) { services.removeAllElements(); } if (urlsWithoutServices != null) { urlsWithoutServices.removeAllElements(); } if (invalidServiceUrls != null) { invalidServiceUrls.removeAllElements(); } List qrys = new ArrayList(); for (final String jwsservers : getServiceUrls()) { JabaWsServerQuery squery = new JabaWsServerQuery(this, jwsservers); qrys.add(squery); new Thread(squery).start(); } boolean finished = false; do { try { Thread.sleep(100); } catch (Exception e) { } ; for (JabaWsServerQuery squery : qrys) { finished |= !squery.isRunning(); } if (aborted) { Cache.log.debug("Aborting " + qrys.size() + " JABAWS discovery threads."); for (JabaWsServerQuery squery : qrys) { squery.setQuit(true); } } } while (!aborted && !finished); oldthread = null; running = false; if (!aborted) { changeSupport.firePropertyChange("services", new Vector(), services); } } /** * record this service endpoint so we can use it * * @param jwsservers * @param srv * @param service2 */ synchronized void addService(String jwsservers, Services srv, MsaWS service2) { if (services == null) { services = new Vector(); } System.out.println("Discovered service: " + jwsservers + " " + srv.toString()); Jws2Instance service = new Jws2Instance(jwsservers, srv.toString(), service2); services.add(service); // retrieve the presets and parameter set and cache now service.getParamStore().getPresets(); service.hasParameters(); } public class Jws2Instance { public String hosturl; public String serviceType; public MsaWS service; public Jws2Instance(String hosturl, String serviceType, MsaWS service) { super(); this.hosturl = hosturl; this.serviceType = serviceType; this.service = service; } PresetManager presets = null; public JabaParamStore paramStore = null; /** * non thread safe - gets the presets for this service (blocks whilst it * calls the service to get the preset set) * * @return service presets or null if exceptions were raised. */ public PresetManager getPresets() { if (presets == null) { try { presets = service.getPresets(); } catch (Exception ex) { System.err .println("Exception when retrieving presets for service " + serviceType + " at " + hosturl); } } return presets; } public String getHost() { return hosturl; /* * try { URL serviceurl = new URL(hosturl); if (serviceurl.getPort()!=80) * { return serviceurl.getHost()+":"+serviceurl.getPort(); } return * serviceurl.getHost(); } catch (Exception e) { * System.err.println("Failed to parse service URL '" + hosturl + * "' as a valid URL!"); } return null; */ } /** * @return short description of what the service will do */ public String getActionText() { return "Align with " + serviceType; } /** * non-thread safe - blocks whilst accessing service to get complete set of * available options and parameters * * @return */ public RunnerConfig getRunnerConfig() { return service.getRunnerOptions(); } @Override protected void finalize() throws Throwable { if (service != null) { try { Closeable svc = (Closeable) service; service = null; svc.close(); } catch (Exception e) { } ; } super.finalize(); } public ParamDatastoreI getParamStore() { if (paramStore == null) { try { paramStore = new JabaParamStore(this, (Desktop.instance != null ? Desktop .getUserParameterStore() : null)); } catch (Exception ex) { } } return paramStore; } public String getUri() { // this is only valid for Jaba 1.0 - this formula might have to change! return hosturl + (hosturl.lastIndexOf("/") == (hosturl.length() - 1) ? "" : "/") + serviceType; } private boolean hasParams = false, lookedForParams = false; public boolean hasParameters() { if (!lookedForParams) { lookedForParams = true; try { hasParams = (getRunnerConfig().getArguments().size() > 0); } catch (Exception e) { } } return hasParams; } }; /** * holds list of services. */ protected Vector services; public void attachWSMenuEntry(JMenu wsmenu, final AlignFrame alignFrame) { // dynamically regenerate service list. final JMenu jws2al = wsmenu; // new JMenu("JABAWS Alignment"); jws2al.addMenuListener(new MenuListener() { // TODO: future: add menu listener to parent menu - so submenus are // populated *before* they are selected. @Override public void menuSelected(MenuEvent e) { populateWSMenuEntry(jws2al, alignFrame); } @Override public void menuDeselected(MenuEvent e) { // TODO Auto-generated method stub } @Override public void menuCanceled(MenuEvent e) { // TODO Auto-generated method stub } }); wsmenu.add(jws2al); } private void populateWSMenuEntry(JMenu jws2al, final AlignFrame alignFrame) { if (running || services == null || services.size() == 0) { return; } boolean byhost = Cache.getDefault("WSMENU_BYHOST", false), bytype = Cache .getDefault("WSMENU_BYTYPE", false); /** * eventually, JWS2 services will appear under the same align/etc submenus. * for moment we keep them separate. */ JMenu atpoint; MsaWSClient msacl = new MsaWSClient(); Vector hostLabels = new Vector(); jws2al.removeAll(); String lasthost = null; Hashtable> hosts = new Hashtable>(); String[] sorton; for (Jws2Instance service : services) { ArrayList hostservices = hosts.get(service.getHost()); if (hostservices == null) { hosts.put(service.getHost(), hostservices = new ArrayList()); } hostservices.add(service); } sorton = hosts.keySet().toArray(new String[1]); String hostlist[] = sorton.clone(); jalview.util.QuickSort.sort(sorton, hostlist); for (String host : hostlist) { Jws2Instance orderedsvcs[] = hosts.get(host).toArray( new Jws2Instance[1]); String sortbytype[] = new String[orderedsvcs.length]; for (int i = 0; i < sortbytype.length; i++) { sortbytype[i] = orderedsvcs[i].serviceType; } jalview.util.QuickSort.sort(sortbytype, orderedsvcs); for (final Jws2Instance service : orderedsvcs) { atpoint = jws2al; String type = service.serviceType; if (byhost) { atpoint = JvSwingUtils.findOrCreateMenu(atpoint, host); if (atpoint.getToolTipText() == null) { atpoint.setToolTipText("Services at " + host); } } if (bytype) { atpoint = JvSwingUtils.findOrCreateMenu(atpoint, type); if (atpoint.getToolTipText() == null) { atpoint.setToolTipText(service.getActionText()); } } if (!byhost && !hostLabels.contains(host + service.serviceType + service.getActionText())) // !hostLabels.contains(host + (bytype ? // service.serviceType+service.getActionText() : ""))) { // add a marker indicating where this service is hosted // relies on services from the same host being listed in a // contiguous // group JMenuItem hitm; atpoint.addSeparator(); if (lasthost == null || !lasthost.equals(host)) { atpoint.add(hitm = new JMenuItem(host)); hitm.setForeground(Color.blue); hitm.addActionListener(new ActionListener() { @Override public void actionPerformed(ActionEvent e) { Desktop.showUrl(service.getHost()); } }); hitm.setToolTipText(JvSwingUtils .wrapTooltip("Opens the JABAWS server's homepage in web browser")); lasthost = host; } hostLabels.addElement(host + service.serviceType + service.getActionText()); // hostLabels.addElement(host + (bytype ? // service.serviceType+service.getActionText() : "")); } msacl.attachWSMenuEntry(atpoint, service, alignFrame); /* * JMenuItem sitem = new JMenuItem(service.serviceType); * sitem.setToolTipText("Hosted at " + service.hosturl); * sitem.addActionListener(new ActionListener() { * * @Override public void actionPerformed(ActionEvent e) { AlignmentView * msa = alignFrame.gatherSequencesForAlignment(); MsaWSClient client = * new MsaWSClient(service, "JWS2 Alignment of " + * alignFrame.getTitle(), msa, false, true, * alignFrame.getViewport().getAlignment().getDataset(), alignFrame); } * }); */ } } } public static void main(String[] args) { Thread runner = getDiscoverer().startDiscoverer( new PropertyChangeListener() { public void propertyChange(PropertyChangeEvent evt) { if (getDiscoverer().services != null) { System.out.println("Changesupport: There are now " + getDiscoverer().services.size() + " services"); } } }); while (runner.isAlive()) { try { Thread.sleep(50); } catch (InterruptedException e) { } ; } } private static Jws2Discoverer discoverer; public static Jws2Discoverer getDiscoverer() { if (discoverer == null) { discoverer = new Jws2Discoverer(); } return discoverer; } public boolean hasServices() { // TODO Auto-generated method stub return !running && services != null && services.size() > 0; } public boolean isRunning() { return running; } /** * the jalview .properties entry for JWS2 URLS */ final static String JWS2HOSTURLS = "JWS2HOSTURLS"; public static void setServiceUrls(Vector urls) { if (urls != null) { StringBuffer urlbuffer = new StringBuffer(); String sep = ""; for (String url : urls) { urlbuffer.append(sep); urlbuffer.append(url); sep = ","; } Cache.setProperty(JWS2HOSTURLS, urlbuffer.toString()); } else { Cache.removeProperty(JWS2HOSTURLS); } } public static Vector getServiceUrls() { String surls = Cache.getDefault(JWS2HOSTURLS, "http://www.compbio.dundee.ac.uk/jabaws"); Vector urls = new Vector(); try { StringTokenizer st = new StringTokenizer(surls, ","); while (st.hasMoreElements()) { String url = null; try { java.net.URL u = new java.net.URL(url = st.nextToken()); if (!urls.contains(url)) { urls.add(url); } else { jalview.bin.Cache.log.info("Ignoring duplicate url in " + JWS2HOSTURLS + " list"); } } catch (Exception ex) { jalview.bin.Cache.log .warn("Problem whilst trying to make a URL from '" + ((url != null) ? url : "") + "'"); jalview.bin.Cache.log .warn("This was probably due to a malformed comma separated list" + " in the " + JWS2HOSTURLS + " entry of $(HOME)/.jalview_properties)"); jalview.bin.Cache.log.debug("Exception was ", ex); } } } catch (Exception ex) { jalview.bin.Cache.log.warn( "Error parsing comma separated list of urls in " + JWS2HOSTURLS + " preference.", ex); } if (urls.size() >= 0) { return urls; } return null; } public Vector getServices() { return (services == null) ? new Vector() : new Vector(services); } /** * test the given URL with the JabaWS test code * * @param foo * @return */ public static boolean testServiceUrl(URL foo) { try { compbio.ws.client.WSTester.main(new String[] { "-h=" + foo.toString() }); } catch (Exception e) { e.printStackTrace(); return false; } catch (OutOfMemoryError e) { e.printStackTrace(); return false; } catch (Error e) { e.printStackTrace(); return false; } return true; } /** * Start a fresh discovery thread and notify the given object when we're * finished. Any known existing threads will be killed before this one is * started. * * @param changeSupport2 * @return new thread */ public Thread startDiscoverer(PropertyChangeListener changeSupport2) { if (isRunning()) { setAborted(true); } addPropertyChangeListener(changeSupport2); Thread thr = new Thread(this); thr.start(); return thr; } Vector invalidServiceUrls = null, urlsWithoutServices = null; /** * @return the invalidServiceUrls */ public Vector getInvalidServiceUrls() { return invalidServiceUrls; } /** * @return the urlsWithoutServices */ public Vector getUrlsWithoutServices() { return urlsWithoutServices; } /** * add an 'empty' JABA server to the list. Only servers not already in the * 'bad URL' list will be added to this list. * * @param jwsservers */ public synchronized void addUrlwithnoservices(String jwsservers) { if (urlsWithoutServices == null) { urlsWithoutServices = new Vector(); } if ((invalidServiceUrls == null || !invalidServiceUrls .contains(jwsservers)) && !urlsWithoutServices.contains(jwsservers)) { urlsWithoutServices.add(jwsservers); } } /** * add a bad URL to the list * * @param jwsservers */ public synchronized void addInvalidServiceUrl(String jwsservers) { if (invalidServiceUrls == null) { invalidServiceUrls = new Vector(); } if (!invalidServiceUrls.contains(jwsservers)) { invalidServiceUrls.add(jwsservers); } } /** * * @return a human readable report of any problems with the service URLs used * for discovery */ public String getErrorMessages() { if (!isRunning() && !isAborted()) { StringBuffer ermsg = new StringBuffer(); boolean list = false; if (getInvalidServiceUrls() != null && getInvalidServiceUrls().size() > 0) { ermsg.append("URLs that could not be contacted: \n"); for (String svcurl : getInvalidServiceUrls()) { if (list) { ermsg.append(", "); } list = true; ermsg.append(svcurl); } ermsg.append("\n\n"); } list = false; if (getUrlsWithoutServices() != null && getUrlsWithoutServices().size() > 0) { ermsg.append("URLs without any JABA Services : \n"); for (String svcurl : getUrlsWithoutServices()) { if (list) { ermsg.append(", "); } list = true; ermsg.append(svcurl); } ermsg.append("\n"); } if (ermsg.length() > 1) { return ermsg.toString(); } } return null; } }