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(ResourceManager resourceManager)

Method Summary

Modifier and Type	Method and Description
void	abort()
void	addModule(Module 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.Class<T> cls, java.lang.String name, T resource)
<E extends java.lang.Exception> void	briefly(ConsumerWithException<Bindings,E> consumer)
<T,E extends java.lang.Exception> T	briefly(FunctionWithException<Bindings,T,E> function)
protected void	cleanup()
void	close()
<R> R	commit()
Configurator	configurator()
void	configure(Configurator configurator)
<T> T	getInstance(java.lang.Class<T> cls)
<T> T	getInstance(java.lang.Class<T> cls, java.util.function.Supplier<T> call)
java.lang.Throwable	getLastException()
Module	getModule()
<T> T	getNamedInstance(java.lang.Class<T> cls, java.lang.String name)
<R,S,T extends Plugin> java.util.Optional<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> java.util.Optional<T>	getPlugin(java.lang.Class<S> c1, java.lang.String n1, java.lang.Class<T> c2, java.lang.Object... args)
<T extends Plugin> java.util.Optional<T>	getPlugin(PluginPath<T> path, java.lang.Object... args)
<T extends Plugin> java.util.Optional<T>	getPlugin(PluginPaths<T> paths, java.lang.Object... args)
ResourceManager	getResourceManager()
Retry	getRetry()
<T> java.util.Optional<T>	getVariable(java.lang.String key)
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	isOpen()
<T> T	nullableVar(java.lang.String key)
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.Class<T> cls, java.lang.String name, T resource)
boolean	remove(ResourceProvider provider)
protected <T extends Resources,R,E extends java.lang.Exception> R	replay(java.lang.Exception th, net.e6tech.elements.common.resources.Resources.Replay<T,R,E> replay)
void	setRetry(Retry retry)
void	setVariable(java.lang.String key, java.lang.Object val)
<R extends Resources,E extends java.lang.Exception> void	submit(ConsumerWithException<R,E> work)
<T extends Resources,R,E extends java.lang.Exception> R	submit(FunctionWithException<T,R,E> 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(ResourceManager resourceManager)

Method Detail

nullableVar

public <T> T nullableVar(java.lang.String key)

getVariable

public <T> java.util.Optional<T> getVariable(java.lang.String key)

setVariable

public void setVariable(java.lang.String key,
                        java.lang.Object val)

getRetry

public Retry getRetry()

setRetry

@Inject(optional=true)
public void setRetry(Retry retry)

isCommitted

public boolean isCommitted()

isOpen

public boolean isOpen()

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> java.util.Optional<T> getPlugin(java.lang.Class<S> c1,
                                                            java.lang.String n1,
                                                            java.lang.Class<T> c2,
                                                            java.lang.Object... args)

getPlugin

public <R,S,T extends Plugin> java.util.Optional<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> java.util.Optional<T> getPlugin(PluginPath<T> path,
                                                          java.lang.Object... args)

getPlugin

public <T extends Plugin> java.util.Optional<T> getPlugin(PluginPaths<T> paths,
                                                          java.lang.Object... args)

getModule

public Module getModule()

addModule

public void addModule(Module module)

briefly

public <E extends java.lang.Exception> void briefly(ConsumerWithException<Bindings,E> consumer)
                                             throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

briefly

public <T,E extends java.lang.Exception> T briefly(FunctionWithException<Bindings,T,E> function)
                                            throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

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.Class<T> cls,
                               java.lang.String name,
                               T resource)

Specified by:

bindNamedInstance in interface ResourcePool

rebindNamedInstance

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

Specified by:

rebindNamedInstance in interface ResourcePool

getNamedInstance

public <T> T getNamedInstance(java.lang.Class<T> cls,
                              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)

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 <T extends Resources,R,E extends java.lang.Exception> R replay(java.lang.Exception th,
                                                                         net.e6tech.elements.common.resources.Resources.Replay<T,R,E> replay)

submit

public <R extends Resources,E extends java.lang.Exception> void submit(ConsumerWithException<R,E> work)

submit

public <T extends Resources,R,E extends java.lang.Exception> R submit(FunctionWithException<T,R,E> work)

getLastException

public java.lang.Throwable getLastException()

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

cleanup

protected void cleanup()

provision

public <T extends Provision> T provision()