io.flamingock.internal.common.core.metadata

Class MetadataLoader

java.lang.Object

io.flamingock.internal.common.core.metadata.MetadataLoader

public final class MetadataLoader
extends java.lang.Object

Runtime entry point that discovers all Flamingock-aware modules on the classpath via ServiceLoader, validates each module in isolation, and produces a single composite FlamingockMetadata for the runner to consume.

Each module's annotation processor generates a FlamingockMetadataProvider implementation registered in META-INF/services/. loadAggregated() reads each provider's metadata file, applies per-module checks (strict-stage-mapping orphan gate, single builder provider across modules), then aggregates pipelines, properties, and the builder provider into one composite. Multi-module concerns live entirely here, so downstream callers (CoreConfiguration, SpringbootProperties, the CLI entry point) keep their single-FlamingockMetadata contract.

Method Summary

Modifier and Type	Method and Description
static FlamingockMetadata	loadAggregated() Discover all modules on the classpath, run per-module validation, and aggregate into a single composite FlamingockMetadata.
static java.util.List<FlamingockMetadata>	loadAll() Per-module metadata list.

Methods inherited from class java.lang.Object

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

Method Detail

loadAll

public static java.util.List<FlamingockMetadata> loadAll()

Per-module metadata list. Primarily for diagnostics, tests, or callers that need module-origin information. Most production callers should use loadAggregated().

loadAggregated

public static FlamingockMetadata loadAggregated()

Discover all modules on the classpath, run per-module validation, and aggregate into a single composite FlamingockMetadata. The composite is a "runtime view" with orphans/strict/pipelineFile null'd because they have already been enforced.

Throws:

java.lang.RuntimeException - when no providers are registered (no Flamingock-aware module on the classpath) — the typical user error of "did you add the processor as an annotation processor?".