to.etc.webapp.pendingoperations

Class PendingOperationTaskProvider

java.lang.Object

to.etc.webapp.pendingoperations.PendingOperationTaskProvider

All Implemented Interfaces:

IPollQueueTaskProvider

public class PendingOperationTaskProvider
extends Object
implements IPollQueueTaskProvider

This polled task provider checks for tasks to execute in the sys_pending_operations table. It handles all polling chores and properly handles all order requirements for pending operations. Operations here are checked only every 5 minutes.

Author:

Frits Jalvingh Created on Mar 4, 2009

Method Summary

Modifier and Type	Method and Description
void	addListener(IPendingOperationListener l)
IPendingOperationExecutor	findExecutor(PendingOperation po) Find an executor for a given pendingOperation type.
PendingJobProgressInfo	getCurrentProgress(String externalId) Gets current progress of a scheduled or running calculation of a given scenario (externalId)
static PendingOperationTaskProvider	getInstance()
Runnable	getRunnableTask() This checks for a new pending operation to execute.
static void	initialize(DataSource ds, String serverID) Initializes this thing, and adds it to the worker queue handler.
void	initializeOnRegistration(PollingWorkerQueue pwq)
boolean	isBusyWithJob(String externalId) Checks to see if there already is scheduled or running calculation of a given scenario (externalId).
void	registerPendingOperationType(String type, IPendingOperationExecutor pox) Register a pending operation type and it's executor.
void	removeListener(IPendingOperationListener l)
void	saveOperation(PendingOperation po, Serializable object) Store a PendingOperation in the table, or die.
void	saveOperation(PendingOperation po, StringInputStream sis) Store a PendingOperation in the table, or die.
protected void	updateProgress(PendingOperation po) Updates the current progress of a given pending operation.

Methods inherited from class java.lang.Object

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

Method Detail

initialize

public static void initialize(DataSource ds,
                              String serverID)

Initializes this thing, and adds it to the worker queue handler.

Parameters:

serverID -

getInstance

public static PendingOperationTaskProvider getInstance()

addListener

public void addListener(IPendingOperationListener l)

removeListener

public void removeListener(IPendingOperationListener l)

initializeOnRegistration

public void initializeOnRegistration(PollingWorkerQueue pwq)
                              throws Exception

Specified by:

initializeOnRegistration in interface IPollQueueTaskProvider

Throws:

Exception

getRunnableTask

public Runnable getRunnableTask()
                         throws Exception

This checks for a new pending operation to execute. Only one thread can use this operation at a time. The first thread that enters this method obtains the baton and is allowed to continue. Other threads entering see that the baton is used and exit immediately, without a task.

Specified by:

getRunnableTask in interface IPollQueueTaskProvider

Returns:

Throws:

Exception

See Also:

IPollQueueTaskProvider.getRunnableTask()

registerPendingOperationType

public void registerPendingOperationType(String type,
                                         IPendingOperationExecutor pox)

Register a pending operation type and it's executor.

Parameters:

type -

pox -

findExecutor

public IPendingOperationExecutor findExecutor(PendingOperation po)

Find an executor for a given pendingOperation type.

Parameters:

po -

Returns:

saveOperation

public void saveOperation(PendingOperation po,
                          StringInputStream sis)
                   throws Exception

Store a PendingOperation in the table, or die.

Parameters:

po -

sis -

Throws:

Exception

saveOperation

public void saveOperation(PendingOperation po,
                          Serializable object)
                   throws Exception

Store a PendingOperation in the table, or die.

Parameters:

po -

sis -

Throws:

Exception

updateProgress

protected void updateProgress(PendingOperation po)
                       throws SQLException

Updates the current progress of a given pending operation.

Parameters:

po -

Throws:

SQLException

getCurrentProgress

public PendingJobProgressInfo getCurrentProgress(String externalId)
                                          throws SQLException

Gets current progress of a scheduled or running calculation of a given scenario (externalId)

Parameters:

externalId -

Returns:

Throws:

SQLException

isBusyWithJob

public boolean isBusyWithJob(String externalId)
                      throws SQLException

Checks to see if there already is scheduled or running calculation of a given scenario (externalId).

Parameters:

externalId -

Returns:

Throws:

SQLException