Subversion Repositories XServices

Rev

Rev 72 | Go to most recent revision | Only display areas with differences | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 72 Rev 87
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;
27
import net.brutex.xservices.util.BrutexNamespaces;
28
import net.brutex.xservices.util.BrutexNamespaces;
28
 
29
 
29
import org.apache.cxf.annotations.WSDLDocumentation;
30
import org.apache.cxf.annotations.WSDLDocumentation;
30
 
31
 
31
/**
32
/**
32
 * Job management services.
33
 * Job management services.
33
 * @author Brian Rosenberger
34
 * @author Brian Rosenberger
34
 * @since 0.5.0
35
 * @since 0.5.0
35
 *
36
 *
36
 */
37
 */
37
@WebService(targetNamespace = BrutexNamespaces.WS_XSERVICES)
38
@WebService(targetNamespace = BrutexNamespaces.WS_XSERVICES)
38
public interface JobService {
39
public interface JobService {
39
	
40
	
40
	public static final String SERVICE_NAME = "JobService";
41
	public static final String SERVICE_NAME = "JobService";
41
	final String OPERATION_GETJOBLIST = "getJobs";
42
	final String OPERATION_GETJOBLIST = "getJobs";
42
	final String OPERATION_SCHEDULEJOB = "scheduleJob";
43
	final String OPERATION_SCHEDULEJOB = "scheduleJob";
43
	final String OPERATION_GETJOB = "getJob";
44
	final String OPERATION_GETJOB = "getJob";
44
	final String OPERATION_DELETEJOB = "deleteJob";
45
	final String OPERATION_DELETEJOB = "deleteJob";
45
	
-
 
-
 
46
	final String OPERATION_GETSTATISTICS = "getStatistics";
46
	final String PARAM_JOB = "job";
47
	final String PARAM_JOB = "job";
47
	
48
	
48
	
49
	
49
	/**
50
	/**
50
	 * Get a full list of all scheduled jobs.
51
	 * Get a full list of all scheduled jobs.
51
	 * 
52
	 * 
52
	 * @return List of scheduled jobs
53
	 * @return List of scheduled jobs
53
	 * @throws XServicesFault
54
	 * @throws XServicesFault
54
	 */
55
	 */
55
	@WebMethod(operationName=OPERATION_GETJOBLIST)
56
	@WebMethod(operationName=OPERATION_GETJOBLIST)
56
	@WSDLDocumentation(value="Get list of scheduled jobs")
57
	@WSDLDocumentation(value="Get list of scheduled jobs")
57
	public abstract List<ScheduledJob> getJobList() throws XServicesFault;
58
	public abstract List<ScheduledJob> getJobList() throws XServicesFault;
58
	
59
	
59
	/**
60
	/**
60
	 * Add a job to the scheduler.
61
	 * Add a job to the scheduler.
61
	 * 
62
	 * 
62
	 * @param job
63
	 * @param job
63
	 * @return The unique identifier of the job.
64
	 * @return The unique identifier of the job.
64
	 * @throws XServicesFault
65
	 * @throws XServicesFault
65
	 */
66
	 */
66
	@WebMethod(operationName=OPERATION_SCHEDULEJOB)
67
	@WebMethod(operationName=OPERATION_SCHEDULEJOB)
67
	@WSDLDocumentation(value="Schedule a job")
68
	@WSDLDocumentation(value="Schedule a job")
68
	public abstract String scheduleJob(
69
	public abstract String scheduleJob(
69
			@WebParam(name=PARAM_JOB) @XmlElement(required=true) ScheduledJob job)
70
			@WebParam(name=PARAM_JOB) @XmlElement(required=true) ScheduledJob job)
70
			throws XServicesFault;
71
			throws XServicesFault;
71
	
72
	
72
	/**
73
	/**
73
	 * Get a job by id.
74
	 * Get a job by id.
74
	 * 
75
	 * 
75
	 * @param uuid
76
	 * @param uuid
76
	 * @return Job details
77
	 * @return Job details
77
	 * @throws XServicesFault
78
	 * @throws XServicesFault
78
	 */
79
	 */
79
	@WebMethod(operationName=OPERATION_GETJOB)
80
	@WebMethod(operationName=OPERATION_GETJOB)
80
	@WSDLDocumentation(value="Get a job by id")
81
	@WSDLDocumentation(value="Get a job by id")
81
	public abstract ScheduledJob getJob(
82
	public abstract ScheduledJob getJob(
82
			@WebParam(name="id") @XmlElement(required=true) String uuid) throws XServicesFault;
83
			@WebParam(name="id") @XmlElement(required=true) String uuid) throws XServicesFault;
83
	
84
	
84
	/**
85
	/**
85
	 * Delete a job from scheduler.
86
	 * Delete a job from scheduler.
86
	 * 
87
	 * 
87
	 * @param uuid Id of the job that should be deleted
88
	 * @param uuid Id of the job that should be deleted
88
	 * @throws XServicesFault
89
	 * @throws XServicesFault
89
	 */
90
	 */
90
	@WebMethod(operationName=OPERATION_DELETEJOB)
91
	@WebMethod(operationName=OPERATION_DELETEJOB)
91
	@WSDLDocumentation(value="Delete a scheduled job.")
92
	@WSDLDocumentation(value="Delete a scheduled job.")
92
	public abstract void deleteJob(
93
	public abstract void deleteJob(
93
			@WebParam(name="id") @XmlElement(required=true) String uuid) throws XServicesFault;
94
			@WebParam(name="id") @XmlElement(required=true) String uuid) throws XServicesFault;
-
 
95
	
-
 
96
	/**
-
 
97
	 * Get statisctis about the scheduler
94
	
98
	 * @throws XServicesFault 
-
 
99
	 */
-
 
100
	@WebMethod(operationName=OPERATION_GETSTATISTICS)
-
 
101
	@WSDLDocumentation(value="Get scheduler statistics")
95
	
102
	public abstract SchedulerStatisticsType getStatistics() throws XServicesFault;
96
	
103
	
97
}
104
}