Que v0.10.0 Que.Persistence behaviour View Source

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.

Link to this section Summary

Functions

See Que.Persistence.Mnesia.all/0.

See Que.Persistence.Mnesia.all/1.

See Que.Persistence.Mnesia.completed/0.

See Que.Persistence.Mnesia.completed/1.

See Que.Persistence.Mnesia.destroy/1.

See Que.Persistence.Mnesia.failed/0.

See Que.Persistence.Mnesia.failed/1.

See Que.Persistence.Mnesia.find/1.

See Que.Persistence.Mnesia.incomplete/0.

See Que.Persistence.Mnesia.incomplete/1.

See Que.Persistence.Mnesia.initialize/0.

See Que.Persistence.Mnesia.insert/1.

See Que.Persistence.Mnesia.update/1.

Callbacks

Returns all Que.Jobs in the database.

Returns all Que.Jobs for the given worker.

Returns completed Que.Jobs from the database.

Returns completed Que.Jobs for the given worker.

Deletes a Que.Job from the database.

Returns failed Que.Jobs from the database.

Returns failed Que.Jobs for the given worker.

Finds a Que.Job from the database.

Returns incomplete Que.Jobs from the database.

Returns incomplete Que.Jobs for the given worker.

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.

Link to this section Functions

See Que.Persistence.Mnesia.all/0.

See Que.Persistence.Mnesia.all/1.

See Que.Persistence.Mnesia.completed/0.

See Que.Persistence.Mnesia.completed/1.

See Que.Persistence.Mnesia.destroy/1.

See Que.Persistence.Mnesia.failed/0.

See Que.Persistence.Mnesia.failed/1.

See Que.Persistence.Mnesia.find/1.

See Que.Persistence.Mnesia.incomplete/0.

See Que.Persistence.Mnesia.incomplete/1.

See Que.Persistence.Mnesia.initialize/0.

See Que.Persistence.Mnesia.insert/1.

See Que.Persistence.Mnesia.update/1.

Link to this section Callbacks

Returns all Que.Jobs in the database.

Returns all Que.Jobs for the given worker.

Link to this callback

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

Returns completed Que.Jobs from the database.

Link to this callback

completed(worker) View Source
completed(worker :: Que.Worker.t()) :: [Que.Job.t()]

Returns completed Que.Jobs for the given worker.

Link to this callback

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

Deletes a Que.Job from the database.

Returns failed Que.Jobs from the database.

Link to this callback

failed(worker) View Source
failed(worker :: Que.Worker.t()) :: [Que.Job.t()]

Returns failed Que.Jobs for the given worker.

Link to this callback

find(id) View Source
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.

Link to this callback

incomplete() View Source
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.

Link to this callback

incomplete(worker) View Source
incomplete(worker :: Que.Worker.t()) :: [Que.Job.t()]

Returns incomplete Que.Jobs for the given worker.

Link to this callback

initialize() View Source
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.

Inserts a Que.Job into the database.

Returns the same Job struct with the id value set

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.