v3.31.0 (#136)

* `JsonMergePatch` enhancements.

* - *Enhancement:* Refactored the `CosmosDb` capabilities such that the `CosmosDbContainer` and `CosmosDbModelContainer` are model type independent, with underlying type support implemented at the method level for greater flexibility and control. The typed `CosmosDbContainer<T, TModel>` etc. remain and are accessed from the type independent containers as required.
  - The existing `IMultiSetArgs` operations have been moved (and renamed) from `CosmosDb` to `CosmosDbContainer` and `CosmosDbModelContainer` as these are single container-specific.
  - The existing `CosmosDb.UseAuthorizeFilter` operations have been moved to `CosmosDbContainer` as these are single container-specific.

* - *Enhancement:* Added `Cleaner.PrepareCreate` and `Cleaner.PrepareUpdate` to encapsulate `ChangeLog.PrepareCreated` and `ChangeLog.PrepareUpdated`, and `Cleaner.ResetTenantId` to ensure consistent handling throughout _CoreEx_.
- *Enhancement:* Added `SystemTime.Timestamp` as the standard means to access the current timestamp (uses `Cleaner.Clean`) to ensure consistency throughout _CoreEx_. Therefore, the likes of `DateTime.UtcNow` should be replaced with `SystemTime.Timestamp`. The previous `ExecutionContent.SystemTime` has been removed as it was not consistent with the `ExecutionContext` pattern.

* - *Enhancement:* Updated the `IExtendedException.ShouldBeLogged` implementations to check `SettingsBase` configuration to enable/disable.

* - Simply CosmosDB configuration; removes need for lazy instantiation
- Update packages

* ICU fix?

* ICU again?

* ICU again?

* ICU again?

* ICU again

* ICU again?

* ICU again?

* ICU again?

* ICU again?

* ICU again?

Author: chullybun

.github/workflows/CI.yml

@@ -40,7 +40,6 @@ jobs:
       uses: actions/setup-dotnet@v1
       with:
         dotnet-version: | 
-          3.1.x
           6.0.x
           8.0.x
           9.0.x

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 Represents the **NuGet** versions.
 
+## v3.31.0
+- *Enhancement:* Moved existing reflection-based `JsonMergePatch` to `Extended.JsonMergePatchEx`; this remains the `AddJsonMergePatch` default implementation.
+- *Enhancement:* Added new `JsonMergePatch` that leverages `JsonElement` and `Utf8JsonWriter` without underlying reflection; useful in scenarios where the value type is not known. This is also not as performant as the reflection-based `JsonMergePatchEx` version and the primary reason why it is not the new default.
+- *Enhancement:* Refactored the `CosmosDb` capabilities such that the `CosmosDbContainer` and `CosmosDbModelContainer` are model type independent, with underlying type support implemented at the method level for greater flexibility and control. The typed `CosmosDbContainer<T, TModel>` etc. remain and are accessed from the type independent containers as required.
+  - The existing `IMultiSetArgs` operations have been moved (and renamed) from `CosmosDb` to `CosmosDbContainer` and `CosmosDbModelContainer` as these are single container-specific.
+  - The existing `CosmosDb.UseAuthorizeFilter` operations have been moved to `CosmosDbContainer` as these are single container-specific.
+- *Enhancement:* Added `Cleaner.PrepareCreate` and `Cleaner.PrepareUpdate` to encapsulate `ChangeLog.PrepareCreated` and `ChangeLog.PrepareUpdated`, and `Cleaner.ResetTenantId` to ensure consistent handling throughout _CoreEx_.
+- *Enhancement:* Added `SystemTime.Timestamp` as the standard means to access the current timestamp (uses `Cleaner.Clean`) to ensure consistency throughout _CoreEx_. Therefore, the likes of `DateTime.UtcNow` should be replaced with `SystemTime.Timestamp`. The previous `ExecutionContent.SystemTime` has been removed as it was not consistent with the `ExecutionContext` pattern.
+- *Enhancement:* Updated the `IExtendedException.ShouldBeLogged` implementations to check `SettingsBase` configuration to enable/disable.
+- *Enhancement:* Updated dependencies to latest; including transitive where applicable.
+
 ## v3.30.2
 - *Fixed:* Missing `QueryArgs.IncludeText` added to set the `$text=true` equivalent.
 - *Fixed:* Simplification of creating and setting the `QueryArgs.Filter` using an implict string operator.

Common.targets

@@ -1,6 +1,6 @@
 <Project>
 	<PropertyGroup>
-		<Version>3.30.2</Version>
+		<Version>3.31.0</Version>
 		<LangVersion>preview</LangVersion>
 		<Authors>Avanade</Authors>
 		<Company>Avanade</Company>

samples/My.Hr/My.Hr.Api/Startup.cs

@@ -8,6 +8,7 @@
 using CoreEx.Azure.ServiceBus.HealthChecks;
 using Azure.Messaging.ServiceBus;
 using Microsoft.Extensions.DependencyInjection;
+using CoreEx.Json.Merge;
 
 namespace My.Hr.Api;
 
@@ -34,7 +35,7 @@ public void ConfigureServices(IServiceCollection services)
             .AddAzureServiceBusSender()
             .AddAzureServiceBusPurger()
             .AddJsonMergePatch()
-            .AddWebApi((_, webapi) => webapi.UnhandledExceptionAsync = (ex, _, _) => Task.FromResult(ex is DbUpdateConcurrencyException efex ? webapi.CreateActionResultFromExtendedException(new ConcurrencyException()) : null))
+            .AddWebApi((_, webapi) => webapi.UnhandledExceptionAsync = (ex, logger, _) => Task.FromResult(ex is DbUpdateConcurrencyException efex ? webapi.CreateActionResultFromExtendedException(new ConcurrencyException(null, ex), logger) : null))
             .AddReferenceDataContentWebApi()
             .AddRequestCache();
 

samples/My.Hr/My.Hr.Api/appsettings.json

@@ -15,7 +15,8 @@
         "AbsoluteExpirationRelativeToNow": "03:00:00",
         "SlidingExpiration": "00:45:00"
       }
-    }
+    },
+    "LogConcurrencyException": true
   },
   "ServiceBusConnection": {
     "fullyQualifiedNamespace": "Endpoint=sb://top-secret.servicebus.windows.net/;SharedAccessKeyName=top-secret;SharedAccessKey=top-encrypted-secret"

samples/My.Hr/My.Hr.Business/Data/Employee2Configuration.cs

@@ -0,0 +1,22 @@
+namespace My.Hr.Business.Data;
+
+public class Employee2Configuration : IEntityTypeConfiguration<Employee2>
+{
+    public void Configure(EntityTypeBuilder<Employee2> builder)
+    {
+        builder.ToTable("Employee2", "Hr");
+        builder.Property(p => p.Id).HasColumnName("EmployeeId").HasColumnType("UNIQUEIDENTIFIER");
+        builder.Property(p => p.Email).HasColumnType("NVARCHAR(250)");
+        builder.Property(p => p.FirstName).HasColumnType("NVARCHAR(100)");
+        builder.Property(p => p.LastName).HasColumnType("NVARCHAR(100)");
+        builder.Property(p => p.Gender).HasColumnName("GenderCode").HasColumnType("NVARCHAR(50)").HasConversion(v => v!.Code, v => (Gender?)v);
+        builder.Property(p => p.Birthday).HasColumnType("DATE");
+        builder.Property(p => p.StartDate).HasColumnType("DATE");
+        builder.Property(p => p.TerminationDate).HasColumnType("DATE");
+        builder.Property(p => p.TerminationReasonCode).HasColumnType("NVARCHAR(50)");
+        builder.Property(p => p.PhoneNo).HasColumnType("NVARCHAR(50)");
+        builder.Property(p => p.ETag).HasColumnName("RowVersion").IsRowVersion().HasConversion(s => s == null ? Array.Empty<byte>() : Convert.FromBase64String(s), d => Convert.ToBase64String(d));
+        builder.Property(p => p.IsDeleted).HasColumnType("BIT");
+        builder.HasKey("Id");
+    }
+}

samples/My.Hr/My.Hr.Business/Data/HrDbContext.cs

@@ -18,7 +18,8 @@ protected override void OnModelCreating(ModelBuilder modelBuilder)
     {
         modelBuilder
             .ApplyConfiguration(new UsStateConfiguration())
-            .ApplyConfiguration(new EmployeeConfiguration());
+            .ApplyConfiguration(new EmployeeConfiguration())
+            .ApplyConfiguration(new Employee2Configuration());
 
         base.OnModelCreating(modelBuilder);
     }

samples/My.Hr/My.Hr.Business/Data/HrEfDb.cs

@@ -9,6 +9,11 @@ public interface IHrEfDb : IEfDb
         /// Gets the <see cref="Employee"/> entity.
         /// </summary>
         EfDbEntity<Employee, Employee> Employees { get; }
+
+        /// <summary>
+        /// Gets the <see cref="Employee2"/> entity.
+        /// </summary>
+        EfDbEntity<Employee2, Employee2> Employees2 { get; }
     }
 
     /// <summary>
@@ -27,5 +32,10 @@ public HrEfDb(HrDbContext dbContext, IMapper mapper) : base(dbContext, mapper) {
         /// Gets the <see cref="Employee"/> encapsulated entity.
         /// </summary>
         public EfDbEntity<Employee, Employee> Employees => new(this);
+
+        /// <summary>
+        /// Gets the <see cref="Employee"/> encapsulated entity.
+        /// </summary>
+        public EfDbEntity<Employee2, Employee2> Employees2 => new(this);
     }
 }

samples/My.Hr/My.Hr.Business/Models/Employee2.cs

@@ -0,0 +1,74 @@
+using System.Diagnostics;
+
+namespace My.Hr.Business.Models;
+
+/// <summary>
+/// Represents the Entity Framework (EF) model for database object 'Hr.Employee2'.
+/// </summary>
+public class Employee2 : IIdentifier<Guid>, IETag, ILogicallyDeleted
+{
+    /// <summary>
+    /// Gets or sets the 'EmployeeId' column value.
+    /// </summary>
+    public Guid Id { get; set; }
+
+    /// <summary>
+    /// Gets or sets the 'Email' column value.
+    /// </summary>
+    public string? Email { get; set; }
+
+    /// <summary>
+    /// Gets or sets the 'FirstName' column value.
+    /// </summary>
+    public string? FirstName { get; set; }
+
+    /// <summary>
+    /// Gets or sets the 'LastName' column value.
+    /// </summary>
+    public string? LastName { get; set; }
+
+    /// <summary>
+    /// Gets or sets the 'GenderCode' column value.
+    /// </summary>
+    [DebuggerBrowsable(DebuggerBrowsableState.Never)]
+    public Gender? Gender { get; set; }
+
+    /// <summary>
+    /// Gets or sets the 'Birthday' column value.
+    /// </summary>
+    public DateTime? Birthday { get; set; }
+
+    /// <summary>
+    /// Gets or sets the 'StartDate' column value.
+    /// </summary>
+    public DateTime? StartDate { get; set; }
+
+    /// <summary>
+    /// Gets or sets the 'TerminationDate' column value.
+    /// </summary>
+    public DateTime? TerminationDate { get; set; }
+
+    /// <summary>
+    /// Gets or sets the 'TerminationReasonCode' column value.
+    /// </summary>
+    public string? TerminationReasonCode { get; set; }
+
+    /// <summary>
+    /// Gets or sets the 'PhoneNo' column value.
+    /// </summary>
+    public string? PhoneNo { get; set; }
+
+    /// <summary>
+    /// Gets or sets the 'RowVersion' column value.
+    /// </summary>
+    public string? ETag { get; set; }
+
+    /// <summary>
+    ///  Gets or sets the 'IsDeleted' column value.
+    /// </summary>
+    public bool? IsDeleted { get; set; }
+}
+
+public class Employee2Collection : List<Employee2> { }
+
+public class Employee2CollectionResult : CollectionResult<Employee2Collection, Employee2> { }

samples/My.Hr/My.Hr.Business/Services/EmployeeResultService.cs

@@ -36,7 +36,7 @@ public Task<Result> VerifyEmployeeAsync(Guid id)  => Result
             var verification = new EmployeeVerificationRequest
             {
                 Name = employee!.FirstName,
-                Age = DateTime.UtcNow.Subtract(employee.Birthday.GetValueOrDefault()).Days / 365,
+                Age = SystemTime.Timestamp.Subtract(employee.Birthday.GetValueOrDefault()).Days / 365,
                 Gender = employee.Gender?.Code
             };