ca.eandb.jdcp.remote

Interface TaskService

All Superinterfaces:

Remote

All Known Subinterfaces:

JobService

public interface TaskService
extends Remote

A remote service used by workers to perform tasks for ParallelizableJobs.

Author:

Brad Kimmel

Method Summary

Modifier and Type	Method and Description
byte[]	getClassDefinition(String name, UUID jobId) Gets the definition of the given class associated with the specified job.
byte[]	getClassDigest(String name, UUID jobId) Gets the MD5 digest for the definition of the given class associated with the specified job.
BitSet	getFinishedTasks(UUID[] jobIds, int[] taskIds) Determines if any of the specified tasks are no longer outstanding.
ca.eandb.util.rmi.Serialized<TaskWorker>	getTaskWorker(UUID jobId) Gets the task worker for a job.
void	reportException(UUID jobId, int taskId, Exception e) Report that an exception was thrown during the execution of an assigned task.
TaskDescription	requestTask() Gets a task to perform.
void	submitTaskResults(UUID jobId, int taskId, ca.eandb.util.rmi.Serialized<Object> results) Submits the results of a task.

Method Detail

getTaskWorker

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

Gets the task worker for a job.

Parameters:

jobId - The UUID of the job to obtain the task worker for.

Returns:

The TaskWorker to use to process tasks for the job with the specified UUID, or null if that job is no longer available.

Throws:

DelegationException - If this JobService could not communicate with the provider of the TaskWorker being requested.

IllegalArgumentException - If there is no job on the server with the specified UUID.

SecurityException - If the caller does not have permission to obtain the task worker.

RemoteException - If a communication error occurs.

requestTask

TaskDescription requestTask()
                     throws SecurityException,
                            RemoteException

Gets a task to perform.

Returns:

A TaskDescription describing the task to be performed.

Throws:

SecurityException - If the caller does not have permission to request tasks.

RemoteException - If a communication error occurs.

submitTaskResults

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

Submits the results of a task.

Parameters:

jobId - The UUID identifying the job for which the task was performed.

taskId - The ID of the task that was performed.

results - The results of the task.

Throws:

SecurityException - If the caller does not have permission to submit task results.

RemoteException - If a communication error occurs.

reportException

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

Report that an exception was thrown during the execution of an assigned task.

Parameters:

jobId - The UUID identifying the job for which the task was being performed.

taskId - The ID of the task that was being performed, or zero (0) if the exception was not thrown during the processing of a task (for example, when deserializing the TaskWorker).

e - The Exception raised by the task.

Throws:

SecurityException - If the caller does not have permission to call this method.

RemoteException - If a problem with the connection is encountered.

getFinishedTasks

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

Determines if any of the specified tasks are no longer outstanding.

Parameters:

jobIds - An array of UUID indicating the IDs of the jobs corresponding to the tasks to check.

taskIds - An array indicating the IDs of the tasks to check (must be the same length as jobIds) If a taskId is set to zero (0), then the corresponding bit in the result indicates if the job is complete.

Returns:

A BitSet indicating which tasks are no longer outstanding. If either jobIds or taskIds is null, an empty BitSet is returned.

Throws:

IllegalArgumentException - If jobIds.length != taskIds.length.

SecurityException - If the caller does not have permission to get the completion status of tasks.

RemoteException - If a communication error occurs.

getClassDigest

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

Gets the MD5 digest for the definition of the given class associated with the specified job.

Parameters:

name - The fully qualified name of the class whose digest to obtain.

jobId - The UUID identifying the job for which to get the class digest.

Returns:

The MD5 digest for the definition of the given class associated with the specified job.

Throws:

DelegationException - If this JobService could not communicate with the provider of the class whose digest is being requested.

SecurityException - If the caller does not have permission to obtain class digests.

RemoteException - If a communication error occurs.

getClassDefinition

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

Gets the definition of the given class associated with the specified job.

Parameters:

name - The fully qualified name of the class whose definition to obtain.

jobId - The UUID identifying the job for which to get the class definition.

Returns:

The definition of the given class associated with the specified job.

Throws:

DelegationException - If this JobService could not communicate with the provider of the class whose definition is being requested.

SecurityException - If the caller does not have permission to obtain class definitions.

RemoteException - If a communication error occurs.