webservices/compbio/ws/server/MuscleWS.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.Muscle;\r
  49 \r
  50 @WebService(endpointInterface = "compbio.data.msa.MsaWS", targetNamespace = "http://msa.data.compbio/01/01/2010/", serviceName = "MuscleWS")\r
  51 public class MuscleWS implements MsaWS<Muscle> {\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("MuscleWS-stats");\r
  58 \r
  59         private static Logger log = Logger.getLogger(MuscleWS.class);\r
  60 \r
  61         private static final RunnerConfig<Muscle> muscleOptions = Util\r
  62                         .getSupportedOptions(Muscle.class);\r
  63 \r
  64         private static final PresetManager<Muscle> musclePresets = Util\r
  65                         .getPresets(Muscle.class);\r
  66 \r
  67         private static final LimitsManager<Muscle> limitMan = compbio.runner.Util\r
  68                         .getLimits(new Muscle().getType());\r
  69 \r
  70         @Override\r
  71         public String align(List<FastaSequence> sequences)\r
  72                         throws JobSubmissionException {\r
  73                 WSUtil.validateFastaInput(sequences);\r
  74                 ConfiguredExecutable<Muscle> confMuscle = init(sequences);\r
  75                 return WSUtil.align(sequences, confMuscle, null, "align", getLimit(""));\r
  76         }\r
  77 \r
  78         ConfiguredExecutable<Muscle> init(List<FastaSequence> sequences)\r
  79                         throws JobSubmissionException {\r
  80                 Muscle muscle = new Muscle();\r
  81                 muscle.setInput("fasta.in").setOutput("fasta.out");\r
  82                 return Configurator.configureExecutable(muscle, sequences);\r
  83         }\r
  84 \r
  85         @Override\r
  86         public String customAlign(List<FastaSequence> sequences,\r
  87                         List<Option<Muscle>> options) throws JobSubmissionException,\r
  88                         WrongParameterException {\r
  89                 WSUtil.validateFastaInput(sequences);\r
  90                 ConfiguredExecutable<Muscle> confMuscle = init(sequences);\r
  91                 // Could not do that! Space separated values\r
  92                 // will all be treated as keys! thus duplicates removed\r
  93                 // String params = cbuilder.getCommand();\r
  94                 List<String> params = WSUtil.getCommands(options,\r
  95                                 Muscle.KEY_VALUE_SEPARATOR);\r
  96                 confMuscle.addParameters(params);\r
  97                 return WSUtil.align(sequences, confMuscle, null, "customAlign",\r
  98                                 getLimit(""));\r
  99         }\r
 100 \r
 101         @Override\r
 102         public String presetAlign(List<FastaSequence> sequences,\r
 103                         Preset<Muscle> preset) throws JobSubmissionException,\r
 104                         WrongParameterException {\r
 105                 WSUtil.validateFastaInput(sequences);\r
 106                 if (preset == null) {\r
 107                         throw new WrongParameterException("Preset must be provided!");\r
 108                 }\r
 109                 ConfiguredExecutable<Muscle> confMuscle = init(sequences);\r
 110                 confMuscle.addParameters(preset.getOptions());\r
 111                 Limit<Muscle> limit = getLimit(preset.getName());\r
 112                 return WSUtil.align(sequences, confMuscle, null, "presetAlign", limit);\r
 113         }\r
 114 \r
 115         @SuppressWarnings("unchecked")\r
 116         @Override\r
 117         public Alignment getResult(String jobId) throws ResultNotAvailableException {\r
 118                 WSUtil.validateJobId(jobId);\r
 119                 AsyncExecutor asyncEngine = Configurator.getAsyncEngine(jobId);\r
 120                 ConfiguredExecutable<Muscle> muscle = (ConfiguredExecutable<Muscle>) asyncEngine\r
 121                                 .getResults(jobId);\r
 122                 Alignment al = muscle.getResults();\r
 123                 // log(jobId, "getResults");\r
 124                 return al;\r
 125         }\r
 126 \r
 127         @Override\r
 128         public Limit<Muscle> getLimit(String presetName) {\r
 129                 return limitMan.getLimitByName(presetName);\r
 130         }\r
 131 \r
 132         @Override\r
 133         public LimitsManager<Muscle> getLimits() {\r
 134                 return limitMan;\r
 135         }\r
 136 \r
 137         @Override\r
 138         public ChunkHolder pullExecStatistics(String jobId, long position) {\r
 139                 WSUtil.validateJobId(jobId);\r
 140                 String file = Configurator.getWorkDirectory(jobId) + File.separator\r
 141                                 + Muscle.getStatFile();\r
 142                 return WSUtil.pullFile(file, position);\r
 143         }\r
 144 \r
 145         @Override\r
 146         public boolean cancelJob(String jobId) {\r
 147                 WSUtil.validateJobId(jobId);\r
 148                 return WSUtil.cancelJob(jobId);\r
 149         }\r
 150 \r
 151         @Override\r
 152         public JobStatus getJobStatus(String jobId) {\r
 153                 WSUtil.validateJobId(jobId);\r
 154                 return WSUtil.getJobStatus(jobId);\r
 155         }\r
 156 \r
 157         @Override\r
 158         public PresetManager<Muscle> getPresets() {\r
 159                 return musclePresets;\r
 160         }\r
 161 \r
 162         @Override\r
 163         public RunnerConfig<Muscle> getRunnerOptions() {\r
 164                 return muscleOptions;\r
 165         }\r
 166 \r
 167 }\r