Add getConfiguration method for multiple URIs

Author: yybmion

log4j-core/src/main/java/org/apache/logging/log4j/core/config/ConfigurationFactory.java

@@ -25,6 +25,7 @@
 import java.util.Collections;
 import java.util.List;
 import java.util.Map;
+import java.util.Objects;
 import java.util.concurrent.locks.Lock;
 import java.util.concurrent.locks.ReentrantLock;
 import org.apache.logging.log4j.Level;
@@ -333,6 +334,73 @@ public Configuration getConfiguration(
         return getConfiguration(loggerContext, name, configLocation);
     }
 
+    /**
+     * Creates a Configuration from multiple configuration URIs.
+     * If multiple URIs are successfully loaded, they will be combined into a CompositeConfiguration.
+     *
+     * @param loggerContext the logger context (may be null)
+     * @param name the configuration name (may be null)
+     * @param uris the list of configuration URIs (must not be null or empty)
+     * @return a Configuration created from the provided URIs
+     * @throws NullPointerException if uris is null
+     * @throws IllegalArgumentException if uris is empty
+     * @throws ConfigurationException if no valid configuration could be created
+     * from any of the provided URIs
+     * @since 2.26.0
+     */
+    public Configuration getConfiguration(final LoggerContext loggerContext, final String name, final List<URI> uris) {
+
+        Objects.requireNonNull(uris, "uris parameter cannot be null");
+
+        if (uris.isEmpty()) {
+            throw new IllegalArgumentException("URI list cannot be empty");
+        }
+
+        if (uris.size() == 1) {
+            final Configuration config = getConfiguration(loggerContext, name, uris.get(0));
+            if (config == null) {
+                throw new ConfigurationException("Failed to create configuration from: " + uris.get(0));
+            }
+            return config;
+        }
+
+        final List<AbstractConfiguration> configurations = new ArrayList<>();
+        final List<URI> failedUris = new ArrayList<>();
+
+        for (final URI uri : uris) {
+            try {
+                final Configuration config = getConfiguration(loggerContext, name, uri);
+
+                if (config != null) {
+                    if (config instanceof AbstractConfiguration) {
+                        configurations.add((AbstractConfiguration) config);
+                    } else {
+                        LOGGER.error("Configuration at {} is not an AbstractConfiguration", uri);
+                        failedUris.add(uri);
+                    }
+                } else {
+                    LOGGER.debug("Unable to load configuration from: {}", uri);
+                    failedUris.add(uri);
+                }
+            } catch (final Exception ex) {
+                LOGGER.debug("Error loading configuration from {}: {}", uri, ex.getMessage());
+                failedUris.add(uri);
+            }
+        }
+
+        if (configurations.isEmpty()) {
+            throw new ConfigurationException(String.format(
+                    "Failed to create configuration from any of the %d URIs. Failed URIs: %s",
+                    uris.size(), failedUris));
+        }
+
+        if (!failedUris.isEmpty()) {
+            LOGGER.warn("Failed to load configurations from: {}", failedUris);
+        }
+
+        return configurations.size() == 1 ? configurations.get(0) : new CompositeConfiguration(configurations);
+    }
+
     static boolean isClassLoaderUri(final URI uri) {
         if (uri == null) {
             return false;

log4j-core/src/main/java/org/apache/logging/log4j/core/config/json/package-info.java

@@ -18,7 +18,7 @@
  * Classes and interfaces supporting configuration of Log4j 2 with JSON.
  */
 @Export
-@Version("2.20.1")
+@Version("2.21.0")
 package org.apache.logging.log4j.core.config.json;
 
 import org.osgi.annotation.bundle.Export;

log4j-core/src/main/java/org/apache/logging/log4j/core/config/properties/package-info.java

@@ -18,7 +18,7 @@
  * Configuration using Properties files.
  */
 @Export
-@Version("2.20.1")
+@Version("2.21.0")
 package org.apache.logging.log4j.core.config.properties;
 
 import org.osgi.annotation.bundle.Export;

log4j-core/src/main/java/org/apache/logging/log4j/core/config/xml/package-info.java

@@ -18,7 +18,7 @@
  * Classes and interfaces supporting configuration of Log4j 2 with XML.
  */
 @Export
-@Version("2.20.2")
+@Version("2.21.0")
 package org.apache.logging.log4j.core.config.xml;
 
 import org.osgi.annotation.bundle.Export;

log4j-core/src/main/java/org/apache/logging/log4j/core/config/yaml/package-info.java

@@ -18,7 +18,7 @@
  * Classes and interfaces supporting configuration of Log4j 2 with YAML.
  */
 @Export
-@Version("2.20.1")
+@Version("2.21.0")
 package org.apache.logging.log4j.core.config.yaml;
 
 import org.osgi.annotation.bundle.Export;