com.laserfiche.repository.api.clients.impl

Class TasksClientImpl

java.lang.Object

com.laserfiche.repository.api.clients.impl.ApiClient

com.laserfiche.repository.api.clients.impl.TasksClientImpl

All Implemented Interfaces:

TasksClient

public class TasksClientImpl
extends ApiClient
implements TasksClient

The Laserfiche Repository Tasks API client.

Field Summary

Fields inherited from class com.laserfiche.repository.api.clients.impl.ApiClient

baseUrl, httpClient, httpRequestHandler, objectMapper

Constructor Summary

Constructors

Constructor and Description
TasksClientImpl(String baseUrl, kong.unirest.UnirestInstance httpClient, com.laserfiche.api.client.httphandlers.HttpRequestHandler httpRequestHandler)

Method Summary

Modifier and Type	Method and Description
CancelTasksResponse	cancelTasks(ParametersForCancelTasks parameters) - Starts the cancellation for a set of one or more tasks. - Provide comma-separated list of task IDs to cancel.
TaskCollectionResponse	listTasks(ParametersForListTasks parameters) - Returns the status of a set of one or more tasks. - Provide a comma-separated list of task IDs to get the task status, progress, and any errors that may have occurred. - Leave the taskIds query parameter empty, to get the list of all the task IDs associated with the current access token. - TaskStatus can be one of the following values: NotStarted, InProgress, Completed, Cancelled, or Failed. - This API employs long polling technique and could return the result immediately (e.g.

Methods inherited from class com.laserfiche.repository.api.clients.impl.ApiClient

toJson

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TasksClientImpl

public TasksClientImpl(String baseUrl,
                       kong.unirest.UnirestInstance httpClient,
                       com.laserfiche.api.client.httphandlers.HttpRequestHandler httpRequestHandler)

Method Detail

listTasks

public TaskCollectionResponse listTasks(ParametersForListTasks parameters)

Description copied from interface: TasksClient

- Returns the status of a set of one or more tasks.
- Provide a comma-separated list of task IDs to get the task status, progress, and any errors that may have occurred.
- Leave the taskIds query parameter empty, to get the list of all the task IDs associated with the current access token.
- TaskStatus can be one of the following values: NotStarted, InProgress, Completed, Cancelled, or Failed.
- This API employs long polling technique and could return the result immediately (e.g. if the export operation is failed or completed successfully) or after at most 60 seconds.
- Required OAuth scope: None

Specified by:

listTasks in interface TasksClient

Parameters:

parameters - An object of type ParametersForListTasks which encapsulates the parameters of listTasks method.

Returns:

TaskCollectionResponse The return value

cancelTasks

public CancelTasksResponse cancelTasks(ParametersForCancelTasks parameters)

Description copied from interface: TasksClient

- Starts the cancellation for a set of one or more tasks.
- Provide comma-separated list of task IDs to cancel. Should be used if an operation was created in error, or is no longer necessary.
- Check the status of the task to determine if the task has been cancelled successfully.
- Leave the taskIds query parameter empty, to cancel the list of all the task IDs associated with the current access token.
- Rollbacks must be done manually. For example, if a copy operation is started and is halfway complete when canceled, the client application is responsible for cleaning up the files that were successfully copied before the operation was canceled.
- Required OAuth scope: None

Specified by:

cancelTasks in interface TasksClient

Parameters:

parameters - An object of type ParametersForCancelTasks which encapsulates the parameters of cancelTasks method.

Returns:

CancelTasksResponse The return value