Que v0.3.1 Que.Persistence

Provides a high-level API to interact with Jobs in Database

This module is a behaviour that delegates calls to the specified adapter. It has been designed in a way that it’s easy to write custom adapters for other databases or stores like Redis, even though there are no current plans on supporting anything other than Mnesia.

Summary

Functions

Returns all Que.Jobs in the database

Returns completed Que.Jobs from the database

Deletes a Que.Job from the database

Returns failed Que.Jobs from the database

Finds a Que.Job from the database

Returns all Que.Jobs for the given worker

Returns incomplete Que.Jobs from the database

Makes sure that the Database is ready to be used

Inserts a Que.Job into the database

Updates an existing Que.Job in the database

Functions

all()
all() :: [Que.Job.t]

Returns all Que.Jobs in the database.

completed()
completed() :: [Que.Job.t]

Returns completed Que.Jobs from the database.

destroy(id)
destroy(id :: integer) :: :ok | no_return

Deletes a Que.Job from the database.

failed()
failed() :: [Que.Job.t]

Returns failed Que.Jobs from the database.

find(id)
find(id :: integer) :: Que.Job.t | nil

Finds a Que.Job from the database.

Returns the a Job struct if it’s found, otherwise nil.

for_worker(worker)
for_worker(worker :: Que.Worker.t) :: [Que.Job.t]

Returns all Que.Jobs for the given worker.

incomplete()
incomplete() :: [Que.Job.t]

Returns incomplete Que.Jobs from the database.

This includes all Jobs whose status is either :queued or :started but not :failed.

initialize()
initialize() :: :ok | :error

Makes sure that the Database is ready to be used.

This is called when the Que application, specifically Que.Server, starts to make sure that a database exists and is ready to be used.

insert(job)
insert(job :: Que.Job.t) :: Que.Job.t

Inserts a Que.Job into the database.

Returns the same Job struct with the id value set

update(job)
update(job :: Que.Job.t) :: Que.Job.t

Updates an existing Que.Job in the database.

This methods finds the job to update by the given job’s id. If no job with the given id exists, it is inserted as-is. If the id of the given job is nil, it’s still inserted and a valid id is assigned.

Returns the updated job.