Add SetUtils for creating ordered sets

README.md

@@ -64,6 +64,23 @@ Set<Object> numbers = Stream.of(1, 2, 3, 2, 3)
     .collect(StreamUtil.toLinkedHashSet());
 ```
 
+### SetUtils
+
+`SetUtils` provides utility methods for creating ordered sets in Java.
+
+Unlike `Set.of(…)`, `SetUtils.orderedSet(…)` maintains the order of elements as they are added.
+
+#### Example Usage
+
+```java
+Set<String> ordered = SetUtils.orderedSet("abc", "def", "ghi");
+// Output: [abc, def, ghi]
+
+Set<Integer> numbers = SetUtils.orderedSet(3, 1, 2, 1);
+// Output: [3, 1, 2]
+```
+
+> **Key Difference**: `SetUtils.orderedSet(…)` uses `LinkedHashSet`, ensuring insertion order is preserved.
 
 ## AlphanumericComparator
 

src/main/java/de/cronn/commons/lang/SetUtils.java

@@ -0,0 +1,17 @@
+package de.cronn.commons.lang;
+
+import java.util.Arrays;
+import java.util.LinkedHashSet;
+import java.util.Set;
+
+public final class SetUtils {
+
+	private SetUtils() {
+	}
+
+	@SafeVarargs
+	@SuppressWarnings("varargs")
+	public static <E> Set<E> orderedSet(E... elements) {
+		return new LinkedHashSet<>(Arrays.asList(elements));
+	}
+}

src/test/java/de/cronn/commons/lang/SetUtilsTest.java

@@ -0,0 +1,19 @@
+package de.cronn.commons.lang;
+
+import static org.assertj.core.api.Assertions.*;
+
+import org.junit.jupiter.api.Test;
+
+class SetUtilsTest {
+
+	@Test
+	void testOrderedSet() {
+		assertThat(SetUtils.orderedSet("abc")).containsExactly("abc");
+		assertThat(SetUtils.orderedSet("abc", "def", "ghi")).containsExactly("abc", "def", "ghi");
+		assertThat(SetUtils.orderedSet(2, 1, 3)).containsExactly(2, 1, 3);
+		assertThat(SetUtils.orderedSet(2, 1, 3, 1)).containsExactly(2, 1, 3);
+		assertThat(SetUtils.orderedSet(null, "abc")).containsExactly(null, "abc");
+		assertThat(SetUtils.orderedSet((Object) null)).singleElement().isNull();
+	}
+
+}