1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
5 <!-- Generated by javadoc (1.8.0_121) on Fri Apr 21 15:32:50 BST 2017 -->
7 <meta name="date" content="2017-04-21">
8 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
9 <script type="text/javascript" src="../../../script.js"></script>
12 <script type="text/javascript"><!--
14 if (location.href.indexOf('is-external=true') == -1) {
15 parent.document.title="MsaWS";
21 var methods = {"i0":6,"i1":6,"i2":6,"i3":6};
22 var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"]};
23 var altColor = "altColor";
24 var rowColor = "rowColor";
25 var tableTab = "tableTab";
26 var activeTableTab = "activeTableTab";
29 <div>JavaScript is disabled on your browser.</div>
31 <!-- ========= START OF TOP NAVBAR ======= -->
32 <div class="topNav"><a name="navbar.top">
35 <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
36 <a name="navbar.top.firstrow">
39 <ul class="navList" title="Navigation">
40 <li><a href="../../../overview-summary.html">Overview</a></li>
41 <li><a href="package-summary.html">Package</a></li>
42 <li class="navBarCell1Rev">Class</li>
43 <li><a href="class-use/MsaWS.html">Use</a></li>
44 <li><a href="package-tree.html">Tree</a></li>
45 <li><a href="../../../deprecated-list.html">Deprecated</a></li>
46 <li><a href="../../../index-files/index-1.html">Index</a></li>
47 <li><a href="../../../help-doc.html">Help</a></li>
52 <li><a href="../../../compbio/data/msa/Metadata.html" title="interface in compbio.data.msa"><span class="typeNameLink">Prev Class</span></a></li>
53 <li><a href="../../../compbio/data/msa/RegistryWS.html" title="interface in compbio.data.msa"><span class="typeNameLink">Next Class</span></a></li>
56 <li><a href="../../../index.html?compbio/data/msa/MsaWS.html" target="_top">Frames</a></li>
57 <li><a href="MsaWS.html" target="_top">No Frames</a></li>
59 <ul class="navList" id="allclasses_navbar_top">
60 <li><a href="../../../allclasses-noframe.html">All Classes</a></li>
63 <script type="text/javascript"><!--
64 allClassesLink = document.getElementById("allclasses_navbar_top");
66 allClassesLink.style.display = "block";
69 allClassesLink.style.display = "none";
75 <ul class="subNavList">
76 <li>Summary: </li>
77 <li>Nested | </li>
78 <li>Field | </li>
79 <li>Constr | </li>
80 <li><a href="#method.summary">Method</a></li>
82 <ul class="subNavList">
83 <li>Detail: </li>
84 <li>Field | </li>
85 <li>Constr | </li>
86 <li><a href="#method.detail">Method</a></li>
89 <a name="skip.navbar.top">
92 <!-- ========= END OF TOP NAVBAR ========= -->
93 <!-- ======== START OF CLASS DATA ======== -->
95 <div class="subTitle">compbio.data.msa</div>
96 <h2 title="Interface MsaWS" class="title">Interface MsaWS<T></h2>
98 <div class="contentContainer">
99 <div class="description">
100 <ul class="blockList">
101 <li class="blockList">
103 <dt><span class="paramLabel">Type Parameters:</span></dt>
104 <dd><code>T</code> - executable type / web service type</dd>
107 <dt>All Superinterfaces:</dt>
108 <dd><a href="../../../compbio/data/msa/JABAService.html" title="interface in compbio.data.msa">JABAService</a>, <a href="../../../compbio/data/msa/JManagement.html" title="interface in compbio.data.msa">JManagement</a>, <a href="../../../compbio/data/msa/Metadata.html" title="interface in compbio.data.msa">Metadata</a><T></dd>
111 <dt>All Known Implementing Classes:</dt>
112 <dd><a href="../../../compbio/ws/server/ClustalOWS.html" title="class in compbio.ws.server">ClustalOWS</a>, <a href="../../../compbio/ws/server/ClustalWS.html" title="class in compbio.ws.server">ClustalWS</a>, <a href="../../../compbio/ws/server/GLprobsWS.html" title="class in compbio.ws.server">GLprobsWS</a>, <a href="../../../compbio/ws/server/MafftWS.html" title="class in compbio.ws.server">MafftWS</a>, <a href="../../../compbio/ws/server/MSAprobsWS.html" title="class in compbio.ws.server">MSAprobsWS</a>, <a href="../../../compbio/ws/server/MuscleWS.html" title="class in compbio.ws.server">MuscleWS</a>, <a href="../../../compbio/ws/server/ProbconsWS.html" title="class in compbio.ws.server">ProbconsWS</a>, <a href="../../../compbio/ws/server/TcoffeeWS.html" title="class in compbio.ws.server">TcoffeeWS</a></dd>
116 <pre>public interface <span class="typeNameLabel">MsaWS<T></span>
117 extends <a href="../../../compbio/data/msa/JABAService.html" title="interface in compbio.data.msa">JABAService</a>, <a href="../../../compbio/data/msa/JManagement.html" title="interface in compbio.data.msa">JManagement</a>, <a href="../../../compbio/data/msa/Metadata.html" title="interface in compbio.data.msa">Metadata</a><T></pre>
118 <div class="block">Multiple Sequence Alignment (MSA) Web Services Interface</div>
120 <dt><span class="simpleTagLabel">Author:</span></dt>
123 Date November 2010</dd>
128 <div class="summary">
129 <ul class="blockList">
130 <li class="blockList">
131 <!-- =========== FIELD SUMMARY =========== -->
132 <ul class="blockList">
133 <li class="blockList"><a name="field.summary">
136 <h3>Field Summary</h3>
137 <ul class="blockList">
138 <li class="blockList"><a name="fields.inherited.from.class.compbio.data.msa.JABAService">
141 <h3>Fields inherited from interface compbio.data.msa.<a href="../../../compbio/data/msa/JABAService.html" title="interface in compbio.data.msa">JABAService</a></h3>
142 <code><a href="../../../compbio/data/msa/JABAService.html#JABAWS_VERSION">JABAWS_VERSION</a>, <a href="../../../compbio/data/msa/JABAService.html#SERVICE_NAMESPACE">SERVICE_NAMESPACE</a>, <a href="../../../compbio/data/msa/JABAService.html#V2_SERVICE_NAMESPACE">V2_SERVICE_NAMESPACE</a>, <a href="../../../compbio/data/msa/JABAService.html#V3_SERVICE_NAMESPACE">V3_SERVICE_NAMESPACE</a></code></li>
146 <!-- ========== METHOD SUMMARY =========== -->
147 <ul class="blockList">
148 <li class="blockList"><a name="method.summary">
151 <h3>Method Summary</h3>
152 <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
153 <caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t3" class="tableTab"><span><a href="javascript:show(4);">Abstract Methods</a></span><span class="tabEnd"> </span></span></caption>
155 <th class="colFirst" scope="col">Modifier and Type</th>
156 <th class="colLast" scope="col">Method and Description</th>
158 <tr id="i0" class="altColor">
159 <td class="colFirst"><code>java.lang.String</code></td>
160 <td class="colLast"><code><span class="memberNameLink"><a href="../../../compbio/data/msa/MsaWS.html#align-java.util.List-">align</a></span>(java.util.List<<a href="../../../compbio/data/sequence/FastaSequence.html" title="class in compbio.data.sequence">FastaSequence</a>> sequences)</code>
161 <div class="block">Align a list of sequences with default settings.</div>
164 <tr id="i1" class="rowColor">
165 <td class="colFirst"><code>java.lang.String</code></td>
166 <td class="colLast"><code><span class="memberNameLink"><a href="../../../compbio/data/msa/MsaWS.html#customAlign-java.util.List-java.util.List-">customAlign</a></span>(java.util.List<<a href="../../../compbio/data/sequence/FastaSequence.html" title="class in compbio.data.sequence">FastaSequence</a>> sequences,
167 java.util.List<<a href="../../../compbio/metadata/Option.html" title="class in compbio.metadata">Option</a><<a href="../../../compbio/data/msa/MsaWS.html" title="type parameter in MsaWS">T</a>>> options)</code>
168 <div class="block">Align a list of sequences with options.</div>
171 <tr id="i2" class="altColor">
172 <td class="colFirst"><code><a href="../../../compbio/data/sequence/Alignment.html" title="class in compbio.data.sequence">Alignment</a></code></td>
173 <td class="colLast"><code><span class="memberNameLink"><a href="../../../compbio/data/msa/MsaWS.html#getResult-java.lang.String-">getResult</a></span>(java.lang.String jobId)</code>
174 <div class="block">Return the result of the job.</div>
177 <tr id="i3" class="rowColor">
178 <td class="colFirst"><code>java.lang.String</code></td>
179 <td class="colLast"><code><span class="memberNameLink"><a href="../../../compbio/data/msa/MsaWS.html#presetAlign-java.util.List-compbio.metadata.Preset-">presetAlign</a></span>(java.util.List<<a href="../../../compbio/data/sequence/FastaSequence.html" title="class in compbio.data.sequence">FastaSequence</a>> sequences,
180 <a href="../../../compbio/metadata/Preset.html" title="class in compbio.metadata">Preset</a><<a href="../../../compbio/data/msa/MsaWS.html" title="type parameter in MsaWS">T</a>> preset)</code>
181 <div class="block">Align a list of sequences with preset.</div>
185 <ul class="blockList">
186 <li class="blockList"><a name="methods.inherited.from.class.compbio.data.msa.JManagement">
189 <h3>Methods inherited from interface compbio.data.msa.<a href="../../../compbio/data/msa/JManagement.html" title="interface in compbio.data.msa">JManagement</a></h3>
190 <code><a href="../../../compbio/data/msa/JManagement.html#cancelJob-java.lang.String-">cancelJob</a>, <a href="../../../compbio/data/msa/JManagement.html#getJobStatus-java.lang.String-">getJobStatus</a>, <a href="../../../compbio/data/msa/JManagement.html#pullExecStatistics-java.lang.String-long-">pullExecStatistics</a></code></li>
192 <ul class="blockList">
193 <li class="blockList"><a name="methods.inherited.from.class.compbio.data.msa.Metadata">
196 <h3>Methods inherited from interface compbio.data.msa.<a href="../../../compbio/data/msa/Metadata.html" title="interface in compbio.data.msa">Metadata</a></h3>
197 <code><a href="../../../compbio/data/msa/Metadata.html#getLimit-java.lang.String-">getLimit</a>, <a href="../../../compbio/data/msa/Metadata.html#getLimits--">getLimits</a>, <a href="../../../compbio/data/msa/Metadata.html#getPresets--">getPresets</a>, <a href="../../../compbio/data/msa/Metadata.html#getRunnerOptions--">getRunnerOptions</a></code></li>
204 <div class="details">
205 <ul class="blockList">
206 <li class="blockList">
207 <!-- ============ METHOD DETAIL ========== -->
208 <ul class="blockList">
209 <li class="blockList"><a name="method.detail">
212 <h3>Method Detail</h3>
213 <a name="align-java.util.List-">
216 <ul class="blockList">
217 <li class="blockList">
219 <pre>java.lang.String align(java.util.List<<a href="../../../compbio/data/sequence/FastaSequence.html" title="class in compbio.data.sequence">FastaSequence</a>> sequences)
220 throws <a href="../../../compbio/metadata/UnsupportedRuntimeException.html" title="class in compbio.metadata">UnsupportedRuntimeException</a>,
221 <a href="../../../compbio/metadata/LimitExceededException.html" title="class in compbio.metadata">LimitExceededException</a>,
222 <a href="../../../compbio/metadata/JobSubmissionException.html" title="class in compbio.metadata">JobSubmissionException</a></pre>
223 <div class="block">Align a list of sequences with default settings.
225 Any dataset containing a greater number of sequences or when the average
226 length of the sequences are greater then defined in the default Limit,
227 will not be accepted for an alignment operation and
228 JobSubmissionException will be thrown.</div>
230 <dt><span class="paramLabel">Parameters:</span></dt>
231 <dd><code>sequences</code> - List of FastaSequence objects. The program does not perform
232 any sequence validity checks. Nor does it checks whether the
233 sequences names are unique. It is responsibility of the caller
234 to make sure of this</dd>
235 <dt><span class="returnLabel">Returns:</span></dt>
236 <dd>jobId - unique identifier for the job</dd>
237 <dt><span class="throwsLabel">Throws:</span></dt>
238 <dd><code><a href="../../../compbio/metadata/JobSubmissionException.html" title="class in compbio.metadata">JobSubmissionException</a></code> - is thrown when the job could not be submitted due to the
239 following reasons: 1) The number of sequences in the
240 submission or their average length is greater then defined by
241 the default Limit. 2) Any problems on the server side e.g. it
242 is misconfigured or malfunction, is reported via this
243 exception. In the first case the information on the limit
244 could be obtained from an exception.</dd>
245 <dd><code>java.security.InvalidParameterException</code> - thrown if input list of FASTA sequences is null or empty</dd>
246 <dd><code><a href="../../../compbio/metadata/UnsupportedRuntimeException.html" title="class in compbio.metadata">UnsupportedRuntimeException</a></code> - thrown if server OS does not support native executables for a
247 given web service, e.g. JABAWS is deployed on Windows and
248 Mafft service is called</dd>
249 <dd><code><a href="../../../compbio/metadata/LimitExceededException.html" title="class in compbio.metadata">LimitExceededException</a></code> - is throw if the input sequences number or their average
250 length exceeds what is defined by the limit</dd>
254 <a name="customAlign-java.util.List-java.util.List-">
257 <ul class="blockList">
258 <li class="blockList">
260 <pre>java.lang.String customAlign(java.util.List<<a href="../../../compbio/data/sequence/FastaSequence.html" title="class in compbio.data.sequence">FastaSequence</a>> sequences,
261 java.util.List<<a href="../../../compbio/metadata/Option.html" title="class in compbio.metadata">Option</a><<a href="../../../compbio/data/msa/MsaWS.html" title="type parameter in MsaWS">T</a>>> options)
262 throws <a href="../../../compbio/metadata/UnsupportedRuntimeException.html" title="class in compbio.metadata">UnsupportedRuntimeException</a>,
263 <a href="../../../compbio/metadata/LimitExceededException.html" title="class in compbio.metadata">LimitExceededException</a>,
264 <a href="../../../compbio/metadata/JobSubmissionException.html" title="class in compbio.metadata">JobSubmissionException</a>,
265 <a href="../../../compbio/metadata/WrongParameterException.html" title="class in compbio.metadata">WrongParameterException</a></pre>
266 <div class="block">Align a list of sequences with options.</div>
268 <dt><span class="paramLabel">Parameters:</span></dt>
269 <dd><code>sequences</code> - List of FastaSequence objects. The programme does not perform
270 any sequence validity checks. Nor does it checks whether the
271 sequences names are unique. It is responsibility of the caller
272 to validate this information</dd>
273 <dd><code>options</code> - A list of Options</dd>
274 <dt><span class="returnLabel">Returns:</span></dt>
275 <dd>jobId - unique identifier for the job</dd>
276 <dt><span class="throwsLabel">Throws:</span></dt>
277 <dd><code><a href="../../../compbio/metadata/JobSubmissionException.html" title="class in compbio.metadata">JobSubmissionException</a></code> - is thrown when the job could not be submitted due to the
278 following reasons: 1) The number of sequences in the
279 submission or their average length is greater then defined by
280 the default Limit. 2) Any problems on the server side e.g. it
281 is misconfigured or malfunction, is reported via this
282 exception. In the first case the information on the limit
283 could be obtained from an exception.</dd>
284 <dd><code><a href="../../../compbio/metadata/WrongParameterException.html" title="class in compbio.metadata">WrongParameterException</a></code> - is throws when 1) One of the Options provided is not
285 supported, 2) The value of the option is defined outside the
286 boundaries. In both cases exception object contain the
287 information on the violating Option.</dd>
288 <dd><code>java.security.InvalidParameterException</code> - thrown if input list of FASTA sequence is null or empty</dd>
289 <dd><code><a href="../../../compbio/metadata/UnsupportedRuntimeException.html" title="class in compbio.metadata">UnsupportedRuntimeException</a></code> - thrown if server OS does not support native executables for a
290 given web service, e.g. JABAWS is deployed on Windows and
291 Mafft service is called</dd>
292 <dd><code><a href="../../../compbio/metadata/LimitExceededException.html" title="class in compbio.metadata">LimitExceededException</a></code> - is throw if the input sequences number or their average
293 length exceeds what is defined by the limit</dd>
294 <dt><span class="seeLabel">See Also:</span></dt>
295 <dd><a href="../../../compbio/metadata/Option.html" title="class in compbio.metadata"><code>Default Limit is used to decide whether the calculation will be
296 permitted or denied</code></a></dd>
300 <a name="presetAlign-java.util.List-compbio.metadata.Preset-">
303 <ul class="blockList">
304 <li class="blockList">
306 <pre>java.lang.String presetAlign(java.util.List<<a href="../../../compbio/data/sequence/FastaSequence.html" title="class in compbio.data.sequence">FastaSequence</a>> sequences,
307 <a href="../../../compbio/metadata/Preset.html" title="class in compbio.metadata">Preset</a><<a href="../../../compbio/data/msa/MsaWS.html" title="type parameter in MsaWS">T</a>> preset)
308 throws <a href="../../../compbio/metadata/UnsupportedRuntimeException.html" title="class in compbio.metadata">UnsupportedRuntimeException</a>,
309 <a href="../../../compbio/metadata/LimitExceededException.html" title="class in compbio.metadata">LimitExceededException</a>,
310 <a href="../../../compbio/metadata/JobSubmissionException.html" title="class in compbio.metadata">JobSubmissionException</a>,
311 <a href="../../../compbio/metadata/WrongParameterException.html" title="class in compbio.metadata">WrongParameterException</a></pre>
312 <div class="block">Align a list of sequences with preset.
314 Limit for a presetName is used whether the calculation will be permitted
315 or denied. If no Limit was defined for a presetName, than default limit
318 <dt><span class="paramLabel">Parameters:</span></dt>
319 <dd><code>sequences</code> - List of FastaSequence objects. The programme does not perform
320 any sequence validity checks. Nor does it checks whether the
321 sequences names are unique. It is responsibility of the caller
322 to validate this information</dd>
323 <dd><code>preset</code> - A list of Options</dd>
324 <dt><span class="returnLabel">Returns:</span></dt>
325 <dd>String - jobId - unique identifier for the job</dd>
326 <dt><span class="throwsLabel">Throws:</span></dt>
327 <dd><code><a href="../../../compbio/metadata/JobSubmissionException.html" title="class in compbio.metadata">JobSubmissionException</a></code> - is thrown when the job could not be submitted due to the
328 following reasons: 1) The number of sequences in the
329 submission or their average length is greater then defined by
330 the default Limit. 2) Any problems on the server side e.g. it
331 is misconfigured or malfunction, is reported via this
332 exception. In the first case the information on the limit
333 could be obtained from an exception.</dd>
334 <dd><code><a href="../../../compbio/metadata/WrongParameterException.html" title="class in compbio.metadata">WrongParameterException</a></code> - is throws when 1) One of the Options provided is not
335 supported, 2) The value of the option is defined outside the
336 boundaries. In both cases exception object contain the
337 information on the violating Option.</dd>
338 <dd><code>java.security.InvalidParameterException</code> - thrown if input list of FASTA sequence is null or empty</dd>
339 <dd><code><a href="../../../compbio/metadata/UnsupportedRuntimeException.html" title="class in compbio.metadata">UnsupportedRuntimeException</a></code> - thrown if server OS does not support native executables for a
340 given web service, e.g. JABAWS is deployed on Windows and
341 Mafft service is called</dd>
342 <dd><code><a href="../../../compbio/metadata/LimitExceededException.html" title="class in compbio.metadata">LimitExceededException</a></code> - is throw if the input sequences number or average length
343 exceeds what is defined by the limit</dd>
344 <dt><span class="seeLabel">See Also:</span></dt>
345 <dd><a href="../../../compbio/metadata/Preset.html" title="class in compbio.metadata"><code>Preset</code></a></dd>
349 <a name="getResult-java.lang.String-">
352 <ul class="blockListLast">
353 <li class="blockList">
355 <pre><a href="../../../compbio/data/sequence/Alignment.html" title="class in compbio.data.sequence">Alignment</a> getResult(java.lang.String jobId)
356 throws <a href="../../../compbio/metadata/ResultNotAvailableException.html" title="class in compbio.metadata">ResultNotAvailableException</a></pre>
357 <div class="block">Return the result of the job. This method waits for the job
358 <code>jobId</code> to complete before return.</div>
360 <dt><span class="paramLabel">Parameters:</span></dt>
361 <dd><code>jobId</code> - a unique job identifier</dd>
362 <dt><span class="returnLabel">Returns:</span></dt>
364 <dt><span class="throwsLabel">Throws:</span></dt>
365 <dd><code><a href="../../../compbio/metadata/ResultNotAvailableException.html" title="class in compbio.metadata">ResultNotAvailableException</a></code> - this exception is throw if the job execution was not
366 successful or the result of the execution could not be found.
367 (e.g. removed). Exception could also be thrown due to the
368 lower level problems on the server i.e. IOException,
369 FileNotFoundException problems as well as
370 UnknownFileFormatException.</dd>
371 <dd><code>java.security.InvalidParameterException</code> - thrown if jobId is empty or is not recognised e.g. in invalid
382 <!-- ========= END OF CLASS DATA ========= -->
383 <!-- ======= START OF BOTTOM NAVBAR ====== -->
384 <div class="bottomNav"><a name="navbar.bottom">
387 <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
388 <a name="navbar.bottom.firstrow">
391 <ul class="navList" title="Navigation">
392 <li><a href="../../../overview-summary.html">Overview</a></li>
393 <li><a href="package-summary.html">Package</a></li>
394 <li class="navBarCell1Rev">Class</li>
395 <li><a href="class-use/MsaWS.html">Use</a></li>
396 <li><a href="package-tree.html">Tree</a></li>
397 <li><a href="../../../deprecated-list.html">Deprecated</a></li>
398 <li><a href="../../../index-files/index-1.html">Index</a></li>
399 <li><a href="../../../help-doc.html">Help</a></li>
404 <li><a href="../../../compbio/data/msa/Metadata.html" title="interface in compbio.data.msa"><span class="typeNameLink">Prev Class</span></a></li>
405 <li><a href="../../../compbio/data/msa/RegistryWS.html" title="interface in compbio.data.msa"><span class="typeNameLink">Next Class</span></a></li>
408 <li><a href="../../../index.html?compbio/data/msa/MsaWS.html" target="_top">Frames</a></li>
409 <li><a href="MsaWS.html" target="_top">No Frames</a></li>
411 <ul class="navList" id="allclasses_navbar_bottom">
412 <li><a href="../../../allclasses-noframe.html">All Classes</a></li>
415 <script type="text/javascript"><!--
416 allClassesLink = document.getElementById("allclasses_navbar_bottom");
418 allClassesLink.style.display = "block";
421 allClassesLink.style.display = "none";
427 <ul class="subNavList">
428 <li>Summary: </li>
429 <li>Nested | </li>
430 <li>Field | </li>
431 <li>Constr | </li>
432 <li><a href="#method.summary">Method</a></li>
434 <ul class="subNavList">
435 <li>Detail: </li>
436 <li>Field | </li>
437 <li>Constr | </li>
438 <li><a href="#method.detail">Method</a></li>
441 <a name="skip.navbar.bottom">
444 <!-- ======== END OF BOTTOM NAVBAR ======= -->