Clover icon

Coverage Report

  1. Project Clover database Wed Nov 13 2024 18:27:33 GMT
  2. Package jalview.ws

File AWsJob.java

 

Coverage histogram

../../img/srcFileCovDistChart5.png
43% of files have more coverage

Code metrics

0
13
13
1
230
75
13
1
1
13
1

Classes

Class Line # Actions
AWsJob 28 13 13
0.4230769342.3%
 

Contributing tests

No tests hitting this source file were found.

Source view

1    /*
2    * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3    * Copyright (C) $$Year-Rel$$ The Jalview Authors
4    *
5    * This file is part of Jalview.
6    *
7    * Jalview is free software: you can redistribute it and/or
8    * modify it under the terms of the GNU General Public License
9    * as published by the Free Software Foundation, either version 3
10    * of the License, or (at your option) any later version.
11    *
12    * Jalview is distributed in the hope that it will be useful, but
13    * WITHOUT ANY WARRANTY; without even the implied warranty
14    * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15    * PURPOSE. See the GNU General Public License for more details.
16    *
17    * You should have received a copy of the GNU General Public License
18    * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
19    * The Jalview Authors are detailed in the 'AUTHORS' file.
20    */
21    package jalview.ws;
22   
23    /**
24    * Generic properties for an individual job within a Web Service Client thread.
25    * Derived from jalview web services version 1 statuses, and revised for Jws2.
26    */
27   
 
28    public abstract class AWsJob
29    {
30    protected int jobnum = 0;
31   
32    protected String jobId;
33   
34    /**
35    * @param jobId
36    * the jobId to set
37    */
 
38  1 toggle public void setJobId(String jobId)
39    {
40  1 this.jobId = jobId;
41    }
42   
43    /**
44    * has job been cancelled
45    */
46    protected boolean cancelled = false;
47   
48    /**
49    * number of exceptions left before job dies
50    */
51    int allowedServerExceptions = 3;
52   
53    /**
54    * @param allowedServerExceptions
55    * the allowedServerExceptions to set
56    */
 
57  1 toggle public void setAllowedServerExceptions(int allowedServerExceptions)
58    {
59  1 this.allowedServerExceptions = allowedServerExceptions;
60    }
61   
62    /**
63    * has job been submitted to server ? if false, then no state info is
64    * available.
65    */
66    protected boolean submitted = false;
67   
68    /**
69    * @param jobnum
70    * the jobnum to set
71    */
 
72  0 toggle public void setJobnum(int jobnum)
73    {
74  0 this.jobnum = jobnum;
75    }
76   
77    /**
78    * @param submitted
79    * the submitted to set
80    */
 
81  1 toggle public void setSubmitted(boolean submitted)
82    {
83  1 this.submitted = submitted;
84    }
85   
86    /**
87    * @param subjobComplete
88    * the subjobComplete to set
89    */
 
90  1 toggle public void setSubjobComplete(boolean subjobComplete)
91    {
92  1 this.subjobComplete = subjobComplete;
93    }
94   
95    /**
96    * @return the jobnum
97    */
 
98  0 toggle public int getJobnum()
99    {
100  0 return jobnum;
101    }
102   
103    /**
104    * @return the jobId
105    */
 
106  0 toggle public String getJobId()
107    {
108  0 return jobId;
109    }
110   
111    /**
112    * @return the cancelled
113    */
 
114  0 toggle public boolean isCancelled()
115    {
116  0 return cancelled;
117    }
118   
119    /**
120    * @return the allowedServerExceptions
121    */
 
122  0 toggle public int getAllowedServerExceptions()
123    {
124  0 return allowedServerExceptions;
125    }
126   
127    /**
128    * @return the submitted
129    */
 
130  1 toggle public boolean isSubmitted()
131    {
132  1 return submitted;
133    }
134   
135    /**
136    * @return the subjobComplete
137    */
 
138  0 toggle public boolean isSubjobComplete()
139    {
140  0 return subjobComplete;
141    }
142   
143    /**
144    * are all sub-jobs complete
145    */
146    protected boolean subjobComplete = false;
147   
 
148  3 toggle public AWsJob()
149    {
150    }
151   
152    /**
153    *
154    * @return true if job has completed and valid results are available
155    */
156    abstract public boolean hasResults();
157   
158    /**
159    *
160    * @return boolean true if job can be submitted.
161    */
162    public abstract boolean hasValidInput();
163   
164    /**
165    *
166    * @return true if job is running
167    */
168    abstract public boolean isRunning();
169   
170    /**
171    *
172    * @return true if job is queued
173    */
174    abstract public boolean isQueued();
175   
176    /**
177    *
178    * @return true if job has finished
179    */
180    abstract public boolean isFinished();
181   
182    /**
183    *
184    * @return true if the job failed due to some problem with the input data or
185    * parameters.
186    */
187    abstract public boolean isFailed();
188   
189    /**
190    *
191    * @return true if job failed due to an unhandled technical issue
192    */
193    abstract public boolean isBroken();
194   
195    /**
196    *
197    * @return true if there was a problem contacting the server.
198    */
199    abstract public boolean isServerError();
200   
201    /**
202    *
203    * @return true if the job has status text.
204    */
205    abstract public boolean hasStatus();
206   
207    /**
208    *
209    * @return status text for job to be displayed to user.
210    */
211    abstract public String getStatus();
212   
213    abstract public boolean hasResponse();
214   
215    abstract public void clearResponse();
216   
217    abstract public String getState();
218   
219    /**
220    * generates response using the abstract service flags.
221    *
222    * @return a standard state response
223    */
 
224  0 toggle protected String _defaultState()
225    {
226   
227  0 String state = "";
228  0 return state;
229    }
230    }