add createRecordFromNBT

Author: CoolLoong

gradle.properties

@@ -1 +1 @@
-version=3.0.6
+version=3.0.7

src/main/java/org/cloudburstmc/nbt/NbtUtils.java

@@ -7,9 +7,13 @@
 import org.cloudburstmc.nbt.util.stream.NetworkDataOutputStream;
 
 import java.io.*;
+import java.lang.reflect.Constructor;
 import java.lang.reflect.InvocationTargetException;
 import java.lang.reflect.Method;
+import java.lang.reflect.RecordComponent;
+import java.util.ArrayList;
 import java.util.Arrays;
+import java.util.List;
 import java.util.StringJoiner;
 import java.util.zip.GZIPInputStream;
 import java.util.zip.GZIPOutputStream;
@@ -169,4 +173,36 @@ public static NbtMap putRecordToNBT(Record record, NbtMap nbtMap) {
         }
         return builder.build();
     }
+
+    /**
+     * Create record instance annotated with {@link NBT} from nbtMap
+     *
+     * @param <T>    the type parameter
+     * @param clazz  the record class
+     * @param nbtMap the nbt map
+     * @return the record
+     */
+    public static <T extends Record> T createRecordFromNBT(Class<T> clazz, NbtMap nbtMap) {
+        NBT annotation = clazz.getAnnotation(NBT.class);
+        if (annotation == null) {
+            throw new IllegalArgumentException("This record does not use @NBT annotation!");
+        }
+        RecordComponent[] recordComponents = clazz.getRecordComponents();
+        List<Object> params = new ArrayList<>(recordComponents.length);
+        for (var c : recordComponents) {
+            params.add(nbtMap.get(c.getName()));
+        }
+        try {
+            Constructor<T> constructor = clazz.getDeclaredConstructor(Arrays.stream(recordComponents).map(RecordComponent::getType).toArray(Class[]::new));
+            try {
+                constructor.setAccessible(true);
+                return constructor.newInstance(params.toArray());
+            } finally {
+                constructor.setAccessible(false);
+            }
+        } catch (NoSuchMethodException | InvocationTargetException | InstantiationException |
+                 IllegalAccessException e) {
+            throw new RuntimeException(e);
+        }
+    }
 }

src/main/java/org/cloudburstmc/nbt/annotation/NBT.java

@@ -1,11 +1,17 @@
 package org.cloudburstmc.nbt.annotation;
 
 
+import org.cloudburstmc.nbt.NbtMap;
+
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+/**
+ * {@link Record} marked with this annotation can be converted {@link org.cloudburstmc.nbt.NbtMap NBT} and create from it<p>
+ * By using {@link org.cloudburstmc.nbt.NbtMap#fromRecord(Record) fromRecord} and {@link org.cloudburstmc.nbt.NbtUtils#createRecordFromNBT(Class, NbtMap) createRecordFromNBT}
+ */
 @Target(value = {ElementType.TYPE})
 @Retention(RetentionPolicy.RUNTIME)
 public @interface NBT {

src/test/java/org/cloudburstmc/nbt/NbtTest.java

@@ -68,6 +68,17 @@ record Data(int a, int b, int c) {
                 {"a":1,"b":2,"c":3}""");
     }
 
+    @Test
+    void testCreateRecordFromNBT() {
+        NbtMap map = SNBTParser.parse(NbtType.COMPOUND, """
+                {"a":1,"b":2,"c":3}""");
+        @NBT
+        record Data(int a, int b, int c) {
+        }
+        Data data = NbtUtils.createRecordFromNBT(Data.class, map);
+        Assertions.assertEquals(new Data(1, 2, 3), data);
+    }
+
     @Test
     void testPutRecordToNBT() {
         @NBT