mirror of
https://github.com/PaperMC/Paper.git
synced 2024-12-28 23:38:25 +01:00
988b902234
* Item serialization as json * Add ItemStackAdapter for Gson * A javadoc note at #serialize() and #deserialize() * Rebase * Move serialize closer to deserialize * Add explaining comment about SERIALIZE_CUSTOM_AS_SNBT usage * Apply lynxplay requests * Forgot `@NotNull` * Very important diff was removed * Rebase * Javadocs --------- Co-authored-by: Bjarne Koll <git@lynxplay.dev>
47 lines
2.2 KiB
Diff
47 lines
2.2 KiB
Diff
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
From: masmc05 <masmc05@gmail.com>
|
|
Date: Sun, 11 Aug 2024 03:01:52 +0300
|
|
Subject: [PATCH] Item serialization as json
|
|
|
|
|
|
diff --git a/src/main/java/org/bukkit/UnsafeValues.java b/src/main/java/org/bukkit/UnsafeValues.java
|
|
index 0000000000000000000000000000000000000000..0000000000000000000000000000000000000000 100644
|
|
--- a/src/main/java/org/bukkit/UnsafeValues.java
|
|
+++ b/src/main/java/org/bukkit/UnsafeValues.java
|
|
@@ -0,0 +0,0 @@ public interface UnsafeValues {
|
|
|
|
ItemStack deserializeItem(byte[] data);
|
|
|
|
+ /**
|
|
+ * Serializes this itemstack to json format.
|
|
+ * It is safe for data migrations as it will use the built-in data converter instead of bukkit's
|
|
+ * dangerous serialization system.
|
|
+ * <p>
|
|
+ * The emitted json object's format will inherently change across versions and hence should not be used for
|
|
+ * non-development purposes like plugin configurations or end-user input.
|
|
+ *
|
|
+ * @return json object representing this item.
|
|
+ * @see #deserializeItemFromJson(com.google.gson.JsonObject)
|
|
+ * @throws IllegalArgumentException if the passed itemstack is {@link ItemStack#empty()}.
|
|
+ */
|
|
+ @NotNull
|
|
+ com.google.gson.JsonObject serializeItemAsJson(@NotNull ItemStack itemStack);
|
|
+
|
|
+ /**
|
|
+ * Creates an itemstack from a json object.
|
|
+ * <p>
|
|
+ * This method expects a json object in the format emitted by {@link #serializeItemAsJson(ItemStack)}.
|
|
+ * <p>
|
|
+ * The emitted json object's format will inherently change across versions and hence should not be used for
|
|
+ * non-development purposes like plugin configurations or end-user input.
|
|
+ *
|
|
+ * @param data object representing an item in Json format
|
|
+ * @return the deserialize item stack, migrated to the latest data version if needed.
|
|
+ * @throws IllegalArgumentException if the json object is not a valid item
|
|
+ * @see #serializeItemAsJson(ItemStack)
|
|
+ */
|
|
+ @NotNull ItemStack deserializeItemFromJson(@NotNull com.google.gson.JsonObject data) throws IllegalArgumentException;
|
|
+
|
|
byte[] serializeEntity(org.bukkit.entity.Entity entity);
|
|
|
|
default org.bukkit.entity.Entity deserializeEntity(byte[] data, World world) {
|