Update Collections.

Author: gk-brown

README.md

@@ -954,15 +954,17 @@ public static <E> List<E> emptyListOf(Class<E> elementType) { ... }
 ```
 
 ```java
-public static <K, V> Map<K, V> mapOf(Map.Entry<K, V>... entries) { ... }
+public static <K, V> SequencedMap<K, V> mapOf(Map.Entry<K, V>... entries) { ... }
+
 public static <K, V> Map<K, V> immutableMapOf(Map.Entry<K, V>... entries) { ... }
 public static <K, V> Map<K, V> emptyMapOf(Class<K> keyType, Class<V> valueType) { ... }
 
 public static <K extends Comparable<? super K>, V> SortedMap<K, V> sortedMapOf(Map.Entry<K, V>... entries) { ... }
 ```
 
 ```java
-public static <E> Set<E> setOf(E... elements) { ... }
+public static <E> SequencedSet<E> setOf(E... elements) { ... }
+
 public static <E> Set<E> immutableSetOf(E... elements) { ... }
 public static <E> Set<E> emptySetOf(Class<E> elementType) { ... }
 

kilo-client/src/main/java/org/httprpc/kilo/util/Collections.java

@@ -20,6 +20,8 @@
 import java.util.LinkedHashSet;
 import java.util.List;
 import java.util.Map;
+import java.util.SequencedMap;
+import java.util.SequencedSet;
 import java.util.Set;
 import java.util.SortedMap;
 import java.util.SortedSet;
@@ -174,7 +176,7 @@ public static <E> List<E> emptyListOf(Class<E> elementType) {
      * A map containing the provided entries in the order given.
      */
     @SafeVarargs
-    public static <K, V> Map<K, V> mapOf(Map.Entry<K, V>... entries) {
+    public static <K, V> SequencedMap<K, V> mapOf(Map.Entry<K, V>... entries) {
         var map = new LinkedHashMap<K, V>(entries.length);
 
         for (var entry : entries) {
@@ -201,7 +203,7 @@ public static <K, V> Map<K, V> mapOf(Map.Entry<K, V>... entries) {
      * @return
      * A map containing the provided entries in the order given.
      */
-    public static <K, V> Map<K, V> mapOf(Iterable<? extends Map.Entry<? extends K, ? extends V>> entries) {
+    public static <K, V> SequencedMap<K, V> mapOf(Iterable<? extends Map.Entry<? extends K, ? extends V>> entries) {
         if (entries == null) {
             throw new IllegalArgumentException();
         }
@@ -399,7 +401,7 @@ public static <K, V> Map.Entry<K, V> entry(K key, V value) {
      * A set containing the provided elements in the order given.
      */
     @SafeVarargs
-    public static <E> Set<E> setOf(E... elements) {
+    public static <E> SequencedSet<E> setOf(E... elements) {
         var set = new LinkedHashSet<E>(elements.length);
 
         java.util.Collections.addAll(set, elements);
@@ -419,7 +421,7 @@ public static <E> Set<E> setOf(E... elements) {
      * @return
      * A set containing the provided elements in the order given.
      */
-    public static <E> Set<E> setOf(Iterable<? extends E> elements) {
+    public static <E> SequencedSet<E> setOf(Iterable<? extends E> elements) {
         if (elements == null) {
             throw new IllegalArgumentException();
         }