Home | History | Annotate | Download | only in internal
      1 /*
      2  * Copyright (C) 2014 Google, Inc.
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  * http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 package dagger.internal;
     17 
     18 import javax.inject.Inject;
     19 import javax.inject.Provider;
     20 import javax.inject.Scope;
     21 
     22 /**
     23  * An {@linkplain Scope unscoped} {@link Provider}. While a {@link Provider} <i>may<i> apply
     24  * scoping semantics while providing an instance, a factory implementation is guaranteed to exercise
     25  * the binding logic ({@link Inject} constructors, {@link Provides} methods) upon each call to
     26  * {@link #get}.
     27  *
     28  * <p>Note that while subsequent calls to {@link #get} will create new instances for bindings such
     29  * as those created by {@link Inject} constructors, a new instance is not guaranteed by all
     30  * bindings. For example, {@link Provides} methods may be implemented in ways that return the same
     31  * instance for each call.
     32  *
     33  * @author Gregory Kick
     34  * @since 2.0
     35  */
     36 public interface Factory<T> extends Provider<T> {
     37 }
     38