org.apache.wicket.guice

Class GuiceComponentInjector

java.lang.Object

org.apache.wicket.injection.Injector

org.apache.wicket.guice.GuiceComponentInjector

All Implemented Interfaces:

IComponentInstantiationListener, IBehaviorInstantiationListener

public class GuiceComponentInjector
extends Injector
implements IComponentInstantiationListener, IBehaviorInstantiationListener

Injects field members of components and behaviors using Guice.

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

 getComponentInstantiationListeners().add(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.

Only Wicket Components and Behaviors are automatically injected, other classes such as Session, Model, and any other POJO can be injected by calling Injector.get().inject(this) in their constructor.

Author:

Alastair Maw

Constructor Summary

Constructors

Constructor and Description
GuiceComponentInjector(Application app) Creates a new Wicket GuiceComponentInjector instance.
GuiceComponentInjector(Application app, com.google.inject.Injector injector) Constructor
GuiceComponentInjector(Application app, com.google.inject.Injector injector, boolean wrapInProxies) 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

Modifier and Type	Method and Description
void	inject(Object object) Injects the specified object.
void	onInstantiation(Behavior behavior) Called when a behavior instance is created
void	onInstantiation(Component component) Called for every component that is instantiated.

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

bind, get, inject

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)

Constructor

Parameters:

app -

injector -

GuiceComponentInjector

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

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

Parameters:

app -

injector -

wrapInProxies - whether or not wicket should wrap dependencies with specialized proxies that can be safely serialized. in most cases this should be set to true.

Method Detail

inject

public void inject(Object object)

Description copied from class: Injector

Injects the specified object. This method is usually implemented by delegating to Injector.inject(Object, IFieldValueFactory) with some IFieldValueFactory

Specified by:

inject in class Injector

See Also:

Injector.inject(Object, IFieldValueFactory)

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.

onInstantiation

public void onInstantiation(Behavior behavior)

Description copied from interface: IBehaviorInstantiationListener

Called when a behavior instance is created

Specified by:

onInstantiation in interface IBehaviorInstantiationListener