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

PARAM_ANYTYPE_KIND, PARAM_CONNID_PAGED_RESULTS_COOKIE, PARAM_DETAILS, PARAM_ENTITY_KEY, PARAM_FIQL, PARAM_MAX, PARAM_NOTIFICATION, PARAM_ORDERBY, PARAM_PAGE, PARAM_RESOURCE, PARAM_SIZE

Method Summary

Modifier and Type	Method and Description
void	actionJob(String key, JobAction action) Executes an action on an existing executable's job.
void	deleteExecution(String executionKey) Deletes the executable execution matching the provided key.
BulkActionResult	deleteExecutions(BulkExecDeleteQuery query) Deletes the executions belonging matching the given query.
ExecTO	execute(ExecuteQuery 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(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")
                                                                                                                                                     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")
                                                                                                                                                   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={"application/json","application/yaml","application/xml"})
BulkActionResult deleteExecutions(@BeanParam
                                                                                                                                                       BulkExecDeleteQuery query)

Deletes the executions belonging matching the given query.

Parameters:

query - query conditions

Returns:

bulk action result

execute

@POST
 @Path(value="{key}/execute")
 @Produces(value={"application/json","application/yaml","application/xml"})
ExecTO execute(@BeanParam
                                                                                                                               ExecuteQuery 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")
                                                String key,
                                                @QueryParam(value="action")
                                                JobAction action)

Executes an action on an existing executable's job.

Parameters:

key - executable key

action - action to execute