X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fws%2Frest%2FRestJob.java;h=f0801277d05d0f985f7055a29c25a33e6616f3ce;hb=ab43013b7e357b84b4abade0dba949668dfb2a0e;hp=c7df4821460259059e7e453087f2570489489b6e;hpb=c762d9525db36ffd5d3fca49fb5e7d506d13401a;p=jalview.git diff --git a/src/jalview/ws/rest/RestJob.java b/src/jalview/ws/rest/RestJob.java index c7df482..f080127 100644 --- a/src/jalview/ws/rest/RestJob.java +++ b/src/jalview/ws/rest/RestJob.java @@ -1,15 +1,35 @@ +/* + * Jalview - A Sequence Alignment Editor and Viewer (Version 2.8.2b1) + * Copyright (C) 2014 The Jalview Authors + * + * 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 . + * The Jalview Authors are detailed in the 'AUTHORS' file. + */ package jalview.ws.rest; import java.util.ArrayList; import java.util.Collection; import java.util.Hashtable; import java.util.Map; -import java.util.Map.Entry; import java.util.Set; import java.util.Vector; +import jalview.datamodel.AlignmentAnnotation; import jalview.datamodel.AlignmentI; -import jalview.datamodel.AlignmentView; +import jalview.datamodel.AlignmentOrder; import jalview.datamodel.SequenceGroup; import jalview.datamodel.SequenceI; import jalview.io.packed.JalviewDataset; @@ -19,69 +39,127 @@ import jalview.ws.rest.params.SeqGroupIndexVector; public class RestJob extends AWsJob { - + // TODO: input alignmentview and other data for this job RestServiceDescription rsd; + // boolean submitted; boolean gotresponse; + boolean error; + boolean waiting; + boolean gotresult; + Hashtable squniq; - + + /** + * dataset associated with this input data. + */ + AlignmentI dsForIO; + + AlignmentOrder inputOrder; + /** - * create a rest job using data bounded by the given start/end column. + * context of input data with respect to an AlignmentView's visible contigs. + */ + int[] origviscontig; + + private AlignmentI contextAl = null; + + /** + * create a rest job using data bounded by the given start/end column. + * * @param addJobPane * @param restJobThread * @param _input + * @param viscontigs + * visible contigs of an alignment view from which _input was derived */ public RestJob(int jobNum, RestJobThread restJobThread, - AlignmentI _input) + AlignmentI _input, int[] viscontigs) { rsd = restJobThread.restClient.service; jobnum = jobNum; + if (viscontigs != null) + { + origviscontig = new int[viscontigs.length]; + System.arraycopy(viscontigs, 0, origviscontig, 0, viscontigs.length); + } // get sequences for the alignmentI // get groups trimmed to alignment columns // get any annotation trimmed to start/end columns, too. - + squniq = jalview.analysis.SeqsetUtils.uniquify( + _input.getSequencesArray(), true); // prepare input - // form alignment+groups+annotation,preprocess and then record references for formatters + // form alignment+groups+annotation,preprocess and then record references + // for formatters ArrayList alinp = new ArrayList(); - int paramsWithData=0; - // we cheat for moment - since we know a-priori what data is available and what inputs we have implemented so far - for (Map.Entryprm: rsd.inputParams.entrySet()) + int paramsWithData = 0; + // TODO: JAL-715 - generalise the following validation logic for all + // parameter types + // we cheat for moment - since we know a-priori what data is available and + // what inputs we have implemented so far + for (Map.Entry prm : rsd.inputParams.entrySet()) { if (!prm.getValue().isConstant()) { if (prm.getValue() instanceof Alignment) - { - alinp.add(prm.getValue()); - } else - { - if ((prm.getValue() instanceof SeqGroupIndexVector) - &&(_input.getGroups()!=null && _input.getGroups().size()>0)) { alinp.add(prm.getValue()); } - } - } else { + else + { + if (prm.getValue() instanceof SeqGroupIndexVector + && _input.getGroups() != null + && _input.getGroups().size() >= -1 + prm.getValue().min) + { + // the test above is not rigorous but fixes JAL-1298, since + // submission will fail if the partition set doesn't contain at + // least one partition + alinp.add(prm.getValue()); + } + else + { + statMessage = ("Not enough groups defined on the alignment - need at least " + prm + .getValue().min); + } + } + } + else + { paramsWithData++; } } - if ((paramsWithData+alinp.size())==rsd.inputParams.size()) + if ((paramsWithData + alinp.size()) == rsd.inputParams.size()) { + inputOrder = new AlignmentOrder(_input); + if ((dsForIO = _input.getDataset()) == null) + { + _input.setDataset(null); + } + dsForIO = _input.getDataset(); + if (contextAl == null) + { + contextAl = _input; + } setAlignmentForInputs(alinp, _input); - validInput=true; - } else { + validInput = true; + } + else + { // not enough data, so we bail. - validInput=false; + validInput = false; } } - boolean validInput=false; + + boolean validInput = false; + @Override public boolean hasResults() { - return gotresult; + return gotresult && (parsedResults ? validJvresults : true); } @Override @@ -93,7 +171,8 @@ public class RestJob extends AWsJob @Override public boolean isRunning() { - return running; // TODO: can we check the response body for status messages ? + return running; // TODO: can we check the response body for status messages + // ? } @Override @@ -105,7 +184,7 @@ public class RestJob extends AWsJob @Override public boolean isFinished() { - return resSet!=null; + return resSet != null; } @Override @@ -136,6 +215,7 @@ public class RestJob extends AWsJob } protected String statMessage = null; + public HttpResultSet resSet; @Override @@ -147,34 +227,37 @@ public class RestJob extends AWsJob @Override public boolean hasResponse() { - return statMessage!=null || resSet!=null; + return statMessage != null || resSet != null; } @Override public void clearResponse() { - // only clear the transient server response + // only clear the transient server response // statMessage=null; } - /* (non-Javadoc) + /* + * (non-Javadoc) + * * @see jalview.ws.AWsJob#getState() */ @Override public String getState() { - // TODO generate state string - prolly should have a default abstract method for this + // TODO generate state string - prolly should have a default abstract method + // for this return "Job is clueless"; } public String getPostUrl() { - + // TODO Auto-generated method stub return rsd.postUrl; } - public Set> getInputParams() + public Set> getInputParams() { return rsd.inputParams.entrySet(); } @@ -187,30 +270,58 @@ public class RestJob extends AWsJob /** * - * @return new context for parsing results from service + * @return the context for parsing results from service */ public JalviewDataset newJalviewDataset() { - /* - * TODO: initialise dataset with correct input context - */ - JalviewDataset njd = new JalviewDataset(); - return njd; + if (context == null) + { + context = new JalviewDataset(dsForIO, null, squniq, null); + if (contextAl != null) + { + // TODO devise way of merging new annotation onto (identical) existing + // annotation that was used as input + // delete all input annotation + if (contextAl.getAlignmentAnnotation() != null) + { + for (AlignmentAnnotation alan : contextAl + .getAlignmentAnnotation()) + { + contextAl.deleteAnnotation(alan); + } + } + // TODO devise way of merging new groups onto (identical) existing + // groups when they were used as input to service + // delete all existing groups + if (contextAl.getGroups() != null) + { + contextAl.deleteAllGroups(); + } + context.addAlignment(contextAl); + } + + } + return context; } /** - * Extract list of sequence IDs for input parameter 'token' with given molecule type + * Extract list of sequence IDs for input parameter 'token' with given + * molecule type + * * @param token * @param type * @return */ - public SequenceI[] getSequencesForInput(String token, InputType.molType type) throws NoValidInputDataException + public SequenceI[] getSequencesForInput(String token, + InputType.molType type) throws NoValidInputDataException { Object sgdat = inputData.get(token); // can we form an alignment from this data ? - if (sgdat==null) + if (sgdat == null) { - throw new NoValidInputDataException("No Sequence vector data bound to input '"+token+"' for service at "+rsd.postUrl); + throw new NoValidInputDataException( + "No Sequence vector data bound to input '" + token + + "' for service at " + rsd.postUrl); } if (sgdat instanceof AlignmentI) { @@ -218,49 +329,61 @@ public class RestJob extends AWsJob } if (sgdat instanceof SequenceGroup) { - return ((SequenceGroup)sgdat).getSequencesAsArray(null); + return ((SequenceGroup) sgdat).getSequencesAsArray(null); } if (sgdat instanceof Vector) { - if (((Vector)sgdat).size()>0 && ((Vector)sgdat).get(0) instanceof SequenceI) + if (((Vector) sgdat).size() > 0 + && ((Vector) sgdat).get(0) instanceof SequenceI) { - SequenceI[] sq = new SequenceI[((Vector)sgdat).size()]; - ((Vector)sgdat).copyInto(sq); + SequenceI[] sq = new SequenceI[((Vector) sgdat).size()]; + ((Vector) sgdat).copyInto(sq); return sq; } } - throw new NoValidInputDataException("No Sequence vector data bound to input '"+token+"' for service at "+rsd.postUrl); + throw new NoValidInputDataException( + "No Sequence vector data bound to input '" + token + + "' for service at " + rsd.postUrl); } + /** - * binding between input data (AlignmentI, SequenceGroup, NJTree) and input param names. + * binding between input data (AlignmentI, SequenceGroup, NJTree) and input + * param names. */ - private Hashtable inputData=new Hashtable(); + private Hashtable inputData = new Hashtable(); + /** * is the job fully submitted to server and apparently in progress ? */ - public boolean running=false; + public boolean running = false; + /** * * @param itypes - * @param al - reference to object to be stored as input. Note - input data may be modifed by formatter + * @param al + * - reference to object to be stored as input. Note - input data may + * be modifed by formatter */ - public void setAlignmentForInputs(Collection itypes, AlignmentI al) + public void setAlignmentForInputs(Collection itypes, + AlignmentI al) { - for (InputType itype: itypes) { + for (InputType itype : itypes) + { if (!rsd.inputParams.values().contains(itype)) { - throw new IllegalArgumentException("InputType "+itype.getClass()+ - " is not valid for service at "+rsd.postUrl); + throw new IllegalArgumentException("InputType " + itype.getClass() + + " is not valid for service at " + rsd.postUrl); } if (itype instanceof AlignmentProcessor) { - ((AlignmentProcessor)itype).prepareAlignment(al); + ((AlignmentProcessor) itype).prepareAlignment(al); } // stash a reference for recall when the alignment data is formatted inputData.put(itype.token, al); } - + } + /** * * @param token @@ -268,30 +391,102 @@ public class RestJob extends AWsJob * @return alignment object bound to the given token * @throws NoValidInputDataException */ - public AlignmentI getAlignmentForInput(String token, InputType.molType type) throws NoValidInputDataException + public AlignmentI getAlignmentForInput(String token, + InputType.molType type) throws NoValidInputDataException { Object al = inputData.get(token); // can we form an alignment from this data ? - if (al==null || !(al instanceof AlignmentI)) + if (al == null || !(al instanceof AlignmentI)) { - throw new NoValidInputDataException("No alignment data bound to input '"+token+"' for service at "+rsd.postUrl); + throw new NoValidInputDataException( + "No alignment data bound to input '" + token + + "' for service at " + rsd.postUrl); } return (AlignmentI) al; } /** * test to see if the job has data of type cl that's needed for the job to run + * * @param cl * @return true or false */ public boolean hasDataOfType(Class cl) { - if (AlignmentI.class.isAssignableFrom(cl)) { + if (AlignmentI.class.isAssignableFrom(cl)) + { return true; } - // TODO: add more source data types - + // TODO: add more source data types + + return false; + } + + /** + * context used to parse results from service + */ + JalviewDataset context = null; + + protected boolean parsedResults = false; + + protected boolean validJvresults = false; + + Object[] jvresultobj = null; + + /** + * process the results obtained from the server into jalview datamodel objects + * ready to be merged/added to the users' view. Use hasResults to test if + * results were added to context. + */ + public void parseResultSet() throws Exception, Error + { + if (!parsedResults) + { + parsedResults = true; + jvresultobj = resSet.parseResultSet(); + validJvresults = true; + } + } + + /** + * + * @return true if job has an input alignment and it was annotated when + * results were parsed + */ + public boolean isInputContextModified() + { + return contextAl != null && validJvresults + && context.getAl().get(0).isModified(); + } + + /** + * + * @return true if the ID/metadata for the input sequences were saved and + * sequence IDs renamed. + */ + public boolean isInputUniquified() + { + // TODO Auto-generated method stub return false; } + /** + * Return map between ordering of alignment submitted as input, and ordering + * of alignment as provided by user + * + * @return int[sequence index in submitted data]==sequence index in input. + */ + public int[] getOrderMap() + { + SequenceI[] contseq = contextAl.getSequencesArray(); + int map[] = new int[contseq.length]; + for (int i = 0; i < contseq.length; i++) + { + // TODO: optimise for large N - build a lookup hash for IDs returning + // order, and then lookup each sequ's original order + map[i] = inputOrder.getOrder().indexOf(contseq[i]); + } + return map; + } + }