net.bolbat.kit.ioc

Class Manager

java.lang.Object

net.bolbat.kit.ioc.Manager

All Implemented Interfaces:

Module

@Stability.Stable
public final class Manager
extends Object
implements Module

Module for managing services configuration.

Author:

Alexandr Bolbat

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Manager.Feature Configurable features.
static class	Manager.Features Manager default module features configuration.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_MODULE Default module name.
static Scope	DEFAULT_SCOPE Default scope.

Method Summary

Modifier and Type	Method and Description
static ManagerModule	defaultModule() Get default module instance.
static <S extends Service> S	get(Class<S> service, Scope... scopes) Get default module service. Uses ScopeUtil.scopesToArray(true,scopes) upon resolving.
static <S extends Service> S	getFast(Class<S> service, Scope... scopes) Get default module service. Logic the same as for get method but with ManagerRuntimeException instead of ManagerException.
static <S extends Service> boolean	isRegistered(Class<S> service, Scope... scopes) Is service registered, doesn't initiate warmUp.
static <S extends Service> void	link(Class<S> service, Scope target) Make default module link between default and target scope.
static <S extends Service> void	link(Class<S> service, Scope source, Scope target) Make default module link between scopes.
static ManagerModule	module(String name) Get module instance.
static <S extends Service,SF extends ServiceFactory<S>> void	register(Class<S> service, Class<SF> factory) Register default module service.
static <S extends Service,SF extends ServiceFactory<S>> void	register(Class<S> service, Class<SF> factory, Configuration conf) Register default module service.
static <S extends Service,SF extends ServiceFactory<S>> void	register(Class<S> service, Class<SF> factory, Configuration conf, Scope... scopes) Register default module service.
static <S extends Service,SF extends ServiceFactory<S>> void	register(Class<S> service, Class<SF> factory, Scope... scopes) Register default module service.
static <S extends Service> void	register(Class<S> service, S instance) Register default module service. PostConstruct will be ignored. PreDestroy will be executed during tearDown.
static <S extends Service,SF extends ServiceFactory<S>> void	register(Class<S> service, SF factory) Register default module service.
static <S extends Service,SF extends ServiceFactory<S>> void	register(Class<S> service, SF factory, Configuration conf) Register default module service.
static <S extends Service,SF extends ServiceFactory<S>> void	register(Class<S> service, SF factory, Configuration conf, Scope... scopes) Register default module service. Uses ScopeUtil.scopesToArray(true,scopes) upon registration.
static <S extends Service,SF extends ServiceFactory<S>> void	register(Class<S> service, SF factory, Scope... scopes) Register default module service. Uses ScopeUtil.scopesToArray(true,scopes) upon registration.
static <S extends Service> void	register(Class<S> service, S instance, Scope... scopes) Register default module service. Uses ScopeUtil.scopesToArray(true,scopes) upon registration. PostConstruct will be ignored. PreDestroy will be executed during tearDown.
static void	tearDown() Tear down Manager default module state. For registered and instantiated services 'pre-destroy' will be processed.
static <S extends Service> void	tearDown(Class<S> service) Tear down Manager default module state for given service. For registered and instantiated services 'pre-destroy' will be processed.
static void	warmUp() Warm up Manager default module state. For registered and not instantiated services 'post-construct' will be processed.
static <S extends Service> void	warmUp(Class<S> service) Warm up Manager default module state for given service. For registered and not instantiated services 'post-construct' will be processed.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_SCOPE

public static final Scope DEFAULT_SCOPE

Default scope.

DEFAULT_MODULE

public static final String DEFAULT_MODULE

Default module name.

See Also:

Constant Field Values

Method Detail

defaultModule

public static ManagerModule defaultModule()

Get default module instance.

Returns:

ManagerModule

module

public static ManagerModule module(String name)

Get module instance.

Parameters:

name - module name

Returns:

ManagerModule

link

public static <S extends Service> void link(Class<S> service,
                                            Scope target)

Make default module link between default and target scope.

Parameters:

service - service

target - target scope, can be CompositeScope

link

public static <S extends Service> void link(Class<S> service,
                                            Scope source,
                                            Scope target)

Make default module link between scopes.

Parameters:

service - service

source - source scope, can be CompositeScope

target - target scope, can be CompositeScope

register

public static <S extends Service,SF extends ServiceFactory<S>> void register(Class<S> service,
                                                                             Class<SF> factory)

Register default module service.

Parameters:

service - service interface

factory - service factory

register

public static <S extends Service,SF extends ServiceFactory<S>> void register(Class<S> service,
                                                                             Class<SF> factory,
                                                                             Scope... scopes)

Register default module service.

Parameters:

service - service interface

factory - service factory

scopes - service scopes, default scopes will be selected if no one given

register

public static <S extends Service,SF extends ServiceFactory<S>> void register(Class<S> service,
                                                                             Class<SF> factory,
                                                                             Configuration conf)

Register default module service.

Parameters:

service - service interface

factory - service factory

conf - service factory configuration, can be null

register

public static <S extends Service,SF extends ServiceFactory<S>> void register(Class<S> service,
                                                                             Class<SF> factory,
                                                                             Configuration conf,
                                                                             Scope... scopes)

Register default module service.

Parameters:

service - service interface

factory - service factory

conf - service factory configuration, can be null

scopes - service scopes, default scopes will be selected if no one given

register

public static <S extends Service,SF extends ServiceFactory<S>> void register(Class<S> service,
                                                                             SF factory)

Register default module service.

Parameters:

service - service interface

factory - service factory instance

register

public static <S extends Service,SF extends ServiceFactory<S>> void register(Class<S> service,
                                                                             SF factory,
                                                                             Scope... scopes)

Register default module service.
Uses ScopeUtil.scopesToArray(true,scopes) upon registration.

Parameters:

service - service interface

factory - service factory instance

scopes - service scopes, default scopes will be selected if no one given

register

public static <S extends Service,SF extends ServiceFactory<S>> void register(Class<S> service,
                                                                             SF factory,
                                                                             Configuration conf)

Register default module service.

Parameters:

service - service interface

factory - service factory instance

conf - service factory configuration, can be null

register

public static <S extends Service,SF extends ServiceFactory<S>> void register(Class<S> service,
                                                                             SF factory,
                                                                             Configuration conf,
                                                                             Scope... scopes)

Register default module service.
Uses ScopeUtil.scopesToArray(true,scopes) upon registration.

Parameters:

service - service interface

factory - service factory instance

conf - service factory configuration, can be null

scopes - service scopes, default scopes will be selected if no one given

register

public static <S extends Service> void register(Class<S> service,
                                                S instance)

Register default module service.
PostConstruct will be ignored.
PreDestroy will be executed during tearDown.

Parameters:

service - service interface

instance - service instance

register

public static <S extends Service> void register(Class<S> service,
                                                S instance,
                                                Scope... scopes)

Register default module service.
Uses ScopeUtil.scopesToArray(true,scopes) upon registration.
PostConstruct will be ignored.
PreDestroy will be executed during tearDown.

Parameters:

service - service interface

instance - service instance

scopes - service scopes, default scopes will be selected if no one given

getFast

public static <S extends Service> S getFast(Class<S> service,
                                            Scope... scopes)

Get default module service.
Logic the same as for get method but with ManagerRuntimeException instead of ManagerException.

Parameters:

service - service interface

scopes - service scopes, default scopes will be selected if no one given

Returns:

service instance

get

public static <S extends Service> S get(Class<S> service,
                                        Scope... scopes)
                                 throws ManagerException

Get default module service.
Uses ScopeUtil.scopesToArray(true,scopes) upon resolving.

Parameters:

service - service interface

scopes - service scopes, default scopes will be selected if no one given

Returns:

service instance

Throws:

ManagerException

isRegistered

public static <S extends Service> boolean isRegistered(Class<S> service,
                                                       Scope... scopes)

Is service registered, doesn't initiate warmUp.

Parameters:

service - service interface

scopes - service scopes, default scopes will be selected if no one given

Returns:

true if configured, or false

warmUp

public static void warmUp()

Warm up Manager default module state.
For registered and not instantiated services 'post-construct' will be processed.

warmUp

public static <S extends Service> void warmUp(Class<S> service)

Warm up Manager default module state for given service.
For registered and not instantiated services 'post-construct' will be processed.

Parameters:

service - service interface

tearDown

public static void tearDown()

Tear down Manager default module state.
For registered and instantiated services 'pre-destroy' will be processed.

tearDown

public static <S extends Service> void tearDown(Class<S> service)

Tear down Manager default module state for given service.
For registered and instantiated services 'pre-destroy' will be processed.

Parameters:

service - service interface