com.tavianator.sangria.contextual

Interface ContextSensitiveProvider<T>

public interface ContextSensitiveProvider<T>

Like a Provider, but with knowledge of the target InjectionPoint.

This interface, along with ContextSensitiveBinder, is useful for injecting custom logger types, among other things. However, context-sensitive injections can make maintenance and debugging more difficult.

Since:

1.0

Version:

1.0

Author:

Tavian Barnes (tavianator@tavianator.com)

Method Summary

Modifier and Type	Method and Description
T	getInContext(InjectionPoint injectionPoint) Provide an instance of T for the given context.
T	getInUnknownContext() Provide an instance of T for an unknown context.

Method Detail

getInContext

T getInContext(InjectionPoint injectionPoint)

Provide an instance of T for the given context.

Parameters:

injectionPoint - The InjectionPoint for this provision.

Returns:

An instance of T.

getInUnknownContext

T getInUnknownContext()

Provide an instance of T for an unknown context.

The InjectionPoint may not be known in all cases, for example if a Provider<T> is used instead of a bare T. This method will be called in those cases.

One reasonable implementation is to return a generically applicable instance, such as an anonymous logger. Another valid implementation is to throw an unchecked exception; in that case, Provider<T> injections will fail.

Returns:

An instance of T

Throws:

RuntimeException - If injection without a context is not supported.