GuiceCompatibility

It looks like Guice, it walks like Guice, so it must be Guice?

Updated May 23, 2011 by aragos

Guice Compatibility

API

We have alternative types for:

Module, AbstractModule
Injector

For Module and AbtractModule, use GinModule and AbstractGinModule. They work much like their counterparts, but lack some of the features. Note that there is a 100% one-way conversion from GWT to Guice using GinModuleAdapter, so consider putting shared code in a GinModule. Other than that, you could also copy paste bindings from existing modules (usually they'll work), but of course copy-pasting should be discouraged.

For Injector, use the Ginjector conbined with the @GinModules annotation. See the GinTutorial to learn how you can get started and GinFaq for more helpful hints.

For everything else, use the Guice types. Note that we do not support everything Guice does (and we never will), so keep in mind when you are developing with GIN. See the feature comparison below for more information.

Features

Here we compare the current GIN trunk with Guice 1.0 and 2.0. The feature list is not complete, but should give you a rough idea about what works and what doesn't.

A = Available

N/A = Not Available (will probably never happen)

P = Planned (possible)

Configuration

Feature	Guice 1.0	Guice 2.0	Guice 3.0	GIN 1.0	GIN 1.5	GIN HEAD
Modules	A	A	A	A (`GinModule`)	A	A
Provider bindings	A	A	A	A	A	A
Provider methods	N/A	A	A	A	A	A
toInstance bindings	A	A	A	N/A	N/A	P (?)
Constant bindings	A	A	A	A	A	A
Binder.install	A	A	A	A	A	A
Binder.requestInjection	N/A	A	A	N/A	N/A	N/A
Binder.requestStaticInjection	A	A	A	A	A	A
Binder.getProvider	N/A	A	A	P	P	P
Binder.requireBinding	N/A	A	A	P	P	P
(Custom) binding annotations	A	A	A	A	A	A
`@Named`	A	A	A	A	A	A
Scopes	A	A	A	A	A	A
Custom Scopes	A	A	A	N/A	N/A	P (?)
`@Singleton class Blah{}`	A	A	A	A	A	A
`@ImplementedBy`	A	A	A	A	A	A
`@ProvidedBy`	A	A	A	A	A	A
`TypeLiteral`	A	A	A	A	A	A
Circular dependencies	A	A	A	N/A	N/A	A
Private modules	N/A	A	A	N/A	N/A	A
`@Optional` injection	N/A	A	A	A	A	A
Assisted Inject	A	A	A	N/A	A (`GinFactoryModuleBuilder`)	A
JSR330 Support	N/A	N/A	A	N/A	A	A
Binder.requireExplicitBindings	N/A	N/A	A	N/A	N/A	P
toConstructor bindings	N/A	N/A	A	N/A	N/A	P
Multi/Mapbinder	N/A	A	A	N/A	N/A	P
Custom injections	N/A	A	A	N/A	N/A	N/A
Throwing/checked provider	N/A	N/A	A	N/A	N/A	P (?)

Runtime

Feature	Guice 1.0	Guice 2.0	Guice 3.0	GIN 1.0	GIN 1.5	GIN HEAD
Constructor injection	A	A	A	A	A	A
Field injection	A	A	A	A	A	A
Method injection	A	A	A	A	A	A
Method interception (AOP)	A	A	A	N/A	N/A	P(?)
Injector.injectMembers	A	A	A	A	A	A
Injection of private members	A	A	A	A	A	A

Comment by thebrave...@gmail.com, Jul 25, 2009

When's the official release? EVERYONE wants to start using this ASAP

Comment by dob...@gmail.com, Jul 26, 2009

Why not support toInstance() by having the runtime code set the instances up after creating the Ginjector. For example:

class MyModule? extends AbstractGinModue? { configure() {

bind(Foo.class).toInstance("foo");

} }

interface MyGinjector? extends Ginjector {

@Instance("foo") public void setFoo(Foo foo); @Instance("bar") public void setBar(Bar bar);

}

class MyEntryPoint? implements EntryPoint? { onModuleCreate() { MyGinjector? injector = GWT.create(MyGinjector?); injector.setFooInstance(foo); injector.setBarInstance(bar); } }

You'd have to throw an error if an instance was not set before it was injected, but this approach seems quite straightforward to implement to me...

Comment by arthur.k...@gmail.com, Jul 27, 2009

@thebravedave

We've been using it off of trunk for many months now. It works great.

Comment by thebrave...@gmail.com, Jul 29, 2009

Just a note for those trying to compile the Gin.jar from the trunk. It DOES work, you just have to make sure everything is configured correctly. Im a newbie, and just managed it myself.

Comment by yadoo86, Feb 7, 2010

Sorry Guys... I don't get it... how singleton scope is supported it? Every time, user refreshes page, a new module is created. Right?

Comment by fabiokam...@gmail.com, Mar 6, 2010

i would like to see toInstance() implemented too.. :( besides that.. congrats for this big tool!

Comment by fabiokam...@gmail.com, Mar 6, 2010

just a thought.. are you planing to implement some way to inject UIBinder into the ui instead of what we are doing right now.. that is create the uibinder interface each time for each widget trough the GWT.create()??

some way to inject that?

Thanks

Comment by project member aragos, Mar 8, 2010

Note that you can easily replace toInstance bindings with an analogous provider method, i.e:

proteted configure() {
  bind(Foo.class).toInstance(new Foo());

becomes:

@Provides
@Singleton
Foo provideFoo() {
  return new Foo();
}

Comment by sne...@gmail.com, Mar 18, 2011

I'm assuming Custom Injections are not supported in Gin? http://code.google.com/p/google-guice/wiki/CustomInjections

Comment by andy.stevko, Mar 27, 2011

A note on Guice Compatibility - map class FactoryModuleBuilder? to GinFactoryModuleBuilder?

Comment by jamie.cr...@gmail.com, May 9, 2011

Is this representative of what's currently in GIN 1.5?

Comment by laze...@google.com, May 19, 2011

How about ThrowingProvider?? CheckedProvider??

► Sign in to add a comment