org.apache.syncope.common.rest.api.service

Interface ExecutableService

All Superinterfaces:

JAXRSService

All Known Subinterfaces:

ReportService, TaskService

public interface ExecutableService
extends JAXRSService

Field Summary

Fields inherited from interface org.apache.syncope.common.rest.api.service.JAXRSService

CRLF, DOUBLE_DASH, PARAM_ANYTYPE_KIND, PARAM_ANYTYPEKEY, PARAM_CONNID_PAGED_RESULTS_COOKIE, PARAM_DETAILS, PARAM_ENTITY_KEY, PARAM_FIQL, PARAM_MAX, PARAM_NOTIFICATION, PARAM_ORDERBY, PARAM_PAGE, PARAM_REALM, PARAM_RESOURCE, PARAM_SIZE, PARAM_USER

Method Summary

Modifier and Type	Method and Description
void	actionJob(@NotNull String key, JobAction action) Executes an action on an existing executable's job.
void	deleteExecution(@NotNull String executionKey) Deletes the executable execution matching the provided key.
javax.ws.rs.core.Response	deleteExecutions(ExecQuery query) Deletes the executions belonging matching the given query.
ExecTO	execute(ExecSpecs query) Executes the executable matching the given query.
JobTO	getJob(String key) Returns job (running or scheduled) for the executable matching the given key.
PagedResult<ExecTO>	listExecutions(ExecQuery query) Returns a paged list of executions matching the given query.
List<JobTO>	listJobs() List jobs (running and / or scheduled).
List<ExecTO>	listRecentExecutions(@Min(value=1L) int max) Returns the list of recently completed executions, ordered by end date descendent.

Method Detail

listExecutions

@GET
 @Path(value="{key}/executions")
 @Produces(value={"application/json","application/yaml","application/xml"})
PagedResult<ExecTO> listExecutions(@BeanParam
                                                                                                                                                     ExecQuery query)

Returns a paged list of executions matching the given query.

Parameters:

query - query conditions

Returns:

paged list of executions the given query

listRecentExecutions

@GET
 @Path(value="executions/recent")
 @Produces(value={"application/json","application/yaml","application/xml"})
List<ExecTO> listRecentExecutions(@Min(value=1L) @QueryParam(value="max") @DefaultValue(value="25")
                                                                                                                                                     @Min(value=1L) int max)

Returns the list of recently completed executions, ordered by end date descendent.

Parameters:

max - the maximum number of executions to return

Returns:

list of recently completed executions, ordered by end date descendent

deleteExecution

@DELETE
 @Path(value="executions/{executionKey}")
 @Produces(value={"application/json","application/yaml","application/xml"})
void deleteExecution(@NotNull @PathParam(value="executionKey")
                                                                                                                                                   @NotNull String executionKey)

Deletes the executable execution matching the provided key.

Parameters:

executionKey - key of executable execution to be deleted

deleteExecutions

@DELETE
 @Path(value="{key}/executions")
 @Produces(value="multipart/mixed")
javax.ws.rs.core.Response deleteExecutions(@BeanParam
                                                                                                                        ExecQuery query)

Deletes the executions belonging matching the given query.

Parameters:

query - query conditions

Returns:

batch results as Response entity

execute

@POST
 @Path(value="{key}/execute")
 @Produces(value={"application/json","application/yaml","application/xml"})
ExecTO execute(@BeanParam
                                                                                                                               ExecSpecs query)

Executes the executable matching the given query.

Parameters:

query - query conditions

Returns:

execution report for the executable matching the given query

getJob

@GET
 @Path(value="jobs/{key}")
 @Produces(value={"application/json","application/yaml","application/xml"})
JobTO getJob(@PathParam(value="key")
                                                                                                                         String key)

Returns job (running or scheduled) for the executable matching the given key.

Parameters:

key - executable key

Returns:

job (running or scheduled) for the given key

listJobs

@GET
 @Path(value="jobs")
 @Produces(value={"application/json","application/yaml","application/xml"})
List<JobTO> listJobs()

List jobs (running and / or scheduled).

Returns:

jobs (running and / or scheduled)

actionJob

@POST
 @Path(value="jobs/{key}")
void actionJob(@NotNull @PathParam(value="key")
                                                @NotNull String key,
                                                @QueryParam(value="action")
                                                JobAction action)

Executes an action on an existing executable's job.

Parameters:

key - executable key

action - action to execute