io.mats3

Class MatsFactory.ContextLocal

java.lang.Object

io.mats3.MatsFactory.ContextLocal

Enclosing interface:

MatsFactory

public static class MatsFactory.ContextLocal
extends java.lang.Object

Provides ThreadLocal access to attributes from the MatsInitiator.MatsInitiate initiate context and MatsStage process context - currently getAttribute(Class, String...), which can provide you with the transactionally demarcated SQL Connection if the Mats implementation provides such.

Constructor Summary

Constructors

Constructor and Description
ContextLocal()

Method Summary

Modifier and Type	Method and Description
static <T> java.util.Optional<T>	getAttribute(java.lang.Class<T> type, java.lang.String... name) Provides a ThreadLocal-accessible variant of the ProcessContext.getAttribute(..) and MatsInitiate.getAttribute(..) methods: If the executing thread is within a Mats initiation, or is currently processing a MatsStage, the return value will be the same as if the relevant getAttribute(..) method was invoked.

Methods inherited from class java.lang.Object

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

Constructor Detail

ContextLocal

public ContextLocal()

Method Detail

getAttribute

public static <T> java.util.Optional<T> getAttribute(java.lang.Class<T> type,
                                                     java.lang.String... name)

Provides a ThreadLocal-accessible variant of the ProcessContext.getAttribute(..) and MatsInitiate.getAttribute(..) methods: If the executing thread is within a Mats initiation, or is currently processing a MatsStage, the return value will be the same as if the relevant getAttribute(..) method was invoked. Otherwise, if the current thread is not processing a stage or performing an initiation, Optional.empty() is returned.

If the Mats implementation has a transactional SQL Connection, it shall be available by ContextLocal.getAttribute(Connection.class) when in the relevant contexts (init or stage).

Type Parameters:

T - The type of the attribute.

Parameters:

type - The expected type of the attribute

name - The (optional) (hierarchical) name(s) of the attribute.

Returns:

Optional of the attribute in question - if not in relevant context, Optional.empty() is always returned.

See Also:

MatsEndpoint.ProcessContext.getAttribute(Class, String...), MatsInitiator.MatsInitiate.getAttribute(Class, String...), MatsFactory.getDefaultInitiator()