Configure options / Documentation.

Author: eben-roux

README.md

@@ -8,39 +8,40 @@ The `Shuttle.Core.Serialization` package provides a consistent interface for ser
 dotnet add package Shuttle.Core.Serialization
 ```
 
-## Interface
+## `ISerializer` interface
 
 The core of the library is the `ISerializer` interface:
 
 ```csharp
 public interface ISerializer
 {
     string Name { get; }
-    Task<Stream> SerializeAsync(object instance, CancellationToken cancellationToken = default);
     Task<object> DeserializeAsync(Type type, Stream stream, CancellationToken cancellationToken = default);
+    Task<Stream> SerializeAsync(object instance, CancellationToken cancellationToken = default);
 }
 ```
 
 The following implementation is provided:
 
 - `JsonSerializer`: uses `System.Text.Json` for serialization.
+- `SerializerService`: used to manage multiple `ISerializer` instances.
 
 ## Usage
 
-### AddJsonSerializer
+### `AddJsonSerializer`
 
 To register the `JsonSerializer`, use the `AddJsonSerializer` extension method on `IServiceCollection`:
 
 ```csharp
-services.AddJsonSerializer(builder => 
+services.AddJsonSerializer(options => 
 {
-    builder.Options.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
+    options.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
 });
 ```
 
-The `builder.Options` is of type [JsonSerializerOptions](https://docs.microsoft.com/en-us/dotnet/api/system.text.json.jsonserializeroptions?view=net-6.0).
+The `options` is of type [JsonSerializerOptions](https://docs.microsoft.com/en-us/dotnet/api/system.text.json.jsonserializeroptions?view=net-6.0).
 
-### ISerializerService
+### `ISerializerService`
 
 The `ISerializerService` can be used to manage multiple serializers:
 
@@ -69,23 +70,23 @@ if (serializerService.Contains("Json"))
 
 ## Methods
 
-### SerializeAsync
+### `SerializeAsync`
 
 ```csharp
 Task<Stream> SerializeAsync(object instance, CancellationToken cancellationToken = default);
 ```
 
 Returns the `object` as a `Stream`.
 
-### DeserializeAsync
+### `DeserializeAsync`
 
 ```csharp
 Task<object> DeserializeAsync(Type type, Stream stream, CancellationToken cancellationToken = default);
 ```
 
 Deserializes the `Stream` into an `object` of the given `Type`.
 
-### DeserializeAsync&lt;T&gt; (Extension method)
+### `DeserializeAsync<T>` (Extension method)
 
 ```csharp
 Task<T> DeserializeAsync<T>(Stream stream, CancellationToken cancellationToken = default);

Shuttle.Core.Serialization/Json/JsonSerializerBuilder.cs

@@ -1,58 +1,28 @@
 using System.Text.Json;
 using Microsoft.Extensions.DependencyInjection;
-using Shuttle.Core.Contract;
 
 namespace Shuttle.Core.Serialization;
 
 public static class ServiceCollectionExtensions
 {
     extension(IServiceCollection services)
     {
-        public IServiceCollection AddJsonSerializer(Action<JsonSerializerBuilder>? builder = null)
+        public IServiceCollection AddJsonSerializer()
         {
-            Guard.AgainstNull(services);
-
-            var jsonSerializerBuilder = new JsonSerializerBuilder(services);
-
-            builder?.Invoke(jsonSerializerBuilder);
+            ArgumentNullException.ThrowIfNull(services);
 
             services.AddSingleton<ISerializer, JsonSerializer>();
 
-            services.Configure<JsonSerializerOptions>(options =>
-            {
-                options.AllowDuplicateProperties = jsonSerializerBuilder.Options.AllowDuplicateProperties;
-                options.AllowOutOfOrderMetadataProperties = jsonSerializerBuilder.Options.AllowOutOfOrderMetadataProperties;
-                options.AllowTrailingCommas = jsonSerializerBuilder.Options.AllowTrailingCommas;
-                options.PropertyNamingPolicy = jsonSerializerBuilder.Options.PropertyNamingPolicy;
-                options.PropertyNameCaseInsensitive = jsonSerializerBuilder.Options.PropertyNameCaseInsensitive;
-                options.DictionaryKeyPolicy = jsonSerializerBuilder.Options.DictionaryKeyPolicy;
-                options.DefaultIgnoreCondition = jsonSerializerBuilder.Options.DefaultIgnoreCondition;
-                options.IgnoreReadOnlyProperties = jsonSerializerBuilder.Options.IgnoreReadOnlyProperties;
-                options.IgnoreReadOnlyFields = jsonSerializerBuilder.Options.IgnoreReadOnlyFields;
-                options.IncludeFields = jsonSerializerBuilder.Options.IncludeFields;
-                options.NumberHandling = jsonSerializerBuilder.Options.NumberHandling;
-                options.UnknownTypeHandling = jsonSerializerBuilder.Options.UnknownTypeHandling;
-                options.UnmappedMemberHandling = jsonSerializerBuilder.Options.UnmappedMemberHandling;
-                options.PreferredObjectCreationHandling = jsonSerializerBuilder.Options.PreferredObjectCreationHandling;
-                options.RespectNullableAnnotations = jsonSerializerBuilder.Options.RespectNullableAnnotations;
-                options.RespectRequiredConstructorParameters = jsonSerializerBuilder.Options.RespectRequiredConstructorParameters;
-                options.ReadCommentHandling = jsonSerializerBuilder.Options.ReadCommentHandling;
-                options.MaxDepth = jsonSerializerBuilder.Options.MaxDepth;
-                options.WriteIndented = jsonSerializerBuilder.Options.WriteIndented;
-                options.IndentCharacter = jsonSerializerBuilder.Options.IndentCharacter;
-                options.IndentSize = jsonSerializerBuilder.Options.IndentSize;
-                options.NewLine = jsonSerializerBuilder.Options.NewLine;
-                options.Encoder = jsonSerializerBuilder.Options.Encoder;
-                options.DefaultBufferSize = jsonSerializerBuilder.Options.DefaultBufferSize;
-                options.ReferenceHandler = jsonSerializerBuilder.Options.ReferenceHandler;
+            return services;
+        }
 
-                foreach (var converter in jsonSerializerBuilder.Options.Converters)
-                {
-                    options.Converters.Add(converter);
-                }
+        public IServiceCollection AddJsonSerializer(Action<JsonSerializerOptions> configureOptions)
+        {
+            ArgumentNullException.ThrowIfNull(services);
+            ArgumentNullException.ThrowIfNull(configureOptions);
 
-                options.TypeInfoResolver = jsonSerializerBuilder.Options.TypeInfoResolver;
-            });
+            services.AddJsonSerializer();
+            services.Configure(configureOptions);
 
             return services;
         }