mats3 0.19.9-2023-05-04 API

Packages
Package
Description
API for Mats3: Message-based Asynchronous Transactional Staged Stateless Services.
Extension to the Mats3 API which adds interception capabilities - all operations for initiation and stage processing can be intercepted.
Java Message Service v1.1 (JMS v1.1) implementation of the Mats3 API and Mats3 Intercept API.
Mats3 interceptor for structured logging over SLF4J, adding several data points using the SLF4J MDC for each initiation, message receive and message send - consists of a single class MatsMetricsLoggingInterceptor, for which the JMS implementation has special support in that if it resides on the classpath, it will autoinstall.
Mats3 interceptor adding metrics gathering using Spring's Micrometer solution - consists of a single class MatsMicrometerInterceptor, for which the JMS implementation has special support in that if it resides on the classpath, it will autoinstall.
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.
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.
An implementation of MatsTrace which uses short-named fields to carry all the needed information - meant to be field-serialized using for example Jackson.
Mats3 MatsSerializer implementation using Jackson to serialize between MatsTraceStringImpl and byte arrays - Employed by the Mats3 JMS Implementation.
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.
Tooling for handling your application's configuration of a JMS ConnectionFactory in different scenarios (development, testing, staging, production) - best explained in the class doc of ScenarioConnectionFactoryProducer - do note that this should not be the first thing you delve into when trying out Mats!
Implementation of JMS Mats's JmsMatsTransactionManager employing Spring's TransactionManager for the data source aspect.
Mats3 Spring-specific testing tools, for quickly firing up a test-harness using either JUnit or Jupiter (JUnit 5) - read class doc of MatsTestContext and MatsTestInfrastructureConfiguration.
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.
Common code for the modules 'mats-test-junit' and 'mats-test-jupiter' - These abstract classes should not be used directly, but rather utilized through the mentioned implementations.
Tool for creating a MQ Broker to easily create a MatsFactory backed by an in-vm MQ Broker, employed by several of the other Mats testing tools - by default uses Apache ActiveMQ, but may be directed to use Apache Artemis instead, or to use an external ActiveMQ or Artemis broker.
Mats3 testing tools for JUnit 4.
Mats3 testing tools for Jupiter (JUnit 5).
Mats3 Utilities - notably the MatsFuturizer, which provides a bridge from synchronous processes to the highly asynchronous Mats^3 services.
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.