com.jcorporate.expresso.services.job
Class ValidationJob

java.lang.Object
  java.lang.Thread
      com.jcorporate.expresso.core.registry.ExpressoThread
          com.jcorporate.expresso.core.job.Job
              com.jcorporate.expresso.services.job.ValidationJob

All Implemented Interfaces:

Runnable

public class ValidationJob

extends Job

This class implements an Expresso Job, which is a background task, to decouple the user selecting some action that requires validation, from the mechanics of storing the user/application-selected parameters and starting the processing. The primary reason for using a Job here is to allow load-balancing if required, and also to make the UI appear much faster (since otherwise the user would have to wait until the entire function finished).

The submission of the job is done using the ValidationEntry class.

Version:

$Revision: 1.13 $ $Date: 2004/11/17 20:48:18 $

Author:

Shash Chatterjee

Field Summary

Fields inherited from class com.jcorporate.expresso.core.job.Job

IS_NOTIFY_ON_JOB_SUCCESS

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

ValidationJob()
The default constructor for instantiating a new job.

Method Summary

String	getTitle() The name of this Job, used typically in UI screens Creation date: (9/23/2001 9:30:54 AM) Author: Shash Chatterjee
protected void	initialize() This method initializes the job, currently all it does is to log a message.
void	run() This method actually implements the "meat" of the Job.

Methods inherited from class com.jcorporate.expresso.core.job.Job

addFunction, addParameter, addParamValidValues, finish, finish, getCronAlarmEntry, getDataContext, getFunctions, getJobNumber, getJobParameter, getJobParameterList, getJobQueueEntry, getParameterDescription, getParameterNamesAndDescriptions, getParamValidValues, getSchema, getString, getString, getString, getString, getString, getString, getUser, hasParameters, instantiate, multiThreaded, sendMail, setCronAlarmEntry, setQueue, setSchema, setUseCron, useCron

Methods inherited from class com.jcorporate.expresso.core.registry.ExpressoThread

getThreadContext

Methods inherited from class java.lang.Thread

activeCount, checkAccess, countStackFrames, currentThread, destroy, dumpStack, enumerate, getContextClassLoader, getName, getPriority, getThreadGroup, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setName, setPriority, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Constructor Detail

ValidationJob

public ValidationJob()

The default constructor for instantiating a new job.

Creation date: (9/23/2001 9:25:23 AM) Author: Shash Chatterjee

Method Detail

getTitle

public String getTitle()

The name of this Job, used typically in UI screens Creation date: (9/23/2001 9:30:54 AM) Author: Shash Chatterjee

Overrides:

getTitle in class Job

Returns:

The title

initialize

protected void initialize()
                   throws AuthValidationException

This method initializes the job, currently all it does is to log a message. Creation date: (9/23/2001 9:31:39 AM) Author: Shash Chatterjee

Throws:

AuthValidationException - If there is a DB error getting job queue entry id

run

public void run()

This method actually implements the "meat" of the Job. It's purpose is to take the parameters given the job when it was submitted and then store them into the validation subsystem. It also invokes a application-specific "validation handler" to allow the application to do all its unique things for whatever validation task it is requesting.

Creation date: (9/23/2001 9:33:35 AM) Author: Shash Chatterjee

Specified by:

run in interface Runnable

Overrides:

run in class Job