ca.eandb.jdcp.server

Class JobServiceProxy

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.server.UnicastRemoteObject

ca.eandb.jdcp.server.JobServiceProxy

All Implemented Interfaces:

JobService, TaskService, Serializable, Remote

public final class JobServiceProxy
extends UnicastRemoteObject
implements JobService

A proxy JobService object used by clients of a remote JobService.

Author:

Brad Kimmel

See Also:

Serialized Form

Field Summary

Fields inherited from class java.rmi.server.RemoteObject

ref

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

DEFAULT_PRIORITY

Constructor Summary

Constructors

Constructor and Description
JobServiceProxy(Subject user, JobService service) Creates a new JobServiceProxy.

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 taskService)
void	reportException(UUID jobId, int taskId, Exception ex)
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.rmi.server.UnicastRemoteObject

clone, exportObject, exportObject, exportObject, unexportObject

Methods inherited from class java.rmi.server.RemoteServer

getClientHost, getLog, setLog

Methods inherited from class java.rmi.server.RemoteObject

equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

JobServiceProxy

public JobServiceProxy(Subject user,
                       JobService service)
                throws RemoteException

Creates a new JobServiceProxy.

Parameters:

user - The Subject that the user has authenticated as.

service - The underlying JobService.

Throws:

RemoteException - If a communication error occurs.

Method Detail

cancelJob

public void cancelJob(UUID jobId)
               throws IllegalArgumentException,
                      SecurityException,
                      RemoteException

Specified by:

cancelJob in interface JobService

Throws:

IllegalArgumentException

SecurityException

RemoteException

createJob

public UUID createJob(String description)
               throws SecurityException,
                      RemoteException

Specified by:

createJob in interface JobService

Throws:

SecurityException

RemoteException

getClassDefinition

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

Specified by:

getClassDefinition in interface TaskService

Throws:

SecurityException

RemoteException

getClassDigest

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

Specified by:

getClassDigest in interface TaskService

Throws:

SecurityException

RemoteException

getClassDigest

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

Specified by:

getClassDigest in interface JobService

Throws:

SecurityException

RemoteException

getTaskWorker

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

Specified by:

getTaskWorker in interface TaskService

Throws:

IllegalArgumentException

SecurityException

RemoteException

requestTask

public TaskDescription requestTask()
                            throws SecurityException,
                                   RemoteException

Specified by:

requestTask in interface TaskService

Throws:

SecurityException

RemoteException

setClassDefinition

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

Specified by:

setClassDefinition in interface JobService

Throws:

SecurityException

RemoteException

setClassDefinition

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

Specified by:

setClassDefinition in interface JobService

Throws:

IllegalArgumentException

SecurityException

RemoteException

setIdleTime

public void setIdleTime(int idleSeconds)
                 throws IllegalArgumentException,
                        SecurityException,
                        RemoteException

Specified by:

setIdleTime in interface JobService

Throws:

IllegalArgumentException

SecurityException

RemoteException

setJobPriority

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

Specified by:

setJobPriority in interface JobService

Throws:

IllegalArgumentException

SecurityException

RemoteException

submitJob

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

Specified by:

submitJob in interface JobService

Throws:

IllegalArgumentException

SecurityException

ClassNotFoundException

RemoteException

JobExecutionException

submitJob

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

Specified by:

submitJob in interface JobService

Throws:

SecurityException

ClassNotFoundException

RemoteException

JobExecutionException

submitTaskResults

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

Specified by:

submitTaskResults in interface TaskService

Throws:

SecurityException

RemoteException

reportException

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

Specified by:

reportException in interface TaskService

Throws:

SecurityException

RemoteException

getFinishedTasks

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

Specified by:

getFinishedTasks in interface TaskService

Throws:

SecurityException

RemoteException

registerTaskService

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

Specified by:

registerTaskService in interface JobService

Throws:

SecurityException

RemoteException

unregisterTaskService

public void unregisterTaskService(String name)
                           throws IllegalArgumentException,
                                  SecurityException,
                                  RemoteException

Specified by:

unregisterTaskService in interface JobService

Throws:

IllegalArgumentException

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