初始提交: UE5.3项目基础框架

Plugins/CesiumForUnreal/Source/ThirdParty/include/CesiumJsonReader/IJsonHandler.h

@@ -0,0 +1,122 @@
+#pragma once
+
+#include "Library.h"
+
+#include <cstdint>
+#include <string>
+#include <string_view>
+#include <vector>
+
+namespace CesiumJsonReader {
+/**
+ * @brief Base interface for all JSON handlers. Types that need to be
+ * deserialized from JSON should implement `IJsonHandler` or a class that
+ * derives from it. As the JSON is parsed, the corresponding `read...` method to
+ * the token that was parsed will be called. These methods can return themselves
+ * or a different handler to handle the value.
+ */
+class CESIUMJSONREADER_API IJsonHandler {
+public:
+  virtual ~IJsonHandler(){};
+  /**
+   * @brief Called when the JSON parser encounters a `null`.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readNull() = 0;
+  /**
+   * @brief Called when the JSON parser encounters a boolean value.
+   * @param b The boolean value.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readBool(bool b) = 0;
+  /**
+   * @brief Called when the JSON parser encounters an int32 value.
+   * @param i The int32 value.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readInt32(int32_t i) = 0;
+  /**
+   * @brief Called when the JSON parser encounters a uint32 value.
+   * @param i The uint32 value.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readUint32(uint32_t i) = 0;
+  /**
+   * @brief Called when the JSON parser encounters an int64 value.
+   * @param i The int64 value.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readInt64(int64_t i) = 0;
+  /**
+   * @brief Called when the JSON parser encounters a uint64 value.
+   * @param i The uint64 value.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readUint64(uint64_t i) = 0;
+  /**
+   * @brief Called when the JSON parser encounters a double value.
+   * @param d The double value.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readDouble(double d) = 0;
+  /**
+   * @brief Called when the JSON parser encounters a string value.
+   * @param str The string value.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readString(const std::string_view& str) = 0;
+
+  /**
+   * @brief Called when the JSON parser encounters the beginning of an object.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readObjectStart() = 0;
+  /**
+   * @brief Called when the JSON parser encounters a key while reading an
+   * object.
+   * @param str The key.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readObjectKey(const std::string_view& str) = 0;
+  /**
+   * @brief Called when the JSON parser encounters the end of an object.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readObjectEnd() = 0;
+
+  /**
+   * @brief Called when the JSON parser encounters the start of an array.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readArrayStart() = 0;
+  /**
+   * @brief Called when the JSON parser encounters the end of an array.
+   * @returns A \ref IJsonHandler that will handle the next `read...` call.
+   * This can be the same handler as the current one.
+   */
+  virtual IJsonHandler* readArrayEnd() = 0;
+
+  /**
+   * @brief Report a warning while reading JSON.
+   *
+   * @param warning The warning to report.
+   * @param context Context information to include with this warning to help
+   * debugging.
+   */
+  virtual void reportWarning(
+      const std::string& warning,
+      std::vector<std::string>&& context = std::vector<std::string>()) = 0;
+};
+} // namespace CesiumJsonReader