Subversion Repositories XServices

Rev

Rev 87 | Only display areas with differences | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 87 Rev 111
1
/*
1
/*
2
 *   Copyright 2011 Brian Rosenberger (Brutex Network)
2
 *   Copyright 2011 Brian Rosenberger (Brutex Network)
3
 *
3
 *
4
 *   Licensed under the Apache License, Version 2.0 (the "License");
4
 *   Licensed under the Apache License, Version 2.0 (the "License");
5
 *   you may not use this file except in compliance with the License.
5
 *   you may not use this file except in compliance with the License.
6
 *   You may obtain a copy of the License at
6
 *   You may obtain a copy of the License at
7
 *
7
 *
8
 *       http://www.apache.org/licenses/LICENSE-2.0
8
 *       http://www.apache.org/licenses/LICENSE-2.0
9
 *
9
 *
10
 *   Unless required by applicable law or agreed to in writing, software
10
 *   Unless required by applicable law or agreed to in writing, software
11
 *   distributed under the License is distributed on an "AS IS" BASIS,
11
 *   distributed under the License is distributed on an "AS IS" BASIS,
12
 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
 *   See the License for the specific language governing permissions and
13
 *   See the License for the specific language governing permissions and
14
 *   limitations under the License.
14
 *   limitations under the License.
15
 */
15
 */
16
 
16
 
17
package net.brutex.xservices.ws;
17
package net.brutex.xservices.ws;
18
 
18
 
19
import java.util.List;
19
import java.util.List;
20
 
20
 
21
import javax.jws.WebMethod;
21
import javax.jws.WebMethod;
22
import javax.jws.WebParam;
22
import javax.jws.WebParam;
23
import javax.jws.WebService;
23
import javax.jws.WebService;
24
import javax.xml.bind.annotation.XmlElement;
24
import javax.xml.bind.annotation.XmlElement;
25
 
25
 
26
import net.brutex.xservices.types.ScheduledJob;
26
import net.brutex.xservices.types.ScheduledJob;
27
import net.brutex.xservices.types.SchedulerStatisticsType;
-
 
28
import net.brutex.xservices.util.BrutexNamespaces;
27
import net.brutex.xservices.util.BrutexNamespaces;
29
 
28
 
30
import org.apache.cxf.annotations.WSDLDocumentation;
29
import org.apache.cxf.annotations.WSDLDocumentation;
31
 
30
 
32
/**
31
/**
33
 * Job management services.
32
 * Job management services.
34
 * @author Brian Rosenberger
33
 * @author Brian Rosenberger
35
 * @since 0.5.0
34
 * @since 0.5.0
36
 *
35
 *
37
 */
36
 */
38
@WebService(targetNamespace = BrutexNamespaces.WS_XSERVICES)
37
@WebService(targetNamespace = BrutexNamespaces.WS_XSERVICES)
39
public interface JobService {
38
public interface JobService {
40
	
39
	
41
	public static final String SERVICE_NAME = "JobService";
40
	public static final String SERVICE_NAME = "JobService";
42
	final String OPERATION_GETJOBLIST = "getJobs";
41
	final String OPERATION_GETJOBLIST = "getJobs";
43
	final String OPERATION_SCHEDULEJOB = "scheduleJob";
42
	final String OPERATION_SCHEDULEJOB = "scheduleJob";
44
	final String OPERATION_GETJOB = "getJob";
43
	final String OPERATION_GETJOB = "getJob";
45
	final String OPERATION_DELETEJOB = "deleteJob";
44
	final String OPERATION_DELETEJOB = "deleteJob";
46
	final String OPERATION_GETSTATISTICS = "getStatistics";
-
 
-
 
45
	
47
	final String PARAM_JOB = "job";
46
	final String PARAM_JOB = "job";
48
	
47
	
49
	
48
	
50
	/**
49
	/**
51
	 * Get a full list of all scheduled jobs.
50
	 * Get a full list of all scheduled jobs.
52
	 * 
51
	 * 
53
	 * @return List of scheduled jobs
52
	 * @return List of scheduled jobs
54
	 * @throws XServicesFault
53
	 * @throws XServicesFault
55
	 */
54
	 */
56
	@WebMethod(operationName=OPERATION_GETJOBLIST)
55
	@WebMethod(operationName=OPERATION_GETJOBLIST)
57
	@WSDLDocumentation(value="Get list of scheduled jobs")
56
	@WSDLDocumentation(value="Get list of scheduled jobs")
58
	public abstract List<ScheduledJob> getJobList() throws XServicesFault;
57
	public abstract List<ScheduledJob> getJobList() throws XServicesFault;
59
	
58
	
60
	/**
59
	/**
61
	 * Add a job to the scheduler.
60
	 * Add a job to the scheduler.
62
	 * 
61
	 * 
63
	 * @param job
62
	 * @param job
64
	 * @return The unique identifier of the job.
63
	 * @return The unique identifier of the job.
65
	 * @throws XServicesFault
64
	 * @throws XServicesFault
66
	 */
65
	 */
67
	@WebMethod(operationName=OPERATION_SCHEDULEJOB)
66
	@WebMethod(operationName=OPERATION_SCHEDULEJOB)
68
	@WSDLDocumentation(value="Schedule a job")
67
	@WSDLDocumentation(value="Schedule a job")
69
	public abstract String scheduleJob(
68
	public abstract String scheduleJob(
70
			@WebParam(name=PARAM_JOB) @XmlElement(required=true) ScheduledJob job)
69
			@WebParam(name=PARAM_JOB) @XmlElement(required=true) ScheduledJob job)
71
			throws XServicesFault;
70
			throws XServicesFault;
72
	
71
	
73
	/**
72
	/**
74
	 * Get a job by id.
73
	 * Get a job by id.
75
	 * 
74
	 * 
76
	 * @param uuid
75
	 * @param uuid
77
	 * @return Job details
76
	 * @return Job details
78
	 * @throws XServicesFault
77
	 * @throws XServicesFault
79
	 */
78
	 */
80
	@WebMethod(operationName=OPERATION_GETJOB)
79
	@WebMethod(operationName=OPERATION_GETJOB)
81
	@WSDLDocumentation(value="Get a job by id")
80
	@WSDLDocumentation(value="Get a job by id")
82
	public abstract ScheduledJob getJob(
81
	public abstract ScheduledJob getJob(
83
			@WebParam(name="id") @XmlElement(required=true) String uuid) throws XServicesFault;
82
			@WebParam(name="id") @XmlElement(required=true) String uuid) throws XServicesFault;
84
	
83
	
85
	/**
84
	/**
86
	 * Delete a job from scheduler.
85
	 * Delete a job from scheduler.
87
	 * 
86
	 * 
88
	 * @param uuid Id of the job that should be deleted
87
	 * @param uuid Id of the job that should be deleted
89
	 * @throws XServicesFault
88
	 * @throws XServicesFault
90
	 */
89
	 */
91
	@WebMethod(operationName=OPERATION_DELETEJOB)
90
	@WebMethod(operationName=OPERATION_DELETEJOB)
92
	@WSDLDocumentation(value="Delete a scheduled job.")
91
	@WSDLDocumentation(value="Delete a scheduled job.")
93
	public abstract void deleteJob(
92
	public abstract void deleteJob(
94
			@WebParam(name="id") @XmlElement(required=true) String uuid) throws XServicesFault;
93
			@WebParam(name="id") @XmlElement(required=true) String uuid) throws XServicesFault;
95
	
-
 
96
	/**
-
 
97
	 * Get statisctis about the scheduler
-
 
98
	 * @throws XServicesFault 
94
	
99
	 */
-
 
100
	@WebMethod(operationName=OPERATION_GETSTATISTICS)
-
 
101
	@WSDLDocumentation(value="Get scheduler statistics")
-
 
102
	public abstract SchedulerStatisticsType getStatistics() throws XServicesFault;
95
	
103
	
96
	
104
}
97
}