From 93ecfd1e0c1d1e40fb17e580a7a11de35383ef79 Mon Sep 17 00:00:00 2001 From: Matthias Andreas Benkard Date: Sat, 15 Jan 2022 14:03:41 +0100 Subject: Load providers registered through the ServiceLoader mechanism. Change-Id: I392e78b34c8330e9b4c06d57b1423ca552ba6fc1 --- .../quarkus/googlecloud/jsonlogging/Formatter.java | 29 ++++++++++++++++++++++ .../googlecloud/jsonlogging/package-info.java | 10 ++++++-- 2 files changed, 37 insertions(+), 2 deletions(-) (limited to 'core/src/main') diff --git a/core/src/main/java/eu/mulk/quarkus/googlecloud/jsonlogging/Formatter.java b/core/src/main/java/eu/mulk/quarkus/googlecloud/jsonlogging/Formatter.java index 066f709..61a2dea 100644 --- a/core/src/main/java/eu/mulk/quarkus/googlecloud/jsonlogging/Formatter.java +++ b/core/src/main/java/eu/mulk/quarkus/googlecloud/jsonlogging/Formatter.java @@ -7,6 +7,7 @@ import java.util.Collection; import java.util.HashMap; import java.util.List; import java.util.Map; +import java.util.ServiceLoader; import java.util.logging.Level; import org.jboss.logmanager.ExtFormatter; import org.jboss.logmanager.ExtLogRecord; @@ -35,6 +36,9 @@ public class Formatter extends ExtFormatter { /** * Constructs a {@link Formatter}. * + *

Note: This constructor does not automatically discover providers using the + * {@link ServiceLoader} mechanism. See {@link #load} for this case use. + * * @param parameterProviders the {@link StructuredParameterProvider}s to apply to each log entry. * @param labelProviders the {@link LabelProvider}s to apply to each log entry. */ @@ -45,6 +49,31 @@ public class Formatter extends ExtFormatter { this.labelProviders = List.copyOf(labelProviders); } + /** + * Constructs a {@link Formatter} with parameter and label providers supplied by {@link + * ServiceLoader}. + * + *

In addition to the providers supplied as parameters, this factory method loads all {@link + * StructuredParameterProvider}s and {@link LabelProvider}s found through the {@link + * ServiceLoader} mechanism. + * + * @param parameterProviders the {@link StructuredParameterProvider}s to apply to each log entry. + * @param labelProviders the {@link LabelProvider}s to apply to each log entry. + */ + public static Formatter load( + Collection parameterProviders, + Collection labelProviders) { + parameterProviders = new ArrayList<>(parameterProviders); + ServiceLoader.load(StructuredParameterProvider.class, Formatter.class.getClassLoader()) + .forEach(parameterProviders::add); + + labelProviders = new ArrayList<>(labelProviders); + ServiceLoader.load(LabelProvider.class, Formatter.class.getClassLoader()) + .forEach(labelProviders::add); + + return new Formatter(parameterProviders, labelProviders); + } + @Override public String format(ExtLogRecord logRecord) { var message = formatMessageWithStackTrace(logRecord); diff --git a/core/src/main/java/eu/mulk/quarkus/googlecloud/jsonlogging/package-info.java b/core/src/main/java/eu/mulk/quarkus/googlecloud/jsonlogging/package-info.java index 2f4c7ce..3617b8c 100644 --- a/core/src/main/java/eu/mulk/quarkus/googlecloud/jsonlogging/package-info.java +++ b/core/src/main/java/eu/mulk/quarkus/googlecloud/jsonlogging/package-info.java @@ -123,8 +123,14 @@ * parameters for each message that is logged. This can be used to provide contextual information * such as tracing and request IDs stored in thread-local storage. * - *

If you are using the Quarkus extension, CDI beans that implement these interfaces are - * automatically detected at build time and passed to the formatter on startup. + *

Service provider support: Providers can be registered using the {@link + * java.util.ServiceLoader} mechanism, in which case {@link + * eu.mulk.quarkus.googlecloud.jsonlogging.Formatter#load} picks them up automatically. + * + *

CDI support: If you are using the Quarkus extension, CDI beans that implement + * one of the provider interfaces are automatically detected at build time and passed to the + * formatter on startup. In addition, providers using the {@link java.util.ServiceLoader} mechanism + * are detected and passed to the formatter as well. * *

Example: * -- cgit v1.2.3