org.jvnet.hk2.component
Interface InhabitantProviderInterceptor

All Known Implementing Classes:

AbstractInhabitantProvider, RunLevelInhabitantProvider

@Contract
public interface InhabitantProviderInterceptor

A hook for providers to implement in order to extend or redefine the inhabitant Hk2 will incorporate into the Habitat.

Author:

Jeff Trent

Method Summary

AbstractInhabitantImpl<?>

visit(AbstractInhabitantImpl<?> inhabitant, java.lang.String typeName, java.util.Set<java.lang.String> indicies, java.util.Iterator<InhabitantProviderInterceptor> remainingInterceptors, InhabitantStore store) Called by the framework to either decorate the inhabitant, or even intercept and replace the created inhabitant.

Method Detail

visit

AbstractInhabitantImpl<?> visit(AbstractInhabitantImpl<?> inhabitant,
                                java.lang.String typeName,
                                java.util.Set<java.lang.String> indicies,
                                java.util.Iterator<InhabitantProviderInterceptor> remainingInterceptors,
                                InhabitantStore store)

Called by the framework to either decorate the inhabitant, or even intercept and replace the created inhabitant.

Parameters:

inhabitant - the inhabitant offered by the framework, or the previous interceptor

typeName - the type name of the inhabitant

indicies - the indicies of the inhabitant

remainingInterceptors - the interceptors that follow. It is the responsibility of the implementation to continue the visitations for remaining interceptors unless there is some special conditions warranting an immediate short-circuiting.

store - the store that can be used for adding additional inhabitants

Returns:

the Inhabitant for the framework to add, or null if none should be added