uk.ac.starlink.ttools.cone

Class ConeMatcher.ConeWorker

java.lang.Object

uk.ac.starlink.ttools.cone.ConeMatcher.ConeWorker

All Implemented Interfaces:

Runnable, TableProducer

Enclosing class:

ConeMatcher

public static class ConeMatcher.ConeWorker
extends Object
implements Runnable, TableProducer

Object which produces the result table. It performs the individual cone searches and writes the results down a pipe from which it will be read asynchronously for output.

To use an instance of this class, it is necessary to call its run method in a separate thread. The getTable method may be called before the run method has completed (or even started), and will return a table whose rows may be streamed.

The run method checks for interruptions, so interrupting the thread in which it runs will cause it to stop consuming resources.

This code was originally written for J2SE1.4. There may be less baroque ways of achieving the same effect using the J2SE5 java.util.concurrent classes (BlockingQueue).

Method Summary

Modifier and Type	Method and Description
StarTable	getTable() Returns the result table.
void	run() Does the work of feeding the rows to the result table.

Methods inherited from class java.lang.Object

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

Method Detail

getTable

public StarTable getTable()
                   throws IOException

Returns the result table. It will block until run has at least started, but not necessarily until it has completed.

Specified by:

getTable in interface TableProducer

Returns:

result table

Throws:

IOException

run

public void run()

Does the work of feeding the rows to the result table. This method checks regularly for interruptions and will stop running if the thread is interrupted, causing a read error at the other end of the pipe.

Specified by:

run in interface Runnable