org.cojen.dirmi

Interface Completion<V>

All Superinterfaces:

Future<V>

public interface Completion<V>
extends Future<V>

A Completion is a Future which also allows registration into a completion queue. By polling results from the completion queue (which can be blocking), multiple asynchronous methods can be tracked. The queue implementation must be thread-safe, and an ideal choice is LinkedBlockingQueue.

Author:

Brian S O'Neill

Method Summary

Modifier and Type	Method and Description
void	register(Queue<? super Completion<V>> completionQueue) Registers this future such that it enqueues itself into the given queue when done.

Methods inherited from interface java.util.concurrent.Future

cancel, get, get, isCancelled, isDone

Method Detail

register

void register(Queue<? super Completion<V>> completionQueue)

Registers this future such that it enqueues itself into the given queue when done. If future is already done by the time register is called, it is immediately enqueued.

Parameters:

completionQueue - thread-safe queue to receive finished asynchronous results

Throws:

IllegalArgumentException - if completion queue argument is null

IllegalStateException - if already registered with a completion queue