ca.eandb.jdcp.server

Class JobServer

java.lang.Object

ca.eandb.jdcp.server.JobServer

All Implemented Interfaces:

JobService, TaskService, Remote

public final class JobServer
extends Object
implements JobService

A JobService implementation.

Author:

Brad Kimmel

Field Summary

Fields inherited from interface ca.eandb.jdcp.remote.JobService

DEFAULT_PRIORITY

Constructor Summary

Constructors

Constructor and Description
JobServer(File outputDirectory, ca.eandb.util.progress.ProgressMonitorFactory monitorFactory, TaskScheduler scheduler, ParentClassManager classManager) Creates a new JobServer.
JobServer(File outputDirectory, ca.eandb.util.progress.ProgressMonitorFactory monitorFactory, TaskScheduler scheduler, ParentClassManager classManager, Executor executor) Creates a new JobServer.

Method Summary

Modifier and Type	Method and Description
void	cancelJob(UUID jobId)
UUID	createJob(String description)
byte[]	getClassDefinition(String name, UUID jobId)
byte[]	getClassDigest(String name)
byte[]	getClassDigest(String name, UUID jobId)
BitSet	getFinishedTasks(UUID[] jobIds, int[] taskIds)
JobStatus	getJobStatus(UUID jobId)
ca.eandb.util.rmi.Serialized<TaskWorker>	getTaskWorker(UUID jobId)
void	registerTaskService(String name, TaskService service)
void	reportException(UUID jobId, int taskId, Exception e)
TaskDescription	requestTask()
void	setClassDefinition(String name, byte[] def)
void	setClassDefinition(String name, UUID jobId, byte[] def)
void	setIdleTime(int idleSeconds)
void	setJobPriority(UUID jobId, int priority)
UUID	submitJob(ca.eandb.util.rmi.Serialized<ParallelizableJob> job, String description)
void	submitJob(ca.eandb.util.rmi.Serialized<ParallelizableJob> job, UUID jobId)
void	submitTaskResults(UUID jobId, int taskId, ca.eandb.util.rmi.Serialized<Object> results)
void	unregisterTaskService(String name)
JobStatus	waitForJobStatusChange(long lastEventId, long timeoutMillis)
JobStatus	waitForJobStatusChange(UUID jobId, long lastEventId, long timeoutMillis)

Methods inherited from class java.lang.Object

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

Constructor Detail

JobServer

public JobServer(File outputDirectory,
                 ca.eandb.util.progress.ProgressMonitorFactory monitorFactory,
                 TaskScheduler scheduler,
                 ParentClassManager classManager,
                 Executor executor)
          throws IllegalArgumentException

Creates a new JobServer.

Parameters:

outputDirectory - The directory to write job results to.

monitorFactory - The ProgressMonitorFactory to use to create ProgressMonitors for individual jobs.

scheduler - The TaskScheduler to use to assign tasks.

classManager - The ParentClassManager to use to store and retrieve class definitions.

executor - The Executor to use to run bits of code that should not hold up the remote caller.

Throws:

IllegalArgumentException

JobServer

public JobServer(File outputDirectory,
                 ca.eandb.util.progress.ProgressMonitorFactory monitorFactory,
                 TaskScheduler scheduler,
                 ParentClassManager classManager)
          throws IllegalArgumentException

Creates a new JobServer.

Parameters:

outputDirectory - The directory to write job results to.

monitorFactory - The ProgressMonitorFactory to use to create ProgressMonitors for individual jobs.

scheduler - The TaskScheduler to use to assign tasks.

classManager - The ParentClassManager to use to store and retrieve class definitions.

Throws:

IllegalArgumentException

Method Detail

createJob

public UUID createJob(String description)
               throws SecurityException

Specified by:

createJob in interface JobService

Throws:

SecurityException

submitJob

public void submitJob(ca.eandb.util.rmi.Serialized<ParallelizableJob> job,
                      UUID jobId)
               throws IllegalArgumentException,
                      SecurityException,
                      ClassNotFoundException,
                      JobExecutionException

Specified by:

submitJob in interface JobService

Throws:

IllegalArgumentException

SecurityException

ClassNotFoundException

JobExecutionException

submitJob

public UUID submitJob(ca.eandb.util.rmi.Serialized<ParallelizableJob> job,
                      String description)
               throws SecurityException,
                      ClassNotFoundException,
                      JobExecutionException

Specified by:

submitJob in interface JobService

Throws:

SecurityException

ClassNotFoundException

JobExecutionException

cancelJob

public void cancelJob(UUID jobId)
               throws IllegalArgumentException,
                      SecurityException

Specified by:

cancelJob in interface JobService

Throws:

IllegalArgumentException

SecurityException

getTaskWorker

public ca.eandb.util.rmi.Serialized<TaskWorker> getTaskWorker(UUID jobId)
                                                       throws IllegalArgumentException,
                                                              SecurityException

Specified by:

getTaskWorker in interface TaskService

Throws:

IllegalArgumentException

SecurityException

requestTask

public TaskDescription requestTask()
                            throws SecurityException

Specified by:

requestTask in interface TaskService

Throws:

SecurityException

submitTaskResults

public void submitTaskResults(UUID jobId,
                              int taskId,
                              ca.eandb.util.rmi.Serialized<Object> results)
                       throws SecurityException

Specified by:

submitTaskResults in interface TaskService

Throws:

SecurityException

reportException

public void reportException(UUID jobId,
                            int taskId,
                            Exception e)
                     throws SecurityException,
                            RemoteException

Specified by:

reportException in interface TaskService

Throws:

SecurityException

RemoteException

getFinishedTasks

public BitSet getFinishedTasks(UUID[] jobIds,
                               int[] taskIds)
                        throws IllegalArgumentException,
                               SecurityException,
                               RemoteException

Specified by:

getFinishedTasks in interface TaskService

Throws:

IllegalArgumentException

SecurityException

RemoteException

getClassDefinition

public byte[] getClassDefinition(String name,
                                 UUID jobId)
                          throws SecurityException

Specified by:

getClassDefinition in interface TaskService

Throws:

SecurityException

getClassDigest

public byte[] getClassDigest(String name,
                             UUID jobId)
                      throws SecurityException

Specified by:

getClassDigest in interface TaskService

Throws:

SecurityException

getClassDigest

public byte[] getClassDigest(String name)
                      throws SecurityException

Specified by:

getClassDigest in interface JobService

Throws:

SecurityException

setClassDefinition

public void setClassDefinition(String name,
                               byte[] def)
                        throws SecurityException

Specified by:

setClassDefinition in interface JobService

Throws:

SecurityException

setClassDefinition

public void setClassDefinition(String name,
                               UUID jobId,
                               byte[] def)
                        throws IllegalArgumentException,
                               SecurityException

Specified by:

setClassDefinition in interface JobService

Throws:

IllegalArgumentException

SecurityException

setIdleTime

public void setIdleTime(int idleSeconds)
                 throws IllegalArgumentException,
                        SecurityException

Specified by:

setIdleTime in interface JobService

Throws:

IllegalArgumentException

SecurityException

setJobPriority

public void setJobPriority(UUID jobId,
                           int priority)
                    throws IllegalArgumentException,
                           SecurityException

Specified by:

setJobPriority in interface JobService

Throws:

IllegalArgumentException

SecurityException

registerTaskService

public void registerTaskService(String name,
                                TaskService service)
                         throws SecurityException,
                                RemoteException

Specified by:

registerTaskService in interface JobService

Throws:

SecurityException

RemoteException

unregisterTaskService

public void unregisterTaskService(String name)
                           throws SecurityException,
                                  RemoteException

Specified by:

unregisterTaskService in interface JobService

Throws:

SecurityException

RemoteException

waitForJobStatusChange

public JobStatus waitForJobStatusChange(long lastEventId,
                                        long timeoutMillis)
                                 throws SecurityException,
                                        RemoteException

Specified by:

waitForJobStatusChange in interface JobService

Throws:

SecurityException

RemoteException

waitForJobStatusChange

public JobStatus waitForJobStatusChange(UUID jobId,
                                        long lastEventId,
                                        long timeoutMillis)
                                 throws IllegalArgumentException,
                                        SecurityException,
                                        RemoteException

Specified by:

waitForJobStatusChange in interface JobService

Throws:

IllegalArgumentException

SecurityException

RemoteException

getJobStatus

public JobStatus getJobStatus(UUID jobId)
                       throws IllegalArgumentException,
                              SecurityException,
                              RemoteException

Specified by:

getJobStatus in interface JobService

Throws:

IllegalArgumentException

SecurityException

RemoteException