com.google.gwt.user.client
Interface AsyncProxy<T>

Type Parameters:

T - the type of interface that must be implemented by the derivative class.

@AsyncProxy.DefaultValue
public interface AsyncProxy<T>

The AsyncProxy type is used to provide a reachability barrier between classes intended to be used with runAsync while maintaining a simple, deferred-synchronous API. The first invocation of an instance method on the AsyncProxy will trigger the instantiation of a concrete object via runAsync. All method invocations on the proxy will be recorded and played back on the newly-instantiated object after the call to runAsync returns.

Once method playback has finished, the proxy will continue to forward invocations onto the instantiated object.

Example use:

 interface IFoo {
   void doSomething(int a, int b);
   void anotherMethad(Object o);
 }
 class FooImpl implements IFoo { .... }
 
 @ConcreteType(FooImpl.class)
 interface FooProxy extends AsyncProxy<IFoo>, IFoo {}
 
 class UserOfIFoo {
   private IFoo foo = GWT.create(FooProxy.class);
   
   void makeTrouble() {
     // This first call triggers a runAsync load
     foo.doSomething(1, 2);
     
     // and this second will replayed after the call to doSomething()
     foo.anotherMethod("A string");
   }
 }
 

 class UserOfIFoo {
   private IFoo fooOrProxy = GWT.create(FooProxy.class);

   public UserOfIFoo() {
     // When the load, initialization, and playback are done, get rid of the proxy.
     ((AsyncProxy<IFoo>) fooOrProxy).setProxyCallback(new ProxyCallback<IFoo>() {
       public void onComplete(IFoo instance) {
         fooOrProxy = instance;
       }
     });
   }
   
   void makeTrouble() {
     // This first call triggers a runAsync load
     fooOrProxy.doSomething(1, 2);
     
     // and this second will also be replayed before the above onComplete is called
     fooOrProxy.anotherMethod("A string");
   }
 }
 

getProxiedInstance

T getProxiedInstance()

Returns the underlying proxied object if it has been instantiated or null.

setProxyCallback

void setProxyCallback(AsyncProxy.ProxyCallback<T> callback)

Sets a callback that can be used to influence the initialization process.