+\r
+ String addProtocol(String file)\r
+ {\r
+ if (file.indexOf("://") == -1)\r
+ {\r
+ String fl = applet.getDocumentBase() + file;\r
+ try\r
+ {\r
+ if (new java.net.URL(fl).openStream() != null)\r
+ {\r
+ if (debug)\r
+ {\r
+ System.err.println("Prepended document base for resource: '"\r
+ + file + "'");\r
+ }\r
+ return fl;\r
+ }\r
+ } catch (Exception x)\r
+ {\r
+ }\r
+ ;\r
+ fl = applet.getCodeBase() + file;\r
+ try\r
+ {\r
+ if (new java.net.URL(fl).openStream() != null)\r
+ {\r
+ if (debug)\r
+ {\r
+ if (debug)\r
+ {\r
+ System.err.println("Prepended codebase for resource: '"\r
+ + file + "'");\r
+ }\r
+ return fl;\r
+ }\r
+ }\r
+ } catch (Exception x)\r
+ {\r
+ }\r
+ ;\r
+\r
+ }\r
+\r
+ return file;\r
+ }\r
+ }\r
+\r
+ /**\r
+ * @return the default alignFrame acted on by the public applet methods. May\r
+ * return null with an error message on System.err indicating the\r
+ * fact.\r
+ */\r
+ public AlignFrame getDefaultTargetFrame()\r
+ {\r
+ if (currentAlignFrame != null)\r
+ {\r
+ return currentAlignFrame;\r
+ }\r
+ if (initialAlignFrame != null)\r
+ {\r
+ return initialAlignFrame;\r
+ }\r
+ System.err\r
+ .println("Implementation error: Jalview Applet API cannot work out which AlignFrame to use.");\r
+ return null;\r
+ }\r
+\r
+ /**\r
+ * separator used for separatorList\r
+ */\r
+ protected String separator = "" + ((char) 0x00AC); // the default used to be\r
+ // '|' but many sequence\r
+ // IDS include pipes.\r
+\r
+ /**\r
+ * set to enable the URL based javascript execution mechanism \r
+ */\r
+ public boolean jsfallbackEnabled=false;\r
+\r
+ /**\r
+ * parse the string into a list\r
+ * \r
+ * @param list\r
+ * @return elements separated by separator\r
+ */\r
+ public String[] separatorListToArray(String list)\r
+ {\r
+ return separatorListToArray(list, separator);\r
+ }\r
+\r
+ /**\r
+ * parse the string into a list\r
+ * \r
+ * @param list\r
+ * @param separator\r
+ * @return elements separated by separator\r
+ */\r
+ public String[] separatorListToArray(String list, String separator)\r
+ {\r
+ // note separator local variable intentionally masks object field\r
+ int seplen = separator.length();\r
+ if (list == null || list.equals("") || list.equals(separator))\r
+ return null;\r
+ java.util.Vector jv = new Vector();\r
+ int cp = 0, pos;\r
+ while ((pos = list.indexOf(separator, cp)) > cp)\r
+ {\r
+ jv.addElement(list.substring(cp, pos));\r
+ cp = pos + seplen;\r
+ }\r
+ if (cp < list.length())\r
+ {\r
+ String c = list.substring(cp);\r
+ if (!c.equals(separator))\r
+ {\r
+ jv.addElement(c);\r
+ }\r
+ }\r
+ if (jv.size() > 0)\r
+ {\r
+ String[] v = new String[jv.size()];\r
+ for (int i = 0; i < v.length; i++)\r
+ {\r
+ v[i] = (String) jv.elementAt(i);\r
+ }\r
+ jv.removeAllElements();\r
+ if (debug)\r
+ {\r
+ System.err.println("Array from '" + separator\r
+ + "' separated List:\n" + v.length);\r
+ for (int i = 0; i < v.length; i++)\r
+ {\r
+ System.err.println("item " + i + " '" + v[i] + "'");\r
+ }\r
+ }\r
+ return v;\r
+ }\r
+ if (debug)\r
+ {\r
+ System.err.println("Empty Array from '" + separator\r
+ + "' separated List");\r
+ }\r
+ return null;\r
+ }\r
+\r
+ /**\r
+ * concatenate the list with separator\r
+ * \r
+ * @param list\r
+ * @return concatenated string\r
+ */\r
+ public String arrayToSeparatorList(String[] list)\r
+ {\r
+ return arrayToSeparatorList(list, separator);\r
+ }\r
+\r
+ /**\r
+ * concatenate the list with separator\r
+ * \r
+ * @param list\r
+ * @param separator\r
+ * @return concatenated string\r
+ */\r
+ public String arrayToSeparatorList(String[] list, String separator)\r
+ {\r
+ StringBuffer v = new StringBuffer();\r
+ if (list != null && list.length > 0)\r
+ {\r
+ for (int i = 0, iSize = list.length; i < iSize; i++)\r
+ {\r
+ if (list[i] != null)\r
+ {\r
+ if (i > 0)\r
+ {\r
+ v.append(separator);\r
+ }\r
+ v.append(list[i]);\r
+ }\r
+ }\r
+ if (debug)\r
+ {\r
+ System.err.println("Returning '" + separator\r
+ + "' separated List:\n");\r
+ System.err.println(v);\r
+ }\r
+ return v.toString();\r
+ }\r
+ if (debug)\r
+ {\r
+ System.err.println("Returning empty '" + separator\r
+ + "' separated List\n");\r
+ }\r
+ return "" + separator;\r
+ }\r
+\r
+ /* (non-Javadoc)\r
+ * @see jalview.bin.JalviewLiteJsApi#getFeatureGroups()\r
+ */\r
+ public String getFeatureGroups()\r
+ {\r
+ String lst = arrayToSeparatorList(getDefaultTargetFrame()\r
+ .getFeatureGroups());\r
+ return lst;\r
+ }\r
+\r
+ /* (non-Javadoc)\r
+ * @see jalview.bin.JalviewLiteJsApi#getFeatureGroupsOn(jalview.appletgui.AlignFrame)\r
+ */\r
+ public String getFeatureGroupsOn(AlignFrame alf)\r
+ {\r
+ String lst = arrayToSeparatorList(alf.getFeatureGroups());\r
+ return lst;\r
+ }\r
+\r
+ /* (non-Javadoc)\r
+ * @see jalview.bin.JalviewLiteJsApi#getFeatureGroupsOfState(boolean)\r
+ */\r
+ public String getFeatureGroupsOfState(boolean visible)\r
+ {\r
+ return arrayToSeparatorList(getDefaultTargetFrame()\r
+ .getFeatureGroupsOfState(visible));\r
+ }\r
+\r
+ /* (non-Javadoc)\r
+ * @see jalview.bin.JalviewLiteJsApi#getFeatureGroupsOfStateOn(jalview.appletgui.AlignFrame, boolean)\r
+ */\r
+ public String getFeatureGroupsOfStateOn(AlignFrame alf, boolean visible)\r
+ {\r
+ return arrayToSeparatorList(alf.getFeatureGroupsOfState(visible));\r
+ }\r
+\r
+ /* (non-Javadoc)\r
+ * @see jalview.bin.JalviewLiteJsApi#setFeatureGroupStateOn(jalview.appletgui.AlignFrame, java.lang.String, boolean)\r
+ */\r
+ public void setFeatureGroupStateOn(AlignFrame alf, String groups,\r
+ boolean state)\r
+ {\r
+ boolean st = state;// !(state==null || state.equals("") ||\r
+ // state.toLowerCase().equals("false"));\r
+ alf.setFeatureGroupState(separatorListToArray(groups), st);\r
+ }\r
+\r
+ /* (non-Javadoc)\r
+ * @see jalview.bin.JalviewLiteJsApi#setFeatureGroupState(java.lang.String, boolean)\r
+ */\r
+ public void setFeatureGroupState(String groups, boolean state)\r
+ {\r
+ setFeatureGroupStateOn(getDefaultTargetFrame(), groups, state);\r
+ }\r
+\r
+ /* (non-Javadoc)\r
+ * @see jalview.bin.JalviewLiteJsApi#getSeparator()\r
+ */\r
+ public String getSeparator()\r
+ {\r
+ return separator;\r
+ }\r
+\r
+ /* (non-Javadoc)\r
+ * @see jalview.bin.JalviewLiteJsApi#setSeparator(java.lang.String)\r
+ */\r
+ public void setSeparator(String separator)\r
+ {\r
+ if (separator == null || separator.length() < 1)\r
+ {\r
+ // reset to default\r
+ separator = "" + ((char) 0x00AC);\r
+ }\r
+ this.separator = separator;\r
+ if (debug)\r
+ {\r
+ System.err.println("Default Separator now: '" + separator + "'");\r
+ }\r
+ }\r
+\r
+ /**\r
+ * get boolean value of applet parameter 'name' and return default if\r
+ * parameter is not set\r
+ * \r
+ * @param name\r
+ * name of paremeter\r
+ * @param def\r
+ * the value to return otherwise\r
+ * @return true or false\r
+ */\r
+ public boolean getDefaultParameter(String name, boolean def)\r
+ {\r
+ String stn;\r
+ if ((stn = getParameter(name)) == null)\r
+ {\r
+ return def;\r
+ }\r
+ if (stn.toLowerCase().equals("true"))\r
+ {\r
+ return true;\r
+ }\r
+ return false;\r
+ }\r
+\r
+ /* (non-Javadoc)\r
+ * @see jalview.bin.JalviewLiteJsApi#addPdbFile(jalview.appletgui.AlignFrame, java.lang.String, java.lang.String, java.lang.String)\r
+ */\r
+ public boolean addPdbFile(AlignFrame alFrame, String sequenceId,\r
+ String pdbEntryString, String pdbFile)\r
+ {\r
+ return alFrame.addPdbFile(sequenceId, pdbEntryString, pdbFile);\r
+ }\r
+\r
+ protected void setAlignPdbStructures(boolean alignPdbStructures)\r
+ {\r
+ this.alignPdbStructures = alignPdbStructures;\r
+ }\r
+\r
+ public boolean isAlignPdbStructures()\r
+ {\r
+ return alignPdbStructures;\r
+ }\r
+\r
+ public void start()\r
+ {\r
+// callInitCallback();\r
+ }\r
+ private Hashtable<String,long[]> jshashes=new Hashtable<String,long[]>();\r
+ private Hashtable<String,Hashtable<String,String[]>> jsmessages=new Hashtable<String,Hashtable<String,String[]>>();\r
+ public void setJsMessageSet(String messageclass, String viewId,\r
+ String[] colcommands)\r
+ {\r
+ Hashtable<String,String[]> msgset = jsmessages.get(messageclass);\r
+ if (msgset==null)\r
+ {\r
+ msgset=new Hashtable<String,String[]>();\r
+ jsmessages.put(messageclass, msgset);\r
+ }\r
+ msgset.put(viewId, colcommands);\r
+ long[] l = new long[colcommands.length];\r
+ for (int i=0;i<colcommands.length;i++) { l[i] = colcommands[i].hashCode();}\r
+ jshashes.put(messageclass+"|"+viewId,l);\r
+ }\r
+ /* (non-Javadoc)\r
+ * @see jalview.bin.JalviewLiteJsApi#getJsMessage(java.lang.String, java.lang.String)\r
+ */\r
+ public String getJsMessage(String messageclass, String viewId)\r
+ {\r
+ Hashtable<String,String[]> msgset = jsmessages.get(messageclass);\r
+ if (msgset!=null)\r
+ {\r
+ String[] msgs = msgset.get(viewId);\r
+ if (msgs!=null)\r
+ {\r
+ for (int i=0;i<msgs.length;i++) {\r
+ if (msgs[i]!=null) {\r
+ String m = msgs[i];\r
+ msgs[i]=null;\r
+ return m;\r
+ }\r
+ }\r
+ }\r
+ }\r
+ return "";\r
+ }\r
+\r
+ public boolean isJsMessageSetChanged(String string, String string2,\r
+ String[] colcommands)\r
+ {\r
+ long[] l=jshashes.get(string+"|"+string2);\r
+ if (l==null && colcommands!=null)\r
+ {\r
+ return true;\r
+ }\r
+ for (int i=0;i<colcommands.length;i++) { if (l[i] != colcommands[i].hashCode()) { return true; }}\r
+ return false;\r
+ }\r
+\r
+ private Vector jsExecQueue=new Vector();\r
+ public Vector getJsExecQueue()\r
+ {\r
+ return jsExecQueue;\r
+ }\r
+\r
+ public void setExecutor(JSFunctionExec jsFunctionExec2)\r
+ {\r
+ jsFunctionExec=jsFunctionExec2;\r
+ }\r
+\r
+ /**\r
+ * return the given colour value parameter or the given default if parameter not given\r
+ * @param colparam\r
+ * @param defcolour\r
+ * @return\r
+ */\r
+ public Color getDefaultColourParameter(String colparam, Color defcolour)\r
+ {\r
+ String colprop = getParameter(colparam);\r
+ if (colprop==null || colprop.trim().length()==0)\r
+ {\r
+ return defcolour;\r
+ }\r
+ Color col = jalview.schemes.ColourSchemeProperty.getAWTColorFromName(colprop);\r
+ if (col==null)\r
+ {\r
+ try {\r
+ col = new jalview.schemes.UserColourScheme(colprop).findColour('A');\r
+ } catch (Exception ex)\r
+ {\r
+ System.err.println("Couldn't parse '"+colprop+"' as a colour for "+colparam);\r
+ col=null;\r
+ }\r
+ }\r
+ return (col==null) ? defcolour: col;\r
+\r
+ }\r
+\r
+ /**\r
+ * bind structures in a viewer to any matching sequences in an alignFrame (use\r
+ * sequenceIds to limit scope of search to specific sequences)\r
+ * \r
+ * @param alFrame\r
+ * @param viewer\r
+ * @param sequenceIds\r
+ * @return TODO: consider making an exception structure for indicating when\r
+ * binding fails public SequenceStructureBinding\r
+ * addStructureViewInstance( AlignFrame alFrame, Object viewer, String\r
+ * sequenceIds) {\r
+ * \r
+ * if (sequenceIds != null && sequenceIds.length() > 0) { return\r
+ * alFrame.addStructureViewInstance(viewer,\r
+ * separatorListToArray(sequenceIds)); } else { return\r
+ * alFrame.addStructureViewInstance(viewer, null); } // return null; }\r
+ */\r