org.apache.wicket.guice
Class GuiceComponentInjector

java.lang.Object
  org.apache.wicket.injection.Injector
      org.apache.wicket.injection.ConfigurableInjector
          org.apache.wicket.guice.GuiceComponentInjector

All Implemented Interfaces:

IComponentInstantiationListener

Direct Known Subclasses:

InjectionFlagCachingGuiceComponentInjector

public class GuiceComponentInjector
extends ConfigurableInjector
implements IComponentInstantiationListener

Injects fields/members of components using Guice.

Add this to your application in its Application.init() method like so:

 addComponentInstantiationListener(new GuiceComponentInjector(this));
 

There are different constructors for this object depending on how you want to wire things. See the javadoc for the constructors for more information.

Author:

Alastair Maw

Nested Class Summary

static class

GuiceComponentInjector.MoreThanOneBindingException

Constructor Summary

GuiceComponentInjector(Application app)
Creates a new Wicket GuiceComponentInjector instance.

GuiceComponentInjector(Application app, com.google.inject.Injector injector)
Creates a new Wicket GuiceComponentInjector instance, using the provided Guice Injector instance.

GuiceComponentInjector(Application app, com.google.inject.Module... modules)
Creates a new Wicket GuiceComponentInjector instance, using the supplied Guice Module instances to create a new Guice Injector instance internally.

Method Summary

static Annotation	findBindingAnnotation(Annotation[] annotations)
protected IFieldValueFactory	getFieldValueFactory() Return the field value factory that will be used to inject objects
Object	inject(Object object) Injects proxies using IFieldValueFactory obtained by calling getFieldValueFactory() method
void	onInstantiation(Component component) Called for every component that is instantiated.

Methods inherited from class org.apache.wicket.injection.Injector

getInstance, inject, isBoundaryClass

Methods inherited from class java.lang.Object

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

Constructor Detail

GuiceComponentInjector

public GuiceComponentInjector(Application app)

Creates a new Wicket GuiceComponentInjector instance.

Internally this will create a new Guice Injector instance, with no Module instances. This is only useful if your beans have appropriate ImplementedBy annotations on them so that they can be automatically picked up with no extra configuration code.

Parameters:

app -

GuiceComponentInjector

public GuiceComponentInjector(Application app,
                              com.google.inject.Module... modules)

Creates a new Wicket GuiceComponentInjector instance, using the supplied Guice Module instances to create a new Guice Injector instance internally.

Parameters:

app -

modules -

GuiceComponentInjector

public GuiceComponentInjector(Application app,
                              com.google.inject.Injector injector)

Creates a new Wicket GuiceComponentInjector instance, using the provided Guice Injector instance.

Parameters:

app -

injector -

Method Detail

inject

public Object inject(Object object)

Description copied from class: ConfigurableInjector

Injects proxies using IFieldValueFactory obtained by calling getFieldValueFactory() method

Overrides:

inject in class ConfigurableInjector

Parameters:

object - object to be injected

Returns:

Object that was injected - used for chaining

onInstantiation

public void onInstantiation(Component component)

Description copied from interface: IComponentInstantiationListener

Called for every component that is instantiated. This method is called during construction, so do not depend on the construction being completed yet. The id is guaranteed to be set before this call.

Specified by:

onInstantiation in interface IComponentInstantiationListener

Parameters:

component - the component that is being instantiated.

findBindingAnnotation

public static Annotation findBindingAnnotation(Annotation[] annotations)
                                        throws GuiceComponentInjector.MoreThanOneBindingException

Parameters:

annotations -

Returns:

Throws:

GuiceComponentInjector.MoreThanOneBindingException

getFieldValueFactory

protected IFieldValueFactory getFieldValueFactory()

Description copied from class: ConfigurableInjector

Return the field value factory that will be used to inject objects

Specified by:

getFieldValueFactory in class ConfigurableInjector

Returns:

field value locator factory that will be used to inject objects

See Also:

ConfigurableInjector.getFieldValueFactory()