com.google.inject.internal

Class RealOptionalBinder<T>

java.lang.Object

com.google.inject.internal.RealOptionalBinder<T>

All Implemented Interfaces:

Module

public final class RealOptionalBinder<T>
extends java.lang.Object
implements Module

The actual OptionalBinder plays several roles. It implements Module to hide that fact from the public API, and installs the various bindings that are exposed to the user.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static interface	RealOptionalBinder.Actual
(package private) static class	RealOptionalBinder.ActualImpl
(package private) static class	RealOptionalBinder.BaseAnnotation
private static class	RealOptionalBinder.BindingSelection<T> A helper object that implements the core logic for deciding what the implementation of the binding will be.
(package private) static interface	RealOptionalBinder.Default
(package private) static class	RealOptionalBinder.DefaultImpl
private static class	RealOptionalBinder.JavaOptionalProvider Provides the binding for java.util.Optional.
private static class	RealOptionalBinder.JavaOptionalProviderProvider Provides the binding for java.util.Optional>.
private static class	RealOptionalBinder.RealDirectTypeProvider<T> Provides the binding for T, conditionally installed by calling setBinding/setDefault.
private static class	RealOptionalBinder.RealOptionalBinderProviderWithDependencies<T,P> A base class for ProviderWithDependencies that need equality based on a specific object.
private static class	RealOptionalBinder.RealOptionalKeyProvider<T> Provides the binding for Optional.
private static class	RealOptionalBinder.RealOptionalProviderProvider<T> Provides the binding for Optional>.
(package private) static class	RealOptionalBinder.Source

Field Summary

Fields

Modifier and Type	Field and Description
private Binder	binder
private RealOptionalBinder.BindingSelection<T>	bindingSelection
private static java.lang.Class<?>	JAVA_OPTIONAL_CLASS
private static java.lang.Object	JAVA_OPTIONAL_EMPTY
private static java.lang.reflect.Method	JAVA_OPTIONAL_OF_METHOD

Constructor Summary

Constructors

Modifier	Constructor and Description
private	RealOptionalBinder(Binder binder, Key<T> typeKey)

Method Summary

Modifier and Type	Method and Description
private void	addDirectTypeBinding(Binder binder) Adds a binding for T.
private void	bindJava8Optional(Binder binder)
void	configure(Binder binder) Contributes bindings and other configurations for this module to binder.
boolean	equals(java.lang.Object o)
(package private) Key<T>	getKeyForActualBinding() Returns the key to use for the actual binding, overrides the default if set.
(package private) Key<T>	getKeyForDefaultBinding() Returns the key to use for the default binding.
int	hashCode()
private static java.lang.Object	invokeJavaOptionalOf(java.lang.Object o) Invokes java.util.Optional.of.
private static java.lang.Object	invokeJavaOptionalOfNullable(java.lang.Object o) Returns java.util.Optional.empty() if the parameter is null, calls invokeJavaOptionalOf(java.lang.Object) otherwise.
(package private) static <T> TypeLiteral<?>	javaOptionalOf(TypeLiteral<T> type)
(package private) static <T> TypeLiteral<?>	javaOptionalOfJavaxProvider(TypeLiteral<T> type)
(package private) static <T> TypeLiteral<?>	javaOptionalOfProvider(TypeLiteral<T> type)
static <T> RealOptionalBinder<T>	newRealOptionalBinder(Binder binder, Key<T> type)
(package private) static <T> TypeLiteral<com.google.common.base.Optional<T>>	optionalOf(TypeLiteral<T> type)
(package private) static <T> TypeLiteral<com.google.common.base.Optional<javax.inject.Provider<T>>>	optionalOfJavaxProvider(TypeLiteral<T> type)
(package private) static <T> TypeLiteral<com.google.common.base.Optional<Provider<T>>>	optionalOfProvider(TypeLiteral<T> type)
(package private) static <T> Key<Provider<T>>	providerOf(Key<T> key)
LinkedBindingBuilder<T>	setBinding()
LinkedBindingBuilder<T>	setDefault()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

JAVA_OPTIONAL_CLASS

private static final java.lang.Class<?> JAVA_OPTIONAL_CLASS

JAVA_OPTIONAL_EMPTY

private static final java.lang.Object JAVA_OPTIONAL_EMPTY

JAVA_OPTIONAL_OF_METHOD

private static final java.lang.reflect.Method JAVA_OPTIONAL_OF_METHOD

bindingSelection

private final RealOptionalBinder.BindingSelection<T> bindingSelection

binder

private final Binder binder

Constructor Detail

RealOptionalBinder

private RealOptionalBinder(Binder binder,
                           Key<T> typeKey)

Method Detail

newRealOptionalBinder

public static <T> RealOptionalBinder<T> newRealOptionalBinder(Binder binder,
                                                              Key<T> type)

invokeJavaOptionalOfNullable

private static java.lang.Object invokeJavaOptionalOfNullable(java.lang.Object o)

Returns java.util.Optional.empty() if the parameter is null, calls invokeJavaOptionalOf(java.lang.Object) otherwise.

invokeJavaOptionalOf

private static java.lang.Object invokeJavaOptionalOf(java.lang.Object o)

Invokes java.util.Optional.of.

optionalOf

static <T> TypeLiteral<com.google.common.base.Optional<T>> optionalOf(TypeLiteral<T> type)

javaOptionalOf

static <T> TypeLiteral<?> javaOptionalOf(TypeLiteral<T> type)

optionalOfJavaxProvider

static <T> TypeLiteral<com.google.common.base.Optional<javax.inject.Provider<T>>> optionalOfJavaxProvider(TypeLiteral<T> type)

javaOptionalOfJavaxProvider

static <T> TypeLiteral<?> javaOptionalOfJavaxProvider(TypeLiteral<T> type)

optionalOfProvider

static <T> TypeLiteral<com.google.common.base.Optional<Provider<T>>> optionalOfProvider(TypeLiteral<T> type)

javaOptionalOfProvider

static <T> TypeLiteral<?> javaOptionalOfProvider(TypeLiteral<T> type)

providerOf

static <T> Key<Provider<T>> providerOf(Key<T> key)

addDirectTypeBinding

private void addDirectTypeBinding(Binder binder)

Adds a binding for T. Multiple calls to this are safe, and will be collapsed as duplicate bindings.

getKeyForDefaultBinding

Key<T> getKeyForDefaultBinding()

Returns the key to use for the default binding.

As a side effect this installs support for the 'direct type', so a binding for T will be made available.

setDefault

public LinkedBindingBuilder<T> setDefault()

getKeyForActualBinding

Key<T> getKeyForActualBinding()

Returns the key to use for the actual binding, overrides the default if set.

As a side effect this installs support for the 'direct type', so a binding for T will be made available.

setBinding

public LinkedBindingBuilder<T> setBinding()

configure

public void configure(Binder binder)

Description copied from interface: Module

Contributes bindings and other configurations for this module to binder.

Do not invoke this method directly to install submodules. Instead use Binder.install(Module), which ensures that provider methods are discovered.

Specified by:

configure in interface Module

bindJava8Optional

private void bindJava8Optional(Binder binder)

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object