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