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

Interface TaskService

All Superinterfaces:

ExecutableService, JAXRSService

@Path(value="tasks")
public interface TaskService
extends ExecutableService

REST operations for tasks.

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
javax.ws.rs.core.Response	create(@NotNull TaskType type, @NotNull SchedTaskTO taskTO) Creates a new task.
void	delete(@NotNull TaskType type, @NotNull String key) Deletes the task matching the provided key.
javax.ws.rs.core.Response	purgePropagations(Date since, List<ExecStatus> statuses, List<String> resources) Deletes all the propagation tasks whose latest execution is matching the given conditions.
<T extends TaskTO> T	read(@NotNull TaskType type, @NotNull String key, boolean details) Returns the task matching the given key.
<T extends TaskTO> PagedResult<T>	search(TaskQuery query) Returns a paged list of existing tasks matching the given query.
void	update(@NotNull TaskType type, @NotNull SchedTaskTO taskTO) Updates the task matching the provided key.

Methods inherited from interface org.apache.syncope.common.rest.api.service.ExecutableService

actionJob, deleteExecution, deleteExecutions, execute, getJob, listExecutions, listJobs, listRecentExecutions

Method Detail

read

@GET
 @Path(value="{type}/{key}")
 @Produces(value={"application/json","application/yaml","application/xml"})
<T extends TaskTO> T read(@NotNull @PathParam(value="type")
                                                                                                                                        @NotNull TaskType type,
                                                                                                                                        @NotNull @PathParam(value="key")
                                                                                                                                        @NotNull String key,
                                                                                                                                        @QueryParam(value="details") @DefaultValue(value="true")
                                                                                                                                        boolean details)

Returns the task matching the given key.

Type Parameters:

T - type of taskTO

Parameters:

type - task type

key - key of task to be read

details - whether include executions or not, defaults to true

Returns:

task with matching id

search

@GET
 @Path(value="{type}")
 @Produces(value={"application/json","application/yaml","application/xml"})
<T extends TaskTO> PagedResult<T> search(@BeanParam
                                                                                                                                                 TaskQuery query)

Returns a paged list of existing tasks matching the given query.

Type Parameters:

T - type of taskTO

Parameters:

query - query conditions

Returns:

paged list of existing tasks matching the given query

create

@POST
 @Path(value="{type}")
 @Consumes(value={"application/json","application/yaml","application/xml"})
 @Produces(value={"application/json","application/yaml","application/xml"})
javax.ws.rs.core.Response create(@NotNull @PathParam(value="type")
                                                                                                                                                                                                                      @NotNull TaskType type,
                                                                                                                                                                                                                      @NotNull
                                                                                                                                                                                                                      @NotNull SchedTaskTO taskTO)

Creates a new task.

Parameters:

type - task type

taskTO - task to be created

Returns:

Response object featuring Location header of created task

update

@PUT
 @Path(value="{type}/{key}")
 @Consumes(value={"application/json","application/yaml","application/xml"})
 @Produces(value={"application/json","application/yaml","application/xml"})
void update(@NotNull @PathParam(value="type")
                                                                                                                                                                                                      @NotNull TaskType type,
                                                                                                                                                                                                      @NotNull
                                                                                                                                                                                                      @NotNull SchedTaskTO taskTO)

Updates the task matching the provided key.

Parameters:

type - task type

taskTO - updated task to be stored

delete

@DELETE
 @Path(value="{type}/{key}")
 @Produces(value={"application/json","application/yaml","application/xml"})
void delete(@NotNull @PathParam(value="type")
                                                                                                                             @NotNull TaskType type,
                                                                                                                             @NotNull @PathParam(value="key")
                                                                                                                             @NotNull String key)

Deletes the task matching the provided key.

Parameters:

type - task type

key - key of task to be deleted

purgePropagations

@DELETE
 @Path(value="PROPAGATION/purge")
 @Produces(value={"application/json","application/yaml","application/xml"})
javax.ws.rs.core.Response purgePropagations(@QueryParam(value="since")
                                                                                                                                                                  Date since,
                                                                                                                                                                  @QueryParam(value="statuses")
                                                                                                                                                                  List<ExecStatus> statuses,
                                                                                                                                                                  @QueryParam(value="resources")
                                                                                                                                                                  List<String> resources)

Deletes all the propagation tasks whose latest execution is matching the given conditions. At least one matching condition must be specified.

Parameters:

since - match all executions started afterwards

statuses - execution status(es) to match

resources - external resource(s) to match

Returns:

deleted propagation tasks