Class ProvisionListener.ProvisionInvocation<T>

    • Constructor Detail

      • ProvisionInvocation

        public ProvisionInvocation()
    • Method Detail

      • getBinding

        public abstract Binding<T> getBinding()
        Returns the Binding this is provisioning.

        You must not call Provider.get() on the provider returned by Binding.getProvider(), otherwise you will get confusing error messages.

      • provision

        public abstract T provision()
        Performs the provision, returning the object provisioned.
      • getDependencyChain

        @Deprecated
        public abstract java.util.List<DependencyAndSource> getDependencyChain()
        Deprecated.
        This method is planned for removal in Guice 4.4. Some use cases can be replaced by inferring the current chain via ThreadLocals in the listener, other use cases can use the static dependency graph. For example,
        
           bindListener(Matchers.any(), new MyListener());
           ...
        
           private static final class MyListener implements ProvisionListener {
             private final ThreadLocal<ArrayDeque<Binding<?>>> bindingStack =
                 new ThreadLocal<ArrayDeque<Binding<?>>>() {
                   {@literal @}Override protected ArrayDeque<Binding<?>> initialValue() {
                     return new ArrayDeque<>();
                   }
                 };
             {@literal @}Override public <T> void onProvision(ProvisionInvocation<T> invocation) {
               bindingStack.get().push(invocation.getBinding());
               try {
                 invocation.provision();
               } finally {
                 bindingStack.get().pop();
               }
               // Inspect the binding stack...
             }
           }
        
         
        
         In this example the bindingStack thread local will contain a data structure that is very
         similar to the data returned by this list.  The main differences are that linked keys are
         not in the stack, but such edges do exist in the static dependency graph (inspectable via
         HasDependencies.getDependencies()), so you could infer some of the missing edges..
        Returns the dependency chain that led to this object being provisioned.