| /* |
| * 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: |
| * |
| * <pre style=code> |
| * public void get(final Callback<T, Throwable> callback) { |
| * GWT.runAsync(new RunAsyncCallback() { |
| * public void onSuccess() { |
| * callback.onSuccess(javax.inject.Provider<T>.get()); |
| * } |
| * public void onFailure(Throwable ex) { |
| * callback.onFailure(ex); |
| * } |
| * } |
| * } |
| * </pre> |
| * |
| * @param <T> the type of the provided value |
| * @param <F> the type returned on failure |
| */ |
| public interface AsyncProvider<T, F> { |
| |
| /** |
| * @param callback Callback used to pass the instance of T or an exception |
| * if there is an issue creating that instance. |
| */ |
| void get(Callback<? super T, ? super F> callback); |
| } |