dagger.model.Binding Maven / Gradle / Ivy
Show all versions of dagger-spi Show documentation
/*
* Copyright (C) 2017 The Dagger Authors.
*
* 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 dagger.model;
import com.google.common.collect.ImmutableSet;
import dagger.model.BindingGraph.MaybeBinding;
import java.util.Optional;
import javax.lang.model.element.Element;
import javax.lang.model.element.TypeElement;
/**
* The association between a {@link Key} and the way in which instances of the key are provided.
* Includes any {@linkplain DependencyRequest dependencies} that are needed in order to provide the
* instances.
*
* If a binding is owned by more than one component, there is one {@code Binding} for every
* owning component.
*/
public interface Binding extends MaybeBinding {
@Override
ComponentPath componentPath();
/** @deprecated This always returns {@code Optional.of(this)}. */
@Override
@Deprecated
default Optional binding() {
return Optional.of(this);
}
/**
* The dependencies of this binding. The order of the dependencies corresponds to the order in
* which they will be injected when the binding is requested.
*/
ImmutableSet dependencies();
/**
* The {@link Element} that declares this binding. Absent for {@linkplain BindingKind binding
* kinds} that are not always declared by exactly one element.
*
* For example, consider {@link BindingKind#MULTIBOUND_SET}. A component with many
* {@code @IntoSet} bindings for the same key will have a synthetic binding that depends on all
* contributions, but with no identifiying binding element. A {@code @Multibinds} method will also
* contribute a synthetic binding, but since multiple {@code @Multibinds} methods can coexist in
* the same component (and contribute to one single binding), it has no binding element.
*/
Optional bindingElement();
/**
* The {@link TypeElement} of the module which contributes this binding. Absent for bindings that
* have no {@link #bindingElement() binding element}.
*/
Optional contributingModule();
/**
* Returns {@code true} if using this binding requires an instance of the {@link
* #contributingModule()}.
*/
boolean requiresModuleInstance();
/** The scope of this binding if it has one. */
Optional scope();
/**
* Returns {@code true} if this binding may provide {@code null} instead of an instance of {@link
* #key()}. Nullable bindings cannot be requested from {@linkplain DependencyRequest#isNullable()
* non-nullable dependency requests}.
*/
boolean isNullable();
/** Returns {@code true} if this is a production binding, e.g. an {@code @Produces} method. */
boolean isProduction();
/** The kind of binding this instance represents. */
BindingKind kind();
}