org.cytoscape.jobs

Interface CyJobMonitor

public interface CyJobMonitor

Apps are expected to implement this interface to receive notifications about job completions. To be informed about the status of a particular job, CyJobMonitors should be registered as services so that jobs can be reassociated with their handlers on session restore. Note that classes should implement the loadData method. This method will be called by the CyJobManager when a job transitions to status of FINISHED and the user has indicated that they are ready to load the data. This will be done as part of a Task to avoid potential synchronization issues.

Module: jobs-api

To use this in your app, include the following dependency in your POM:

<dependency>
    <groupId>org.cytoscape</groupId>
    <artifactId>jobs-api</artifactId>
</dependency>

Cytoscape Backwards Compatibility (SPI Interface): We expect that this interface will be implemented. Therefore to maintain backwards compatibility this interface will only be modified for major version updates.

Method Summary

Modifier and Type	Method and Description
default void	jobStatusChanged(CyJob job, CyJobStatus status) This method is called whenever the status of a job changes.
void	loadData(CyJob job, TaskMonitor taskMonitor) This method is called when when the job status transitions to FINISHED and the user has indicated that they are ready to load the data from the task.

Method Detail

jobStatusChanged

default void jobStatusChanged(CyJob job,
                              CyJobStatus status)

This method is called whenever the status of a job changes.

Parameters:

job - the CyJob who's status has changed

status - the new job CyJobStatus

loadData

void loadData(CyJob job,
              TaskMonitor taskMonitor)

This method is called when when the job status transitions to FINISHED and the user has indicated that they are ready to load the data from the task. Typically, this will result in the fetchResults method being called, but if the data package is large, implementers might want to call fetchResults in a separate thread spawned from jobStatusChanged, then when the user indicates they are ready to process the data, the call to loadData can merge the resulting data into Cytoscape.

Parameters:

job - the finished CyJob to fetch the data for

taskMonitor - the TaskMonitor from the calling Task.