com.google.inject.spi
Class ProvisionListenerBinding

java.lang.Object
  com.google.inject.spi.ProvisionListenerBinding

All Implemented Interfaces:

Element

public final class ProvisionListenerBinding
extends Object
implements Element

Binds keys (picked using a Matcher) to a provision listener. Listeners are created explicitly in a module using Binder.bindListener(Matcher, ProvisionListener...) statements:

Since:

4.0

Author:

sameb@google.com (Sam Berlin)

Method Summary

<R> R	acceptVisitor(ElementVisitor<R> visitor) Accepts an element visitor.
void	applyTo(Binder binder) Writes this module element to the given binder (optional operation).
Matcher<? super Binding<?>>	getBindingMatcher() Returns the binding matcher which chooses which bindings the listener should be notified of.
List<ProvisionListener>	getListeners() Returns the registered listeners.
Object	getSource() Returns an arbitrary object containing information about the "place" where this element was configured.

Methods inherited from class java.lang.Object

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

Method Detail

getListeners

public List<ProvisionListener> getListeners()

Returns the registered listeners.

getBindingMatcher

public Matcher<? super Binding<?>> getBindingMatcher()

Returns the binding matcher which chooses which bindings the listener should be notified of.

getSource

public Object getSource()

Description copied from interface: Element

Returns an arbitrary object containing information about the "place" where this element was configured. Used by Guice in the production of descriptive error messages.

Tools might specially handle types they know about; StackTraceElement is a good example. Tools should simply call toString() on the source object if the type is unfamiliar.

Specified by:

getSource in interface Element

acceptVisitor

public <R> R acceptVisitor(ElementVisitor<R> visitor)

Description copied from interface: Element

Accepts an element visitor. Invokes the visitor method specific to this element's type.

Specified by:

acceptVisitor in interface Element

Parameters:

visitor - to call back on

applyTo

public void applyTo(Binder binder)

Description copied from interface: Element

Writes this module element to the given binder (optional operation).

Specified by:

applyTo in interface Element

Parameters:

binder - to apply configuration element to