| 
									
										
										
										
											2020-01-18 09:38:21 +01:00
										 |  |  | /*
 | 
					
						
							| 
									
										
										
										
											2020-01-24 16:45:29 +03:00
										 |  |  |  * Copyright (c) 2019-2020, Sergey Bugaev <bugaevc@serenityos.org> | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |  * Copyright (c) 2022, Idan Horowitz <idan.horowitz@serenityos.org> | 
					
						
							| 
									
										
										
										
											2020-01-18 09:38:21 +01:00
										 |  |  |  * | 
					
						
							| 
									
										
										
										
											2021-04-22 01:24:48 -07:00
										 |  |  |  * SPDX-License-Identifier: BSD-2-Clause | 
					
						
							| 
									
										
										
										
											2020-01-18 09:38:21 +01:00
										 |  |  |  */ | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  | #pragma once
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  | #include <AK/Error.h>
 | 
					
						
							|  |  |  | #include <AK/Try.h>
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #ifndef KERNEL
 | 
					
						
							|  |  |  | #    include <AK/JsonValue.h>
 | 
					
						
							|  |  |  | #endif
 | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  | 
 | 
					
						
							|  |  |  | namespace AK { | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | template<typename Builder> | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  | inline constexpr bool IsLegacyBuilder = requires(Builder builder) { builder.try_append('\0'); }; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | template<typename Builder = void> | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  | class JsonObjectSerializer; | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  | template<typename Builder = void> | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  | class JsonArraySerializer { | 
					
						
							|  |  |  | public: | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     static ErrorOr<JsonArraySerializer> try_create(Builder& builder) | 
					
						
							|  |  |  |     { | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) | 
					
						
							|  |  |  |             TRY(builder.try_append('[')); | 
					
						
							|  |  |  |         else | 
					
						
							|  |  |  |             TRY(builder.append('[')); | 
					
						
							|  |  |  |         return JsonArraySerializer { builder }; | 
					
						
							|  |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     JsonArraySerializer(JsonArraySerializer&& other) | 
					
						
							|  |  |  |         : m_builder(other.m_builder) | 
					
						
							|  |  |  |         , m_empty(other.m_empty) | 
					
						
							|  |  |  |         , m_finished(exchange(other.m_finished, true)) | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |     { | 
					
						
							|  |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-04-01 20:58:27 +03:00
										 |  |  |     JsonArraySerializer(JsonArraySerializer const&) = delete; | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  | #ifndef KERNEL
 | 
					
						
							| 
									
										
										
										
											2022-04-01 20:58:27 +03:00
										 |  |  |     ErrorOr<void> add(JsonValue const& value) | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |         value.serialize(m_builder); | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |     } | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  | #endif
 | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<void> add(StringView value) | 
					
						
							| 
									
										
										
										
											2019-09-04 14:39:08 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) { | 
					
						
							|  |  |  |             TRY(m_builder.try_append('"')); | 
					
						
							|  |  |  |             TRY(m_builder.try_append_escaped_for_json(value)); | 
					
						
							|  |  |  |             TRY(m_builder.try_append('"')); | 
					
						
							|  |  |  |         } else { | 
					
						
							|  |  |  |             TRY(m_builder.append('"')); | 
					
						
							|  |  |  |             TRY(m_builder.append_escaped_for_json(value)); | 
					
						
							|  |  |  |             TRY(m_builder.append('"')); | 
					
						
							|  |  |  |         } | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2019-09-04 14:39:08 +02:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  | #ifndef KERNEL
 | 
					
						
							| 
									
										
										
										
											2023-12-16 17:49:34 +03:30
										 |  |  |     ErrorOr<void> add(ByteString const& value) | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     { | 
					
						
							|  |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) { | 
					
						
							|  |  |  |             TRY(m_builder.try_append('"')); | 
					
						
							|  |  |  |             TRY(m_builder.try_append_escaped_for_json(value)); | 
					
						
							|  |  |  |             TRY(m_builder.try_append('"')); | 
					
						
							|  |  |  |         } else { | 
					
						
							|  |  |  |             TRY(m_builder.append('"')); | 
					
						
							|  |  |  |             TRY(m_builder.append_escaped_for_json(value)); | 
					
						
							|  |  |  |             TRY(m_builder.append('"')); | 
					
						
							|  |  |  |         } | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2019-09-04 14:39:08 +02:00
										 |  |  |     } | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  | #endif
 | 
					
						
							| 
									
										
										
										
											2019-09-04 14:39:08 +02:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-04-01 20:58:27 +03:00
										 |  |  |     ErrorOr<void> add(char const* value) | 
					
						
							| 
									
										
										
										
											2019-09-04 14:39:08 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) { | 
					
						
							|  |  |  |             TRY(m_builder.try_append('"')); | 
					
						
							|  |  |  |             TRY(m_builder.try_append_escaped_for_json(value)); | 
					
						
							|  |  |  |             TRY(m_builder.try_append('"')); | 
					
						
							|  |  |  |         } else { | 
					
						
							|  |  |  |             TRY(m_builder.append('"')); | 
					
						
							|  |  |  |             TRY(m_builder.append_escaped_for_json(value)); | 
					
						
							|  |  |  |             TRY(m_builder.append('"')); | 
					
						
							|  |  |  |         } | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2019-09-04 14:39:08 +02:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<void> add(bool value) | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) | 
					
						
							|  |  |  |             TRY(m_builder.try_append(value ? "true"sv : "false"sv)); | 
					
						
							|  |  |  |         else | 
					
						
							|  |  |  |             TRY(m_builder.append(value ? "true"sv : "false"sv)); | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<void> add(int value) | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) | 
					
						
							|  |  |  |             TRY(m_builder.try_appendff("{}", value)); | 
					
						
							|  |  |  |         else | 
					
						
							|  |  |  |             TRY(m_builder.appendff("{}", value)); | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<void> add(unsigned value) | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) | 
					
						
							|  |  |  |             TRY(m_builder.try_appendff("{}", value)); | 
					
						
							|  |  |  |         else | 
					
						
							|  |  |  |             TRY(m_builder.appendff("{}", value)); | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<void> add(long value) | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) | 
					
						
							|  |  |  |             TRY(m_builder.try_appendff("{}", value)); | 
					
						
							|  |  |  |         else | 
					
						
							|  |  |  |             TRY(m_builder.appendff("{}", value)); | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<void> add(long unsigned value) | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) | 
					
						
							|  |  |  |             TRY(m_builder.try_appendff("{}", value)); | 
					
						
							|  |  |  |         else | 
					
						
							|  |  |  |             TRY(m_builder.appendff("{}", value)); | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<void> add(long long value) | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) | 
					
						
							|  |  |  |             TRY(m_builder.try_appendff("{}", value)); | 
					
						
							|  |  |  |         else | 
					
						
							|  |  |  |             TRY(m_builder.appendff("{}", value)); | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<void> add(long long unsigned value) | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         if constexpr (IsLegacyBuilder<Builder>) | 
					
						
							|  |  |  |             TRY(m_builder.try_appendff("{}", value)); | 
					
						
							|  |  |  |         else | 
					
						
							|  |  |  |             TRY(m_builder.appendff("{}", value)); | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2021-06-30 11:31:12 +02:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<JsonArraySerializer<Builder>> add_array() | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         TRY(begin_item()); | 
					
						
							|  |  |  |         return JsonArraySerializer::try_create(m_builder); | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     // Implemented in JsonObjectSerializer.h
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<JsonObjectSerializer<Builder>> add_object(); | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     ErrorOr<void> finish() | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2021-02-23 20:42:32 +01:00
										 |  |  |         VERIFY(!m_finished); | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |         m_finished = true; | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         if constexpr (IsLegacyBuilder<Builder>) | 
					
						
							|  |  |  |             TRY(m_builder.try_append(']')); | 
					
						
							|  |  |  |         else | 
					
						
							|  |  |  |             TRY(m_builder.append(']')); | 
					
						
							|  |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | private: | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |     explicit JsonArraySerializer(Builder& builder) | 
					
						
							|  |  |  |         : m_builder(builder) | 
					
						
							|  |  |  |     { | 
					
						
							|  |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     ErrorOr<void> begin_item() | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |     { | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         VERIFY(!m_finished); | 
					
						
							|  |  |  |         if (!m_empty) { | 
					
						
							|  |  |  |             if constexpr (IsLegacyBuilder<Builder>) | 
					
						
							|  |  |  |                 TRY(m_builder.try_append(',')); | 
					
						
							|  |  |  |             else | 
					
						
							|  |  |  |                 TRY(m_builder.append(',')); | 
					
						
							|  |  |  |         } | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |         m_empty = false; | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  |         return {}; | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  |     } | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     Builder& m_builder; | 
					
						
							|  |  |  |     bool m_empty { true }; | 
					
						
							|  |  |  |     bool m_finished { false }; | 
					
						
							|  |  |  | }; | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-02-24 20:08:48 +02:00
										 |  |  | // Template magic to allow for JsonArraySerializer<>::try_create(...) - Blame CxByte
 | 
					
						
							|  |  |  | template<> | 
					
						
							|  |  |  | struct JsonArraySerializer<void> { | 
					
						
							|  |  |  |     template<typename Builder> | 
					
						
							|  |  |  |     static ErrorOr<JsonArraySerializer<Builder>> try_create(Builder& builder) | 
					
						
							|  |  |  |     { | 
					
						
							|  |  |  |         return JsonArraySerializer<Builder>::try_create(builder); | 
					
						
							|  |  |  |     } | 
					
						
							|  |  |  | }; | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  | } | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2022-11-26 12:18:30 +01:00
										 |  |  | #if USING_AK_GLOBALLY
 | 
					
						
							| 
									
										
										
										
											2019-08-27 14:12:44 +03:00
										 |  |  | using AK::JsonArraySerializer; | 
					
						
							| 
									
										
										
										
											2022-11-26 12:18:30 +01:00
										 |  |  | #endif
 |