webservices/compbio/ws/server/MafftWS.java

   1 /* Copyright (c) 2009 Peter Troshin\r
   2  *  \r
   3  *  JAva Bioinformatics Analysis Web Services (JABAWS) @version: 1.0  \r
   4  * \r
   5  *  This library is free software; you can redistribute it and/or modify it under the terms of the\r
   6  *  Apache License version 2 as published by the Apache Software Foundation\r
   7  * \r
   8  *  This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without\r
   9  *  even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Apache \r
  10  *  License for more details.\r
  11  * \r
  12  *  A copy of the license is in apache_license.txt. It is also available here:\r
  13  * @see: http://www.apache.org/licenses/LICENSE-2.0.txt\r
  14  * \r
  15  * Any republication or derived work distributed in source code form\r
  16  * must include this copyright and license notice.\r
  17  */\r
  18 \r
  19 package compbio.ws.server;\r
  20 \r
  21 import java.io.File;\r
  22 import java.util.List;\r
  23 \r
  24 import javax.annotation.Resource;\r
  25 import javax.jws.WebService;\r
  26 import javax.xml.ws.WebServiceContext;\r
  27 \r
  28 import org.apache.log4j.Logger;\r
  29 \r
  30 import compbio.data.msa.MsaWS;\r
  31 import compbio.data.sequence.Alignment;\r
  32 import compbio.data.sequence.FastaSequence;\r
  33 import compbio.engine.AsyncExecutor;\r
  34 import compbio.engine.Configurator;\r
  35 import compbio.engine.client.ConfiguredExecutable;\r
  36 import compbio.metadata.ChunkHolder;\r
  37 import compbio.metadata.JobStatus;\r
  38 import compbio.metadata.JobSubmissionException;\r
  39 import compbio.metadata.Limit;\r
  40 import compbio.metadata.LimitsManager;\r
  41 import compbio.metadata.Option;\r
  42 import compbio.metadata.Preset;\r
  43 import compbio.metadata.PresetManager;\r
  44 import compbio.metadata.ResultNotAvailableException;\r
  45 import compbio.metadata.RunnerConfig;\r
  46 import compbio.metadata.WrongParameterException;\r
  47 import compbio.runner.Util;\r
  48 import compbio.runner.msa.Mafft;\r
  49 \r
  50 @WebService(endpointInterface = "compbio.data.msa.MsaWS", targetNamespace = "http://msa.data.compbio/01/01/2010/", serviceName = "MafftWS")\r
  51 public class MafftWS implements MsaWS<Mafft> {\r
  52 \r
  53     // Ask for resource injection\r
  54     @Resource\r
  55     WebServiceContext wsContext;\r
  56 \r
  57     private static Logger statLog = Logger.getLogger("MafftWS-stats");\r
  58 \r
  59     private static Logger log = Logger.getLogger(MafftWS.class);\r
  60 \r
  61     private static final RunnerConfig<Mafft> mafftOptions = Util\r
  62             .getSupportedOptions(Mafft.class);\r
  63 \r
  64     private static final PresetManager<Mafft> mafftPresets = Util\r
  65             .getPresets(Mafft.class);\r
  66 \r
  67     @Override\r
  68     public String align(List<FastaSequence> sequences)\r
  69             throws JobSubmissionException {\r
  70         WSUtil.validateFastaInput(sequences);\r
  71         ConfiguredExecutable<Mafft> confMafft = init(sequences);\r
  72         return WSUtil.align(sequences, confMafft, null, "align", getLimit(""));\r
  73     }\r
  74 \r
  75     ConfiguredExecutable<Mafft> init(List<FastaSequence> dataSet)\r
  76             throws JobSubmissionException {\r
  77         Mafft mafft = new Mafft();\r
  78         mafft.setInput("fasta.in").setOutput("fasta.out");\r
  79         return Configurator.configureExecutable(mafft, dataSet);\r
  80     }\r
  81 \r
  82     @Override\r
  83     public String customAlign(List<FastaSequence> sequences,\r
  84             List<Option<Mafft>> options) throws JobSubmissionException,\r
  85             WrongParameterException {\r
  86         WSUtil.validateFastaInput(sequences);\r
  87         ConfiguredExecutable<Mafft> confMafft = init(sequences);\r
  88         List<String> params = WSUtil.getCommands(options,\r
  89                 Mafft.KEY_VALUE_SEPARATOR);\r
  90         log.info("Setting parameters: " + params);\r
  91         confMafft.addParameters(params);\r
  92         return WSUtil.align(sequences, confMafft, null, "customAlign",\r
  93                 getLimit(""));\r
  94     }\r
  95 \r
  96     @Override\r
  97     public String presetAlign(List<FastaSequence> sequences,\r
  98             Preset<Mafft> preset) throws JobSubmissionException,\r
  99             WrongParameterException {\r
 100         WSUtil.validateFastaInput(sequences);\r
 101         if (preset == null) {\r
 102             throw new WrongParameterException("Preset must be provided!");\r
 103         }\r
 104         ConfiguredExecutable<Mafft> confMafft = init(sequences);\r
 105         confMafft.addParameters(preset.getOptions());\r
 106         // This will return default limit if a specific the limit for a\r
 107         // particular preset is not found\r
 108         Limit<Mafft> limit = getLimit(preset.getName());\r
 109 \r
 110         return WSUtil.align(sequences, confMafft, null, "presetAlign", limit);\r
 111     }\r
 112 \r
 113     @SuppressWarnings("unchecked")\r
 114     @Override\r
 115     public Alignment getResult(String jobId) throws ResultNotAvailableException {\r
 116         WSUtil.validateJobId(jobId);\r
 117         AsyncExecutor asyncEngine = Configurator.getAsyncEngine(jobId);\r
 118         ConfiguredExecutable<Mafft> mafft = (ConfiguredExecutable<Mafft>) asyncEngine\r
 119                 .getResults(jobId);\r
 120         Alignment al = mafft.getResults();\r
 121         //log(jobId, "getResults");\r
 122         return al;\r
 123     }\r
 124 \r
 125     @Override\r
 126     public Limit<Mafft> getLimit(String presetName) {\r
 127         return new Mafft().getLimit(presetName);\r
 128     }\r
 129 \r
 130     @Override\r
 131     public LimitsManager<Mafft> getLimits() {\r
 132         return new Mafft().getLimits();\r
 133     }\r
 134 \r
 135     @Override\r
 136     public ChunkHolder pullExecStatistics(String jobId, long position) {\r
 137         WSUtil.validateJobId(jobId);\r
 138         String file = Configurator.getWorkDirectory(jobId) + File.separator\r
 139                 + new Mafft().getError();\r
 140         return WSUtil.pullFile(file, position);\r
 141     }\r
 142 \r
 143     @Override\r
 144     public boolean cancelJob(String jobId) {\r
 145         WSUtil.validateJobId(jobId);\r
 146         return WSUtil.cancelJob(jobId);\r
 147     }\r
 148 \r
 149     @Override\r
 150     public JobStatus getJobStatus(String jobId) {\r
 151         WSUtil.validateJobId(jobId);\r
 152         return WSUtil.getJobStatus(jobId);\r
 153     }\r
 154 \r
 155     @Override\r
 156     public PresetManager<Mafft> getPresets() {\r
 157         return mafftPresets;\r
 158     }\r
 159 \r
 160     @Override\r
 161     public RunnerConfig<Mafft> getRunnerOptions() {\r
 162         return mafftOptions;\r
 163     }\r
 164 \r
 165 }\r