1 /* Copyright (c) 2009 Peter Troshin
\r
3 * JAva Bioinformatics Analysis Web Services (JABAWS) @version: 1.0
\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
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
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
15 * Any republication or derived work distributed in source code form
\r
16 * must include this copyright and license notice.
\r
19 package compbio.ws.server;
\r
21 import java.io.File;
\r
22 import java.util.List;
\r
24 import javax.annotation.Resource;
\r
25 import javax.jws.WebService;
\r
26 import javax.xml.ws.WebServiceContext;
\r
28 import org.apache.log4j.Logger;
\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.ClustalW;
\r
49 import compbio.util.Timer;
\r
50 import compbio.ws.client.Services;
\r
52 @WebService(endpointInterface = "compbio.data.msa.MsaWS", targetNamespace = "http://msa.data.compbio/01/01/2010/", serviceName = "ClustalWS")
\r
53 public class ClustalWS implements MsaWS<ClustalW> {
\r
55 // Ask for resource injection
\r
57 private WebServiceContext wsContext;
\r
59 private static Logger log = Logger.getLogger(ClustalWS.class);
\r
61 private static volatile WSLogger logger;
\r
63 private static final RunnerConfig<ClustalW> clustalOptions = Util
\r
64 .getSupportedOptions(ClustalW.class);
\r
66 private static final PresetManager<ClustalW> clustalPresets = Util
\r
67 .getPresets(ClustalW.class);
\r
70 * Initialise the logger. This cannot be done in the constructor as the
\r
71 * WebServiceContext is not available at the object construction time
\r
73 private WSLogger getLogger() {
\r
74 if (logger == null) {
\r
75 synchronized (ClustalWS.class) {
\r
76 if (logger == null) {
\r
77 logger = WSLogger.getStatLogger(Services.ClustalWS,
\r
86 public String align(List<FastaSequence> sequences)
\r
87 throws JobSubmissionException {
\r
88 WSUtil.validateFastaInput(sequences);
\r
89 ConfiguredExecutable<ClustalW> confClust = init(sequences);
\r
90 return WSUtil.align(sequences, confClust, getLogger(), "align",
\r
94 ConfiguredExecutable<ClustalW> init(List<FastaSequence> dataSet)
\r
95 throws JobSubmissionException {
\r
96 ClustalW clustal = new ClustalW();
\r
97 ConfiguredExecutable<ClustalW> confClust = Configurator
\r
98 .configureExecutable(clustal, dataSet);
\r
103 public String presetAlign(List<FastaSequence> sequences,
\r
104 Preset<ClustalW> preset) throws JobSubmissionException,
\r
105 WrongParameterException {
\r
106 WSUtil.validateFastaInput(sequences);
\r
107 if (preset == null) {
\r
108 throw new WrongParameterException("Preset must be provided!");
\r
110 Limit<ClustalW> limit = getLimit(preset.getName());
\r
111 ConfiguredExecutable<ClustalW> confClust = init(sequences);
\r
112 confClust.addParameters(preset.getOptions());
\r
113 return WSUtil.align(sequences, confClust, getLogger(), "presetAlign",
\r
118 public String customAlign(List<FastaSequence> sequences,
\r
119 List<Option<ClustalW>> options) throws JobSubmissionException,
\r
120 WrongParameterException {
\r
121 WSUtil.validateFastaInput(sequences);
\r
122 ConfiguredExecutable<ClustalW> confClust = init(sequences);
\r
123 List<String> params = WSUtil.getCommands(options,
\r
124 ClustalW.KEY_VALUE_SEPARATOR);
\r
125 confClust.addParameters(params);
\r
126 log.info("Setting parameters: " + params);
\r
127 return WSUtil.align(sequences, confClust, getLogger(), "customAlign",
\r
132 public RunnerConfig<ClustalW> getRunnerOptions() {
\r
133 Timer timer = Timer.getMilliSecondsTimer();
\r
134 getLogger().logAll(timer, "getRunnerOptions");
\r
135 return clustalOptions;
\r
138 @SuppressWarnings("unchecked")
\r
140 public Alignment getResult(String jobId) throws ResultNotAvailableException {
\r
141 Timer timer = Timer.getMilliSecondsTimer();
\r
142 WSUtil.validateJobId(jobId);
\r
143 AsyncExecutor asyncEngine = Configurator.getAsyncEngine(jobId);
\r
144 ConfiguredExecutable<ClustalW> clustal = (ConfiguredExecutable<ClustalW>) asyncEngine
\r
145 .getResults(jobId);
\r
146 Alignment al = clustal.getResults();
\r
147 getLogger().log(timer, "getResults", jobId);
\r
152 public Limit<ClustalW> getLimit(String presetName) {
\r
153 Timer timer = Timer.getMilliSecondsTimer();
\r
154 Limit<ClustalW> limit = new ClustalW().getLimit(presetName);
\r
155 getLogger().logAll(timer, "getLimit");
\r
160 public LimitsManager<ClustalW> getLimits() {
\r
161 Timer timer = Timer.getMilliSecondsTimer();
\r
162 LimitsManager<ClustalW> limits = new ClustalW().getLimits();
\r
163 getLogger().logAll(timer, "getLimits");
\r
168 public boolean cancelJob(String jobId) {
\r
169 Timer timer = Timer.getMilliSecondsTimer();
\r
170 WSUtil.validateJobId(jobId);
\r
171 boolean result = WSUtil.cancelJob(jobId);
\r
172 getLogger().logFine(timer, "Cancel");
\r
177 public JobStatus getJobStatus(String jobId) {
\r
178 Timer timer = Timer.getMilliSecondsTimer();
\r
179 WSUtil.validateJobId(jobId);
\r
180 JobStatus status = WSUtil.getJobStatus(jobId);
\r
181 getLogger().logFine(timer, "getJobStatus");
\r
186 public PresetManager<ClustalW> getPresets() {
\r
187 Timer timer = Timer.getMilliSecondsTimer();
\r
188 getLogger().logAll(timer, "pullExecStatistics");
\r
189 return clustalPresets;
\r
193 public ChunkHolder pullExecStatistics(String jobId, long position) {
\r
194 Timer timer = Timer.getMilliSecondsTimer();
\r
195 WSUtil.validateJobId(jobId);
\r
196 String file = Configurator.getWorkDirectory(jobId) + File.separator
\r
197 + ClustalW.getStatFile();
\r
198 ChunkHolder cholder = WSUtil.pullFile(file, position);
\r
199 getLogger().logFine(timer, "pullExecStatistics");
\r