WebSVN – XServices – Diff – /xservices/trunk/src/java/net/brutex/xservices/ws/JobService.java


/*
 *   Copyright 2011 Brian Rosenberger (Brutex Network)
 *
 *   Licensed under the Apache License, Version 2.0 (the "License");
 *   you may not use this file except in compliance with the License.
 *   You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 *   Unless required by applicable law or agreed to in writing, software
 *   distributed under the License is distributed on an "AS IS" BASIS,
 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *   See the License for the specific language governing permissions and
 *   limitations under the License.
 */
 
package net.brutex.xservices.ws;
 
import java.util.List;
 
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;
import javax.xml.bind.annotation.XmlElement;
 
import net.brutex.xservices.types.ScheduledJob;
 
import net.brutex.xservices.util.BrutexNamespaces;
 
import org.apache.cxf.annotations.WSDLDocumentation;
 
/**
 * Job management services.
 * @author Brian Rosenberger
 * @since 0.5.0
 *
 */
@WebService(targetNamespace = BrutexNamespaces.WS_XSERVICES)
public interface JobService {
	
	public static final String SERVICE_NAME = "JobService";
	final String OPERATION_GETJOBLIST = "getJobs";
	final String OPERATION_SCHEDULEJOB = "scheduleJob";
	final String OPERATION_GETJOB = "getJob";
	final String OPERATION_DELETEJOB = "deleteJob";
 
	
	final String PARAM_JOB = "job";
	
	
	/**
	 * Get a full list of all scheduled jobs.
	 * 
	 * @return List of scheduled jobs
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_GETJOBLIST)
	@WSDLDocumentation(value="Get list of scheduled jobs")
	public abstract List<ScheduledJob> getJobList() throws XServicesFault;
	
	/**
	 * Add a job to the scheduler.
	 * 
	 * @param job
	 * @return The unique identifier of the job.
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_SCHEDULEJOB)
	@WSDLDocumentation(value="Schedule a job")
	public abstract String scheduleJob(
			@WebParam(name=PARAM_JOB) @XmlElement(required=true) ScheduledJob job)
			throws XServicesFault;
	
	/**
	 * Get a job by id.
	 * 
	 * @param uuid
	 * @return Job details
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_GETJOB)
	@WSDLDocumentation(value="Get a job by id")
	public abstract ScheduledJob getJob(
			@WebParam(name="id") @XmlElement(required=true) String uuid) throws XServicesFault;
	
	/**
	 * Delete a job from scheduler.
	 * 
	 * @param uuid Id of the job that should be deleted
	 * @throws XServicesFault
	 */
	@WebMethod(operationName=OPERATION_DELETEJOB)
	@WSDLDocumentation(value="Delete a scheduled job.")
	public abstract void deleteJob(
			@WebParam(name="id") @XmlElement(required=true) String uuid) throws XServicesFault;
 
 
 
	
 
 
 
	
	
}

Subversion Repositories XServices

(root)/xservices/trunk/src/java/net/brutex/xservices/ws/JobService.java – Rev 87 → 111

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	`}`