FBM and caching non-breaking updates

1 files changed, 100 insertions, 0 deletions

diff --git a/lib/VNLib.Data.Caching/src/JsonCacheObjectSerializer.cs b/lib/VNLib.Data.Caching/src/JsonCacheObjectSerializer.cs
new file mode 100644
index 0000000..7f52169
--- /dev/null
+++ b/lib/VNLib.Data.Caching/src/JsonCacheObjectSerializer.cs
@@ -0,0 +1,100 @@
+/*
+* Copyright (c) 2023 Vaughn Nugent
+* 
+* Library: VNLib
+* Package: VNLib.Data.Caching
+* File: JsonCacheObjectSerializer.cs 
+*
+* JsonCacheObjectSerializer.cs is part of VNLib.Data.Caching which is part of the larger 
+* VNLib collection of libraries and utilities.
+*
+* VNLib.Data.Caching is free software: you can redistribute it and/or modify 
+* it under the terms of the GNU Affero General Public License as 
+* published by the Free Software Foundation, either version 3 of the
+* License, or (at your option) any later version.
+*
+* VNLib.Data.Caching is distributed in the hope that it will be useful,
+* but WITHOUT ANY WARRANTY; without even the implied warranty of
+* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+* GNU Affero General Public License for more details.
+*
+* You should have received a copy of the GNU Affero General Public License
+* along with this program.  If not, see https://www.gnu.org/licenses/.
+*/
+
+using System;
+using System.Buffers;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+using VNLib.Utils.Memory.Caching;
+
+namespace VNLib.Data.Caching
+{
+    /// <summary>
+    /// Implements a <see cref="ICacheObjectDeserialzer"/> and a <see cref="ICacheObjectSerialzer"/>
+    /// that uses JSON serialization, with writer pooling. Members of this class are thread-safe.
+    /// </summary>
+    public class JsonCacheObjectSerializer : ICacheObjectSerialzer, ICacheObjectDeserialzer
+    {
+        //Create threadlocal writer for attempted lock-free writer reuse
+        private static readonly ObjectRental<ReusableJsonWriter> JsonWriterPool = ObjectRental.CreateThreadLocal<ReusableJsonWriter>();
+
+        private readonly JsonSerializerOptions? _options;
+
+        /// <summary>
+        /// Initializes a new <see cref="JsonCacheObjectSerializer"/>
+        /// </summary>
+        /// <param name="options">JSON serialization/deserialization options</param>
+        public JsonCacheObjectSerializer(JsonSerializerOptions options)
+        {
+            _options = options;
+        }
+
+        /// <summary>
+        /// Initializes a new <see cref="JsonCacheObjectSerializer"/> using 
+        /// the default serialization rules
+        /// </summary>
+        public JsonCacheObjectSerializer()
+        {
+            //Configure default serialzation options
+            _options = new()
+            {
+                DictionaryKeyPolicy = JsonNamingPolicy.CamelCase,
+                NumberHandling = JsonNumberHandling.Strict,
+                ReadCommentHandling = JsonCommentHandling.Disallow,
+                WriteIndented = false,
+                DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull,
+                IgnoreReadOnlyFields = true,
+                PropertyNameCaseInsensitive = true,
+                IncludeFields = false,
+
+                //Use small buffers
+                DefaultBufferSize = 128
+            };
+        }
+
+        ///<inheritdoc/>
+        public virtual object? Deserialze(Type type, ReadOnlySpan<byte> objectData)
+        {
+            return JsonSerializer.Deserialize(objectData, type, _options);
+        }
+
+        ///<inheritdoc/>
+        public virtual void Serialize<T>(T obj, IBufferWriter<byte> finiteWriter)
+        {
+            //Rent new json writer
+            ReusableJsonWriter writer = JsonWriterPool.Rent();
+
+            try
+            {
+                //Serialize the message
+                writer.Serialize(finiteWriter, obj, _options);
+            }
+            finally
+            {
+                JsonWriterPool.Return(writer);
+            }
+        }
+    }
+}