com.google.gwt.core.client.AsyncProvider Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of gwt-servlet Show documentation

The newest version!

/*
 * Copyright 2011 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */

package com.google.gwt.core.client;

/**
 * An object capable of providing an instance of type T asynchronously
 * via {@link Callback}. For example, the instance might be
 * created within a GWT.runAsync block using the following template:
 *
 *   *      public void get(final Callback callback) {
 *        GWT.runAsync(new RunAsyncCallback() {
 *          public void onSuccess() {
 *            callback.onSuccess(javax.inject.Provider.get());
 *          }
 *          public void onFailure(Throwable ex) {
 *            callback.onFailure(ex);
 *          }
 *        }
 *      }
 *  
 *
 * @param  the type of the provided value
 * @param  the type returned on failure
 */
public interface AsyncProvider {

  /**
   * @param callback Callback used to pass the instance of T or an exception
   *    if there is an issue creating that instance.
   */
  void get(Callback callback);
}