com.googlecode.objectify.cache

Class PendingFutures

java.lang.Object

com.googlecode.objectify.cache.PendingFutures

public class PendingFutures
extends Object

This bit of appengine magic hooks into the ApiProxy and does the heavy lifting of making the TriggerFuture work.

This class maintains a thread local list of all the outstanding Future objects that have pending triggers. When a Future is done and its trigger is executed, it is removed from the list. At various times (anytime an API call is made) the registered futures are checked for doneness and processed.

The AsyncCacheFilter is necessary to guarantee that any pending triggers are processed at the end of the request. A future GAE SDK which allows us to hook into the Future creation process might make this extra Filter unnecessary.

Author:

Jeff Schnitzer

Constructor Summary

Constructors

Constructor and Description
PendingFutures()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addPending(Future<?> future) Register a pending Future that has a callback.
static void	completeAllPendingFutures() Iterate through all pending futures and get() them, forcing any callbacks to be called.
static void	removePending(Future<?> future) Deregister a pending Future that had a callback.

Methods inherited from class java.lang.Object

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

Constructor Detail

PendingFutures

public PendingFutures()

Method Detail

addPending

public static void addPending(Future<?> future)

Register a pending Future that has a callback.

Parameters:

future - must have at least one callback

removePending

public static void removePending(Future<?> future)

Deregister a pending Future that had a callback.

completeAllPendingFutures

public static void completeAllPendingFutures()

Iterate through all pending futures and get() them, forcing any callbacks to be called. This is used only by the AsyncCacheFilter because we don't have a proper hook otherwise.