feat(core): add MapNode#getOrDefault

Author: Siroshun09

core/src/main/java/com/github/siroshun09/configapi/core/node/MapNode.java

@@ -89,7 +89,19 @@ public sealed interface MapNode extends CommentableNode<Map<Object, Node<?>>> pe
      * @param key the key to get
      * @return a {@link Node} to which the specified key is mapped, or {@link NullNode#NULL} if this {@link MapNode} contains no mapping for the key
      */
-    @NotNull Node<?> get(@NotNull Object key);
+    default @NotNull Node<?> get(@NotNull Object key) {
+        return this.getOrDefault(key, NullNode.NULL);
+    }
+
+    /**
+     * Gets a {@link Node} to which the specified key is mapped,
+     * or the specified {@link Node} if this {@link MapNode} contains no mapping for the key.
+     *
+     * @param key         the key to get
+     * @param defaultNode the {@link Node} to return when this {@link MapNode} contains no mapping for the key
+     * @return a {@link Node} to which the specified key is mapped, or the specified {@link Node} if this {@link MapNode} contains no mapping for the key
+     */
+    @NotNull Node<?> getOrDefault(@NotNull Object key, @NotNull Node<?> defaultNode);
 
     /**
      * Sets a {@link Node} to the specified key.
@@ -448,7 +460,7 @@ default short getShort(@NotNull Object key) {
     default short getShort(@NotNull Object key, short def) {
         return this.raw(key) instanceof NumberValue value ? value.asShort() : def;
     }
-    
+
     private @NotNull Node<?> raw(@NotNull Object key) {
         var node = this.get(key);
         return node instanceof CommentedNode<?> commentedNode ? commentedNode.node() : node;

core/src/main/java/com/github/siroshun09/configapi/core/node/MapNodeImpl.java

@@ -54,9 +54,10 @@ public boolean hasValue() {
     }
 
     @Override
-    public @NotNull Node<?> get(@NotNull Object key) {
+    public @NotNull Node<?> getOrDefault(@NotNull Object key, @NotNull Node<?> defaultNode) {
         Objects.requireNonNull(key);
-        return this.backing.getOrDefault(key, NullNode.NULL);
+        Objects.requireNonNull(defaultNode);
+        return this.backing.getOrDefault(key, defaultNode);
     }
 
     @Override

core/src/test/java/com/github/siroshun09/configapi/core/node/MapNodeTest.java

@@ -79,8 +79,12 @@ void testGet() {
         var mapNode = MapNode.create(Map.of("a", "b", 1, 2));
         Assertions.assertEquals(new StringValue("b"), mapNode.get("a"));
         Assertions.assertEquals(new IntValue(2), mapNode.get(1));
+
         Assertions.assertSame(NullNode.NULL, mapNode.get("b"));
         Assertions.assertSame(NullNode.NULL, MapNode.empty().get("a"));
+
+        Assertions.assertSame(BooleanValue.TRUE, mapNode.getOrDefault("b", BooleanValue.TRUE));
+        Assertions.assertSame(BooleanValue.TRUE, MapNode.empty().getOrDefault("a", BooleanValue.TRUE));
     }
 
     @Test