ai.grakn.engine.tasks.manager.redisqueue

Class RedisTaskStorage

java.lang.Object

ai.grakn.engine.tasks.manager.redisqueue.RedisTaskStorage

All Implemented Interfaces:

TaskStateStorage

public class RedisTaskStorage
extends Object
implements TaskStateStorage

DAO for redis task states

Author:

Domenico Corapi

Method Summary

Modifier and Type	Method and Description
boolean	containsTask(ai.grakn.engine.TaskId id) Returns whether the storage contains the given task
static RedisTaskStorage	create(redis.clients.util.Pool<redis.clients.jedis.Jedis> jedisPool, com.codahale.metrics.MetricRegistry metricRegistry)
TaskState	getState(ai.grakn.engine.TaskId id) This is a copy of the internal TaskState object.
Set<TaskState>	getTasks(ai.grakn.engine.TaskStatus taskStatus, String taskClassName, String createdBy, EngineID runningOnEngine, int limit, int offset) Return a Set of Pairs of tasks that match any of the criteria.
ai.grakn.engine.TaskId	newState(TaskState state) Create a new task state and store it, returning an ID to later access this task state.
Boolean	updateState(TaskState state) Used to update task state.

Methods inherited from class java.lang.Object

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

Method Detail

create

public static RedisTaskStorage create(redis.clients.util.Pool<redis.clients.jedis.Jedis> jedisPool,
                                      com.codahale.metrics.MetricRegistry metricRegistry)

newState

public ai.grakn.engine.TaskId newState(TaskState state)
                                throws ai.grakn.exception.GraknBackendException

Description copied from interface: TaskStateStorage

Create a new task state and store it, returning an ID to later access this task state.

Specified by:

newState in interface TaskStateStorage

Parameters:

state - State to insert.

Returns:

String form of the task id, which can be use later to update or retrieve the task state. Null if task could not be created of mandatory fields were omitted.

Throws:

ai.grakn.exception.GraknBackendException

updateState

public Boolean updateState(TaskState state)

Description copied from interface: TaskStateStorage

Used to update task state. With the exception of @id any other fields may individually be null, however all parameters cannot be null at the same time. Setting any of the parameters to null indicates that their values should not be changed.

Specified by:

updateState in interface TaskStateStorage

Parameters:

state - State to update.

Returns:

true if inserted successfully

getState

@Nullable
public TaskState getState(ai.grakn.engine.TaskId id)
                             throws ai.grakn.exception.GraknBackendException

Description copied from interface: TaskStateStorage

This is a copy of the internal TaskState object. It is guaranteed to be correct at the time of call, however the actual internal state may change at any time after.

Specified by:

getState in interface TaskStateStorage

Parameters:

id - String id of task.

Returns:

TaskState object or null if no TaskState with this id could be found.

Throws:

ai.grakn.exception.GraknBackendException

containsTask

public boolean containsTask(ai.grakn.engine.TaskId id)

Description copied from interface: TaskStateStorage

Returns whether the storage contains the given task

Specified by:

containsTask in interface TaskStateStorage

Parameters:

id - String id of task

Returns:

true if the storage contains the given state

getTasks

public Set<TaskState> getTasks(ai.grakn.engine.TaskStatus taskStatus,
                               String taskClassName,
                               String createdBy,
                               EngineID runningOnEngine,
                               int limit,
                               int offset)

Description copied from interface: TaskStateStorage

Return a Set of Pairs of tasks that match any of the criteria. The first value of the Pair is the task id, whilst the second is the TaskState. Parameters may be set to null to not match against then (rather than to match null values), if *all* parameters are null then all known tasks in the system are returned.

Specified by:

getTasks in interface TaskStateStorage

Parameters:

taskStatus - See TaskStatus enum.

taskClassName - String containing task class name. See TaskState.

createdBy - String containing created by. See TaskState.

runningOnEngine - Engine that the task is running on.

limit - Limit the returned result set to @limit amount of entries.

offset - Use in conjunction with @limit for pagination.

Returns:

Set of TaskStates corresponding to search