net.greghaines.jesque.client

Class AbstractClient

java.lang.Object

net.greghaines.jesque.client.AbstractClient

All Implemented Interfaces:

Client

Direct Known Subclasses:

ClientImpl, ClientPoolImpl

public abstract class AbstractClient
extends Object
implements Client

Common logic for Client implementations.

Author:

Greg Haines

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractClient(Config config)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	acquireLock(String lockName, String lockHolder, Integer timeout) A non blocking lock utilizing Redis to create a lock that can be utilized by distributed servers.
static boolean	doAcquireLock(redis.clients.jedis.Jedis jedis, String namespace, String lockName, String lockHolder, Integer timeout) Helper method that encapsulates the logic to acquire a lock.
protected abstract boolean	doAcquireLock(String lockName, String lockHolder, Integer timeout) Actually acquire the lock based upon the client acquisition model
static void	doEnqueue(redis.clients.jedis.Jedis jedis, String namespace, String queue, String jobJson) Helper method that encapsulates the minimum logic for adding a job to a queue.
protected abstract void	doEnqueue(String queue, String msg) Actually enqueue the serialized job.
static void	doPriorityEnqueue(redis.clients.jedis.Jedis jedis, String namespace, String queue, String jobJson) Helper method that encapsulates the minimum logic for adding a high priority job to a queue.
protected abstract void	doPriorityEnqueue(String queue, String msg) Actually enqueue the serialized job with high priority.
void	enqueue(String queue, Job job) Queues a job in a given queue to be run.
protected String	getNamespace()
protected String	key(String... parts) Builds a namespaced Redis key with the given arguments.
void	priorityEnqueue(String queue, Job job) Queues a job with high priority in a given queue to be run.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.greghaines.jesque.client.Client

end

Constructor Detail

AbstractClient

protected AbstractClient(Config config)

Parameters:

config - used to get the namespace for key creation

Method Detail

getNamespace

protected String getNamespace()

Returns:

the namespace this client will use

key

protected String key(String... parts)

Builds a namespaced Redis key with the given arguments.

Parameters:

parts - the key parts to be joined

Returns:

an assembled String key

enqueue

public void enqueue(String queue,
           Job job)

Description copied from interface: Client

Queues a job in a given queue to be run.

Specified by:

enqueue in interface Client

Parameters:

queue - the queue to add the Job to

job - the job to be enqueued

priorityEnqueue

public void priorityEnqueue(String queue,
                   Job job)

Description copied from interface: Client

Queues a job with high priority in a given queue to be run.

Specified by:

priorityEnqueue in interface Client

Parameters:

queue - the queue to add the Job to

job - the job to be enqueued

acquireLock

public boolean acquireLock(String lockName,
                  String lockHolder,
                  Integer timeout)

Description copied from interface: Client

A non blocking lock utilizing Redis to create a lock that can be utilized by distributed servers. Call this method again to renew your lock before it expires if you wish to guarantee holding the lock.

Specified by:

acquireLock in interface Client

Parameters:

lockName - all calls to this method will contend for a unique lock with the name of lockName

lockHolder - a unique string used to tell if you are the current holder of a lock for both acquisition, and extension

timeout - seconds until the lock will expire

Returns:

Whether or not the lock was acquired.

doEnqueue

protected abstract void doEnqueue(String queue,
             String msg)
                           throws Exception

Actually enqueue the serialized job.

Parameters:

queue - the queue to add the Job to

msg - the serialized Job

Throws:

Exception - in case something goes wrong

doPriorityEnqueue

protected abstract void doPriorityEnqueue(String queue,
                     String msg)
                                   throws Exception

Actually enqueue the serialized job with high priority.

Parameters:

queue - the queue to add the Job to

msg - the serialized Job

Throws:

Exception - in case something goes wrong

doAcquireLock

protected abstract boolean doAcquireLock(String lockName,
                    String lockHolder,
                    Integer timeout)
                                  throws Exception

Actually acquire the lock based upon the client acquisition model

Parameters:

lockName - all calls to this method will contend for a unique lock with the name of lockName

timeout - seconds until the lock will expire

lockHolder - a unique string used to tell if you are the current holder of a lock for both acquisition, and extension

Returns:

Whether or not the lock was acquired.

Throws:

Exception

doEnqueue

public static void doEnqueue(redis.clients.jedis.Jedis jedis,
             String namespace,
             String queue,
             String jobJson)

Helper method that encapsulates the minimum logic for adding a job to a queue.

Parameters:

jedis - the connection to Redis

namespace - the Resque namespace

queue - the Resque queue name

jobJson - the job serialized as JSON

doPriorityEnqueue

public static void doPriorityEnqueue(redis.clients.jedis.Jedis jedis,
                     String namespace,
                     String queue,
                     String jobJson)

Helper method that encapsulates the minimum logic for adding a high priority job to a queue.

Parameters:

jedis - the connection to Redis

namespace - the Resque namespace

queue - the Resque queue name

jobJson - the job serialized as JSON

doAcquireLock

public static boolean doAcquireLock(redis.clients.jedis.Jedis jedis,
                    String namespace,
                    String lockName,
                    String lockHolder,
                    Integer timeout)

Helper method that encapsulates the logic to acquire a lock.

Parameters:

jedis - the connection to Redis

namespace - the Resque namespace

lockName - all calls to this method will contend for a unique lock with the name of lockName

timeout - seconds until the lock will expire

lockHolder - a unique string used to tell if you are the current holder of a lock for both acquisition, and extension

Returns:

Whether or not the lock was acquired.