chore: merge main into release [skip ci]

Author: github-actions[bot]

microsphere-java-core/src/main/java/io/microsphere/collection/PropertiesUtils.java

@@ -20,13 +20,19 @@
 import io.microsphere.annotation.Nonnull;
 import io.microsphere.util.Utils;
 
+import java.io.StringReader;
 import java.util.LinkedHashMap;
 import java.util.Map;
 import java.util.Properties;
 
 import static io.microsphere.collection.MapUtils.isEmpty;
 import static io.microsphere.collection.MapUtils.newLinkedHashMap;
+import static io.microsphere.constants.SeparatorConstants.FILE_SEPARATOR;
+import static io.microsphere.constants.SeparatorConstants.LINE_SEPARATOR;
 import static io.microsphere.constants.SymbolConstants.DOT;
+import static io.microsphere.lang.function.ThrowableAction.execute;
+import static io.microsphere.util.ArrayUtils.length;
+import static io.microsphere.util.StringUtils.arrayToString;
 import static java.util.Collections.unmodifiableMap;
 
 /**
@@ -144,6 +150,45 @@ public static Properties newProperties(Properties defaults) {
         return new Properties(defaults);
     }
 
+    /**
+     * Loads properties from the given string values.
+     *
+     * <p>The provided string values are joined using the system file separator to form a single content string,
+     * which is then parsed as a standard Java properties format.</p>
+     *
+     * <h3>Example Usage</h3>
+     * <pre>{@code
+     *     // Load properties from multiple lines
+     *     Properties props = PropertiesUtils.loadProperties(
+     *         "key1=value1",
+     *         "key2=value2"
+     *     );
+     *     System.out.println(props.getProperty("key1")); // Output: value1
+     *     System.out.println(props.getProperty("key2")); // Output: value2
+     *
+     *     // Load empty properties if no arguments are provided
+     *     Properties emptyProps = PropertiesUtils.loadProperties();
+     *     System.out.println(emptyProps.isEmpty()); // Output: true
+     * }</pre>
+     *
+     * @param propertiesValue the string values representing properties content
+     * @return a new {@link Properties} instance loaded from the given values
+     */
+    @Nonnull
+    public static Properties loadProperties(String... propertiesValue) {
+        int length = length(propertiesValue);
+        Properties properties = newProperties();
+        if (length > 0) {
+            String content = arrayToString(propertiesValue, LINE_SEPARATOR);
+            execute(() -> {
+                try (StringReader reader = new StringReader(content)) {
+                    properties.load(reader);
+                }
+            });
+        }
+        return properties;
+    }
+
     private PropertiesUtils() {
     }
 }

microsphere-java-core/src/test/java/io/microsphere/collection/PropertiesUtilsTest.java

@@ -23,6 +23,7 @@
 
 import static io.microsphere.collection.MapUtils.ofMap;
 import static io.microsphere.collection.PropertiesUtils.flatProperties;
+import static io.microsphere.collection.PropertiesUtils.loadProperties;
 import static io.microsphere.collection.PropertiesUtils.newProperties;
 import static java.util.Collections.emptyList;
 import static java.util.Collections.emptyMap;
@@ -74,11 +75,22 @@ void testNewPropertiesWithDefaults() {
         Properties defaults = new Properties();
         defaults.setProperty("key1", "value1");
         defaults.setProperty("key2", "value2");
-        
+
         Properties props = newProperties(defaults);
         assertNotNull(props);
         assertEquals("value1", props.getProperty("key1"));
         assertEquals("value2", props.getProperty("key2"));
         assertTrue(props.isEmpty());  // Properties from defaults are not in the main properties
     }
+
+    @Test
+    void testLoadProperties() {
+        Properties properties = loadProperties();
+        assertTrue(properties.isEmpty());
+
+        properties = loadProperties("a=1", "b : 2", "c 3");
+        assertEquals("1", properties.getProperty("a"));
+        assertEquals("2", properties.getProperty("b"));
+        assertEquals("3", properties.getProperty("c"));
+    }
 }