net.e6tech.elements.common.resources

Class Resources

java.lang.Object

net.e6tech.elements.common.resources.Resources

All Implemented Interfaces:

java.lang.AutoCloseable, ResourcePool

public class Resources
extends java.lang.Object
implements java.lang.AutoCloseable, ResourcePool

A Resources instance is use to manage resource level injection and resources. Rules for injection. Only annotate injection for instances that are configured during program start up. During runtime, it is better to store resources via put. This prevents a overly complicated dependency wiring. For dynamically created instances, really the only needed injected resource is the Resources instance and resources provided by ResourceProviders. Created by futeh.

Field Summary

Fields

Modifier and Type	Field and Description
protected Configurator	configurator
protected net.e6tech.elements.common.resources.ResourcesState	state

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Resources()

Method Summary

Modifier and Type	Method and Description
void	abort()
void	addModule(InjectionModule module)
void	addResourceProvider(ResourceProvider resourceProvider)
void	afterCommit(AfterCommit afterCommit)
void	afterCommit(java.lang.Runnable runnable)
<T> T	bind(java.lang.Class<T> cls, T resource)
void	bindClass(java.lang.Class cls, java.lang.Class service) This method is mostly used for unit testing.
<T> T	bindNamedInstance(java.lang.String name, java.lang.Class<T> cls, T resource)
void	close()
<R> R	commit()
Configurator	configurator()
void	configure(Configurator configurator)
<T> Binding<T>	getBinding(java.lang.Class<T> cls)
<T> T	getBoundNamedInstance(java.lang.String name)
<T> T	getInstance(java.lang.Class<T> cls)
<T> T	getInstance(java.lang.Class<T> cls, java.util.function.Supplier<T> call)
InjectionModule	getModule()
<R,S,T extends Plugin> T	getPlugin(java.lang.Class<R> c1, java.lang.String n1, java.lang.Class<S> c2, java.lang.String n2, java.lang.Class<T> c3, java.lang.Object... args)
<S,T extends Plugin> T	getPlugin(java.lang.Class<S> c1, java.lang.String n1, java.lang.Class<T> c2, java.lang.Object... args) Plugins are identified by class, a name and then a particular plugin class.
<T extends Plugin> T	getPlugin(PluginPath<T> path, java.lang.Object... args)
ResourceManager	getResourceManager()
<T> T	getVariable(java.lang.String variable)
boolean	hasInstance(java.lang.Class cls)
<T> T	inject(T object)
boolean	isAborted()
<T> boolean	isBound(java.lang.Class<T> cls)
boolean	isClosed()
boolean	isCommitted()
boolean	isDiscarded()
boolean	isOpened()
void	onAbort(OnAbort onAbort)
void	onAbort(java.lang.Runnable runnable)
void	onClosed(OnClosed onClosed)
void	onClosed(java.lang.Runnable runnable)
void	onCommit(OnCommit onCommit)
void	onCommit(java.lang.Runnable runnable)
void	onOpen()
void	onOpen(OnOpen onOpen)
void	onOpen(java.lang.Runnable runnable)
<T extends Provision> T	provision()
<T> T	rebind(java.lang.Class<T> cls, T resource)
<T> T	rebindNamedInstance(java.lang.String name, java.lang.Class<T> cls, T resource)
boolean	remove(ResourceProvider provider)
protected <Res extends Resources,R> R	replay(java.lang.Throwable th, net.e6tech.elements.common.resources.Resources.Replay<Res,R> replay)
<Res extends Resources> void	submit(Transactional.ConsumerWithException<Res> work)
<Res extends Resources,R> R	submit(Transactional.FunctionWithException<Res,R> work)
<T> T	tryBind(java.lang.Class<T> cls, java.util.concurrent.Callable<T> callable)
<T> T	unbind(java.lang.Class<T> cls)

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.e6tech.elements.common.resources.ResourcePool

findById, getBean, getBean, getNotificationCenter, mapById, newInstance

Field Detail

state

protected net.e6tech.elements.common.resources.ResourcesState state

configurator

protected Configurator configurator

Constructor Detail

Resources

protected Resources()

Method Detail

isCommitted

public boolean isCommitted()

isOpened

public boolean isOpened()

isAborted

public boolean isAborted()

isClosed

public boolean isClosed()

isDiscarded

public boolean isDiscarded()

addResourceProvider

public void addResourceProvider(ResourceProvider resourceProvider)

onCommit

public void onCommit(OnCommit onCommit)

onCommit

public void onCommit(java.lang.Runnable runnable)

afterCommit

public void afterCommit(AfterCommit afterCommit)

afterCommit

public void afterCommit(java.lang.Runnable runnable)

onOpen

public void onOpen(OnOpen onOpen)

onOpen

public void onOpen(java.lang.Runnable runnable)

onAbort

public void onAbort(OnAbort onAbort)

onAbort

public void onAbort(java.lang.Runnable runnable)

onClosed

public void onClosed(OnClosed onClosed)

onClosed

public void onClosed(java.lang.Runnable runnable)

remove

public boolean remove(ResourceProvider provider)

getResourceManager

public ResourceManager getResourceManager()

Specified by:

getResourceManager in interface ResourcePool

getPlugin

public <S,T extends Plugin> T getPlugin(java.lang.Class<S> c1,
                                        java.lang.String n1,
                                        java.lang.Class<T> c2,
                                        java.lang.Object... args)

Plugins are identified by class, a name and then a particular plugin class. The argument are injected into the plugin. For example, let say there is a class called Partner and it may be associated with several plugin types. Furthermore, the plugins associated with a Partner may vary based on the partner. To create the plugin, one may search based on Partner.class, partner name, plugin class and a list of arguments to be injected into the plugin.

Type Parameters:

T -

Parameters:

c1 -

n1 -

c2 -

args -

Returns:

getPlugin

public <R,S,T extends Plugin> T getPlugin(java.lang.Class<R> c1,
                                          java.lang.String n1,
                                          java.lang.Class<S> c2,
                                          java.lang.String n2,
                                          java.lang.Class<T> c3,
                                          java.lang.Object... args)

getPlugin

public <T extends Plugin> T getPlugin(PluginPath<T> path,
                                      java.lang.Object... args)

getVariable

public <T> T getVariable(java.lang.String variable)

getModule

public InjectionModule getModule()

addModule

public void addModule(InjectionModule module)

getBinding

public <T> Binding<T> getBinding(java.lang.Class<T> cls)

tryBind

public <T> T tryBind(java.lang.Class<T> cls,
                     java.util.concurrent.Callable<T> callable)

isBound

public <T> boolean isBound(java.lang.Class<T> cls)

bind

public <T> T bind(java.lang.Class<T> cls,
                  T resource)

Specified by:

bind in interface ResourcePool

rebind

public <T> T rebind(java.lang.Class<T> cls,
                    T resource)

Specified by:

rebind in interface ResourcePool

unbind

public <T> T unbind(java.lang.Class<T> cls)

Specified by:

unbind in interface ResourcePool

bindClass

public void bindClass(java.lang.Class cls,
                      java.lang.Class service)

This method is mostly used for unit testing. the bound class disappear once resources is closed. Unless you know what you are doing, please don't use.

Specified by:

bindClass in interface ResourcePool

Parameters:

cls - Class to bind to

service - service class

bindNamedInstance

public <T> T bindNamedInstance(java.lang.String name,
                               java.lang.Class<T> cls,
                               T resource)

Specified by:

bindNamedInstance in interface ResourcePool

rebindNamedInstance

public <T> T rebindNamedInstance(java.lang.String name,
                                 java.lang.Class<T> cls,
                                 T resource)

Specified by:

rebindNamedInstance in interface ResourcePool

getBoundNamedInstance

public <T> T getBoundNamedInstance(java.lang.String name)

inject

public <T> T inject(T object)

Specified by:

inject in interface ResourcePool

hasInstance

public boolean hasInstance(java.lang.Class cls)

getInstance

public <T> T getInstance(java.lang.Class<T> cls)
                  throws InstanceNotFoundException

Throws:

InstanceNotFoundException

getInstance

public <T> T getInstance(java.lang.Class<T> cls,
                         java.util.function.Supplier<T> call)

configurator

public Configurator configurator()

configure

public void configure(Configurator configurator)

onOpen

public void onOpen()

replay

protected <Res extends Resources,R> R replay(java.lang.Throwable th,
                                             net.e6tech.elements.common.resources.Resources.Replay<Res,R> replay)

submit

public <Res extends Resources> void submit(Transactional.ConsumerWithException<Res> work)

submit

public <Res extends Resources,R> R submit(Transactional.FunctionWithException<Res,R> work)

commit

public <R> R commit()

abort

public void abort()

close

public void close()
           throws java.lang.Exception

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.lang.Exception

provision

public <T extends Provision> T provision()