Customizable scanning of bean implementations.
The SpaceModule
should be given a ClassSpace
representing the classes and resources to scan:
Guice.createInjector( new SpaceModule( new URLClassSpace( classloader ) ) );Reduce scanning time by using an
index
or provide your own ClassFinder
approach:
Guice.createInjector( new SpaceModule( new URLClassSpace( classloader ), BeanScanning.INDEX ) );
QualifiedTypeVisitor
with QualifiedTypeBinder
to find types annotated with @Named
or other @Qualifier
s and bind them as follows:
BeanLocator
uses to check type compatibility at lookup time:
(This avoids the need to walk the type hierarchy and register bindings for each and every super-type, turning the injector graph to spaghetti.)
@Named("example") public class MyTypeImpl implements MyType { // ... }If you use an empty
@Named
or a different @Qualifier
annotation then Sisu will pick a canonical name based on the implementation type.
Sometimes you need explicit typed bindings for external integration; you can list the types in a @Typed
annotation or leave it empty to use the declared interfaces:
@Named @Typed public class MyTypeImpl implements MyType { // ... }Default implementations can be indicated by using "default" as a binding name:
@Named("default") public class MyTypeImpl implements MyType { // ... }or by starting the implementation name with "Default":
@Named public class DefaultMyType implements MyType { // ... }Default components are bound without a qualifier and have a higher ranking than non-default components.
@Named public class MyProvider implements Provider<MyType> { public MyType get() { // ... } }Use
@Singleton
to scope the provided binding(s) as a singleton:
@Named @Singleton public class MyProvider implements Provider<MyType> { public MyType get() { // ... } }Note: this is different to the normal Guice behaviour where singleton only applies to the provider itself.
@Named public class MyModule extends AbstractModule { @Override protected void configure() { // ... } }
Mediator
s are registered with the BeanLocator
:
@Named public class MyMediator implements Mediator<Named, MyType, MyWatcher> { public void add( BeanEntry<Named, MyType> entry, MyWatcher watcher ) throws Exception { // ... } public void remove( BeanEntry<Named, MyType> entry, MyWatcher watcher ) throws Exception { // ... } }