Package io.mats3.util

package io.mats3.util

Mats³ Utilities - notably the MatsFuturizer, which provides a bridge from synchronous processes to the highly asynchronous Mats^3 services.

Related Packages

Package	Description
io.mats3	API for Mats3: Message-based Asynchronous Transactional Staged Stateless Services.
io.mats3.util.wrappers	Wrappers for JMS ConnectionFactory and JDBC DataSource - with a special "deferred connection proxy" wrapper which is smart to use as underlying DataSource for the SQL-oriented JmsMatsTransactionManagers, as it elides transactions if the connection is not actually employed within an initiation or stage processing.
io.mats3.localinspect	Mats3 tool that can output an embeddable HTML describing a MatsFactory and all its endpoints, as well as "local statistics", gathered using a Mats Interceptor.
io.mats3.serial	Mats3 wire format solution called "MatsTrace", which defines a set of parameters and structures sufficient to represent an envelope carrying Mats messages, as well as a deser-interface "MatsSerializer" which defines methods between MatsTrace and byte arrays - Employed by the Mats3 JMS Implementation.
io.mats3.spring	Mats3 Spring integration ("SpringConfig"), supplying a set of annotations including @EnableMats to enable bean scanning for @MatsMapping and @MatsClassMapping annotations, simplifying use of Mats3 in a Spring context.
io.mats3.test	Contains a set of helpful tools for testing: MatsTestBrokerInterface to get DLQ'ed messages, MatsTestHelp for creation of relevant ids, MatsTestLatch for a simple tool to synchronize between the test method and the async Mats endpoints, and TestH2DataSource which is a small wrapper around H2 to create a database with a test table - mainly used by the API Tests to verify SQL transactions.

Class	Description
MatsFuturizer	An instance of this class acts as a bridge service between the synchronous world of e.g.
MatsFuturizer.MatsFuturizerTimeoutException	This exception is raised through the CompletableFuture if the timeout specified when getting the CompletableFuture is reached (to get yourself a future, use one of the futurizeXYZ(..) methods).
MatsFuturizer.Promise<T>
MatsFuturizer.Reply<T>	An instance of this class will be the return value of any CompletableFutures created with the MatsFuturizer.
RandomString	If you need a random string for a part of the traceId (Read NOTE about traceIds!), use this class instead of UUID, because UUID has low entropy density with only 4 bits per character, and dashes.
SanitizeMqNames	Utility class for replacing dodgy characters from queue/topic names, and names in general, in the Message Broker world - it is quite restrictive, replacing any character not in [a-z,A-Z,0-9,.,_,-] (lower alpha, upper alpha, digits, dot, underscore, minus/dash) with '_'.
TraceId	A small tool to produce a String - specifically an opinionated TraceId.