Package org.incendo.cloud.injection

Class ParameterInjectorRegistry<C>

java.lang.Object

org.incendo.cloud.injection.ParameterInjectorRegistry<C>

Type Parameters:

C - command sender type

All Implemented Interfaces:

Function<InjectionRequest<C>,Object>, InjectionService<C>, Service<InjectionRequest<C>,Object>

@API(status=STABLE)
public final class ParameterInjectorRegistry<C>
extends Object
implements InjectionService<C>

Registry containing mappings between Class Predicates and injectors. The order injectors are tested is the same order they were registered in.

Constructor Summary

Constructors

Constructor	Description
ParameterInjectorRegistry()	Creates a new parameter injector registry

Method Summary

Modifier and Type	Method	Description
<T> @NonNull Optional<T>	getInjectable(@NonNull TypeToken<T> type, @NonNull CommandContext<C> context, @NonNull AnnotationAccessor annotationAccessor)	Attempts to get an injectable value for the given context.
<T> @NonNull Optional<T>	getInjectable(@NonNull Class<T> clazz, @NonNull CommandContext<C> context, @NonNull AnnotationAccessor annotationAccessor)	Attempts to get an injectable value for the given context.
@Nullable Object	handle(@NonNull InjectionRequest<C> request)
@NonNull ParameterInjectorRegistry<C>	registerInjectionService(InjectionService<C> service)	Registers an injection service that will be able to provide injections using getInjectable(Class, CommandContext, AnnotationAccessor).
<T> @NonNull ParameterInjectorRegistry<C>	registerInjector(@NonNull TypeToken<T> type, @NonNull ParameterInjector<C,T> injector)	Registers an injector for a particular type or any of it's assignable supertypes.
<T> @NonNull ParameterInjectorRegistry<C>	registerInjector(@NonNull Class<T> clazz, @NonNull ParameterInjector<C,T> injector)	Registers an injector for a particular type or any of it's assignable supertypes.
<T> @NonNull ParameterInjectorRegistry<C>	registerInjector(@NonNull Predicate<TypeToken<?>> predicate, @NonNull ParameterInjector<C,T> injector)	Registers an injector for a particular type predicate.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.function.Function

andThen, compose

Methods inherited from interface org.incendo.cloud.services.type.Service

apply, order

Constructor Details

ParameterInjectorRegistry

public ParameterInjectorRegistry()

Creates a new parameter injector registry

Method Details

registerInjector

public <T> @NonNull ParameterInjectorRegistry<C> registerInjector(@NonNull Class<T> clazz,
 @NonNull ParameterInjector<C,T> injector)

Registers an injector for a particular type or any of it's assignable supertypes.

Type Parameters:

T - injected type

Parameters:

clazz - type that the injector should inject for

injector - the injector that should inject the value into the command method

Returns:

this

registerInjector

@API(status=STABLE)
public <T> @NonNull ParameterInjectorRegistry<C> registerInjector(@NonNull TypeToken<T> type,
 @NonNull ParameterInjector<C,T> injector)

Registers an injector for a particular type or any of it's assignable supertypes.

Type Parameters:

T - injected type

Parameters:

type - type that the injector should inject for

injector - the injector that should inject the value into the command method

Returns:

this

registerInjector

@API(status=STABLE)
public <T> @NonNull ParameterInjectorRegistry<C> registerInjector(@NonNull Predicate<TypeToken<?>> predicate,
 @NonNull ParameterInjector<C,T> injector)

Registers an injector for a particular type predicate.

The predicate should only return true if the injected type is assignable to the tested type. This predicate overload is provided in addition to registerInjector(Class, ParameterInjector) to allow for exact, non-exact, or custom predicates, however is still bound by the aforementioned constraint. Failure to adhere to this will result in runtime exceptions.

Type Parameters:

T - injected type

Parameters:

predicate - a predicate that matches if the injector should be used for a type

injector - the injector that should inject the value into the command method

Returns:

this

handle

public @Nullable Object handle(@NonNull InjectionRequest<C> request)

Specified by:

handle in interface Service<InjectionRequest<C>,Object>

getInjectable

@API(status=STABLE)
public <T> @NonNull Optional<T> getInjectable(@NonNull Class<T> clazz,
 @NonNull CommandContext<C> context,
 @NonNull AnnotationAccessor annotationAccessor)

Attempts to get an injectable value for the given context.

This will consider all registered injection services, and not just the injectors registered using registerInjector(Class, ParameterInjector).

Type Parameters:

T - type to inject

Parameters:

clazz - class to inject

context - the command context that requests the injection

annotationAccessor - annotation accessor for the injection. If the object is requested without access to annotations, use AnnotationAccessor.empty()

Returns:

the injected value, if an injector was able to provide a value

getInjectable

@API(status=STABLE)
public <T> @NonNull Optional<T> getInjectable(@NonNull TypeToken<T> type,
 @NonNull CommandContext<C> context,
 @NonNull AnnotationAccessor annotationAccessor)

Attempts to get an injectable value for the given context.

This will consider all registered injection services, and not just the injectors registered using registerInjector(Class, ParameterInjector).

Type Parameters:

T - type to inject

Parameters:

type - type to inject

context - the command context that requests the injection

annotationAccessor - annotation accessor for the injection. If the object is requested without access to annotations, use AnnotationAccessor.empty()

Returns:

the injected value, if an injector was able to provide a value

Throws:

InjectionException - if any of the injection services throws an exception

registerInjectionService

@API(status=STABLE)
public @NonNull ParameterInjectorRegistry<C> registerInjectionService(InjectionService<C> service)

Registers an injection service that will be able to provide injections using getInjectable(Class, CommandContext, AnnotationAccessor).

Parameters:

service - Service implementation

Returns:

this