Changes as decribed in the log.

.github/workflows/CI.yml

@@ -308,4 +308,21 @@ jobs:
 
     - name: Template/HttpAgent test
       working-directory: ./Foo.Ha.Bar
-      run: dotnet test 
+      run: dotnet test 
+
+     # Template - Sql Server with Entity Framework and Azure Functions Service
+
+    - name: Template/SqlServer/SpWs create
+      run: dotnet new beef --company Foo.SpWs --appname Bar --datasource SqlServerProcs --output Foo.SpWs.Bar
+
+    - name: Template/SqlServer/SpWs database
+      working-directory: ./Foo.SpWs.Bar/Foo.SpWs.Bar.Database
+      run: dotnet run dropandall --connection-varname Bar_ConnectionStrings__Database --accept-prompts
+
+    - name: Template/SqlServer/SpWs code-gen
+      working-directory: ./Foo.SpWs.Bar/Foo.SpWs.Bar.CodeGen
+      run: dotnet run all
+
+    - name: Template/SqlServer/SpWs test
+      working-directory: ./Foo.SpWs.Bar
+      run: dotnet test

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 Represents the **NuGet** versions.
 
+## v5.11.0
+- *Enhancement:* Added `dotnet new beef ... --services AzFunction` to enable the templating of a corresponding `Company.AppName.Services` project as an Azure Functions project. This will provide an example of leveraging the shared `Company.AppName.Business` logic and consuming the published events using an `EventSubscriberOrchestrator`.
+- *Enhancement:* The `DatabaseMapper` (stored procedures) code-generation logic has been updated to leverage the new extended `DatabaseMapperEx`. This avoids the existing reflection and expression compilation, using explicit code to perform the mapping. Can offer up to 40%+ improvement in some scenarios. Where existing behavior is required then set YAML `databaseMapperEx: false` in the `entity.beef-5.yaml` file (root and/or entity within hierarchy).
+
 ## v5.10.0
 - *Enhancement:* Added [PostgreSQL](https://www.postgresql.org/) database support: 
   - Leverages both `CoreEx.Database.Postgres` (runtime) and `DbEx.Postgres` (migration) packages; encapsulates the `Npgsql` package.

docs/Entity-CodeGeneration-Config.md

@@ -136,7 +136,8 @@ Property | Description
 -|-
 **`databaseName`** | The .NET database interface name (used where `Operation.AutoImplement` is `Database`).<br/>&dagger; Defaults to `IDatabase`. This can be overridden within the `Entity`(s).
 **`databaseSchema`** | The default database schema name.<br/>&dagger; Defaults to `dbo`.
-**`databaseProvider`** | The default database schema name. Valid options are: `SqlServer`, `MySQL`.<br/>&dagger; Defaults to `SqlServer`. Enables specific database provider functionality/formatting/etc. where applicable.
+**`databaseProvider`** | The default database schema name. Valid options are: `SqlServer`, `MySQL`, `Postgres`.<br/>&dagger; Defaults to `SqlServer`. Enables specific database provider functionality/formatting/etc. where applicable.
+`databaseMapperEx` | Indicates that a `DatabaseMapperEx` will be used; versus, `DatabaseMapper` (which uses Reflection internally).<br/>&dagger; Defaults to `true`. The `DatabaseMapperEx` essentially replaces the `DatabaseMapper` as it is more performant (extended/explicit); this option can be used where leagcy/existing behavior is required.
 
 <br/>
 

docs/Entity-Entity-Config.md

@@ -215,6 +215,7 @@ Property | Description
 **`databaseSchema`** | The database schema name (used where `AutoImplement` is `Database`).<br/>&dagger; Defaults to `dbo`.
 `databaseMapperInheritsFrom` | The name of the `Mapper` that the generated Database `Mapper` inherits from.
 `databaseCustomerMapper` | Indicates that a custom Database `Mapper` will be used; i.e. not generated.<br/>&dagger; Otherwise, by default, a `Mapper` will be generated.
+`databaseMapperEx` | Indicates that a `DatabaseMapperEx` (extended/explicit) will be used; versus, `DatabaseMapper` (which uses Reflection internally).<br/>&dagger; Defaults to `CodeGeneration.DatabaseMapperEx` (its default value is `true`). The `DatabaseMapperEx` essentially replaces the `DatabaseMapper` as it is more performant; this option can be used where leagcy/existing behavior is required.
 
 <br/>
 

samples/Cdr.Banking/Cdr.Banking.Api/Cdr.Banking.Api.csproj

@@ -5,7 +5,7 @@
     <ImplicitUsings>true</ImplicitUsings>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="CoreEx.AspNetCore" Version="3.12.0" />
+    <PackageReference Include="CoreEx.AspNetCore" Version="3.13.0" />
     <PackageReference Include="Swashbuckle.AspNetCore.SwaggerGen" Version="6.5.0" />
   </ItemGroup>
   <ItemGroup>

samples/Cdr.Banking/Cdr.Banking.Business/Cdr.Banking.Business.csproj

@@ -11,8 +11,8 @@
     <Folder Include="DataSvc\" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="CoreEx.AspNetCore" Version="3.12.0" />
-    <PackageReference Include="CoreEx.Cosmos" Version="3.12.0" />
-    <PackageReference Include="CoreEx.Validation" Version="3.12.0" />
+    <PackageReference Include="CoreEx.AspNetCore" Version="3.13.0" />
+    <PackageReference Include="CoreEx.Cosmos" Version="3.13.0" />
+    <PackageReference Include="CoreEx.Validation" Version="3.13.0" />
   </ItemGroup>
 </Project>

samples/Cdr.Banking/Cdr.Banking.Common/Cdr.Banking.Common.csproj

@@ -8,6 +8,6 @@
     <Folder Include="Entities\" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="CoreEx" Version="3.12.0" />
+    <PackageReference Include="CoreEx" Version="3.13.0" />
   </ItemGroup>
 </Project>

samples/Cdr.Banking/Cdr.Banking.Test/Cdr.Banking.Test.csproj

@@ -39,7 +39,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.9.0" />
-    <PackageReference Include="CoreEx.UnitTesting.NUnit" Version="3.12.0" />
+    <PackageReference Include="CoreEx.UnitTesting.NUnit" Version="3.13.0" />
   </ItemGroup>
 
   <ItemGroup>

samples/Demo/Beef.Demo.Api/Beef.Demo.Api.csproj

@@ -12,7 +12,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="CoreEx.AspNetCore" Version="3.12.0" />
+    <PackageReference Include="CoreEx.AspNetCore" Version="3.13.0" />
     <PackageReference Include="Swashbuckle.AspNetCore" Version="6.5.0" />
     <PackageReference Include="Swashbuckle.AspNetCore.Newtonsoft" Version="6.5.0" />
   </ItemGroup>

samples/Demo/Beef.Demo.Api/Controllers/Generated/PersonController.cs

@@ -385,6 +385,17 @@ public Task<IActionResult> PatchWithEf(Guid id)
     [ProducesResponseType((int)HttpStatusCode.NoContent)]
     public Task<IActionResult> GetDocumentation(Guid id)
         => _webApi.GetAsync<FileContentResult>(Request, p => _manager.GetDocumentationAsync(id), alternateStatusCode: HttpStatusCode.NoContent, operationType: CoreEx.OperationType.Unspecified);
+
+    /// <summary>
+    /// Simulate Work.
+    /// </summary>
+    /// <param name="id">The <see cref="Person"/> identifier.</param>
+    /// <returns>A resultant <see cref="string"/>.</returns>
+    [HttpGet("api/v1/persons/simulate")]
+    [ProducesResponseType(typeof(string), (int)HttpStatusCode.OK)]
+    [ProducesResponseType((int)HttpStatusCode.NoContent)]
+    public Task<IActionResult> SimulateWork(Guid id)
+        => _webApi.GetWithResultAsync<string?>(Request, p => _manager.SimulateWorkAsync(id), alternateStatusCode: HttpStatusCode.NoContent, operationType: CoreEx.OperationType.Unspecified);
 }
 
 #pragma warning restore

samples/Demo/Beef.Demo.Business/Beef.Demo.Business.csproj

@@ -15,14 +15,14 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="CoreEx" Version="3.12.0" />
-    <PackageReference Include="CoreEx.AspNetCore" Version="3.12.0" />
-    <PackageReference Include="CoreEx.Cosmos" Version="3.12.0" />
-    <PackageReference Include="CoreEx.Database" Version="3.12.0" />
-    <PackageReference Include="CoreEx.Database.SqlServer" Version="3.12.0" />
-    <PackageReference Include="CoreEx.EntityFrameworkCore" Version="3.12.0" />
-    <PackageReference Include="CoreEx.Validation" Version="3.12.0" />
-    <PackageReference Include="CoreEx.FluentValidation" Version="3.12.0" />
+    <PackageReference Include="CoreEx" Version="3.13.0" />
+    <PackageReference Include="CoreEx.AspNetCore" Version="3.13.0" />
+    <PackageReference Include="CoreEx.Cosmos" Version="3.13.0" />
+    <PackageReference Include="CoreEx.Database" Version="3.13.0" />
+    <PackageReference Include="CoreEx.Database.SqlServer" Version="3.13.0" />
+    <PackageReference Include="CoreEx.EntityFrameworkCore" Version="3.13.0" />
+    <PackageReference Include="CoreEx.Validation" Version="3.13.0" />
+    <PackageReference Include="CoreEx.FluentValidation" Version="3.13.0" />
     <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="6.0.20" />
   </ItemGroup>
 

samples/Demo/Beef.Demo.Business/Data/Generated/AddressData.cs

@@ -16,19 +16,26 @@ public partial class AddressData
     /// <summary>
     /// Provides the <see cref="Address"/> property and database column mapping.
     /// </summary>
-    public partial class DbMapper : DatabaseMapper<Address, DbMapper>
+    public partial class DbMapper : DatabaseMapperEx<Address, DbMapper>
     {
-        /// <summary>
-        /// Initializes a new instance of the <see cref="DbMapper"/> class.
-        /// </summary>
-        public DbMapper()
+        /// <inheritdoc />
+        protected override void OnMapToDb(Address value, DatabaseParameterCollection parameters, OperationTypes operationType)
+        {
+            parameters.AddParameter("Street", value.Street);
+            parameters.AddParameter("City", value.City);
+            OnMapToDbEx(value, parameters, operationType);
+        }
+
+        /// <inheritdoc />
+        protected override void OnMapFromDb(DatabaseRecord record, Address value, OperationTypes operationType)
         {
-            Property(s => s.Street);
-            Property(s => s.City);
-            DbMapperCtor();
+            value.Street = record.GetValue<string?>("Street");
+            value.City = record.GetValue<string?>("City");
+            OnMapFromDbEx(record, value, operationType);
         }
-
-        partial void DbMapperCtor(); // Enables the DbMapper constructor to be extended.
+
+        partial void OnMapToDbEx(Address value, DatabaseParameterCollection parameters, OperationTypes operationType); // Enables the DbMapper.OnMapToDb to be extended.
+        partial void OnMapFromDbEx(DatabaseRecord record, Address value, OperationTypes operationType); // Enables the DbMapper.OnMapFromDb to be extended.
     }
 
     /// <summary>

samples/Demo/Beef.Demo.Business/Data/Generated/ContactData.cs

@@ -77,7 +77,7 @@ public EntityToModelEfMapper()
             Map((s, d) => d.FirstName = s.FirstName, OperationTypes.Any, s => s.FirstName == default, d => d.FirstName = default);
             Map((s, d) => d.LastName = s.LastName, OperationTypes.Any, s => s.LastName == default, d => d.LastName = default);
             Map((s, d) => d.StatusCode = s.StatusSid, OperationTypes.Any, s => s.StatusSid == default, d => d.StatusCode = default);
-            Map((s, d) => d.Comms = ObjectToJsonConverter<ContactCommCollection>.Default.ToDestination.Convert(s.Communications), OperationTypes.Any, s => s.Communications == default, d => d.Comms = default);
+            Map((s, d) => d.Comms = ObjectToJsonConverter<ContactCommCollection>.Default.ConvertToDestination(s.Communications), OperationTypes.Any, s => s.Communications == default, d => d.Comms = default);
             EntityToModelEfMapperCtor();
         }
 
@@ -98,7 +98,7 @@ public ModelToEntityEfMapper()
             Map((s, d) => d.FirstName = (string?)s.FirstName!, OperationTypes.Any, s => s.FirstName == default, d => d.FirstName = default);
             Map((s, d) => d.LastName = (string?)s.LastName!, OperationTypes.Any, s => s.LastName == default, d => d.LastName = default);
             Map((s, d) => d.StatusSid = (string?)s.StatusCode!, OperationTypes.Any, s => s.StatusCode == default, d => d.StatusSid = default);
-            Map((s, d) => d.Communications = (ContactCommCollection?)ObjectToJsonConverter<ContactCommCollection>.Default.ToSource.Convert(s.Comms!), OperationTypes.Any, s => s.Comms == default, d => d.Communications = default);
+            Map((s, d) => d.Communications = (ContactCommCollection?)ObjectToJsonConverter<ContactCommCollection>.Default.ConvertToSource(s.Comms!), OperationTypes.Any, s => s.Comms == default, d => d.Communications = default);
             ModelToEntityEfMapperCtor();
         }
 

samples/Demo/Beef.Demo.Business/Data/Generated/GenderData.cs

@@ -38,26 +38,49 @@ public Task<Result<Gender>> UpdateAsync(Gender value)
     /// <summary>
     /// Provides the <see cref="Gender"/> property and database column mapping.
     /// </summary>
-    public partial class DbMapper : DatabaseMapper<Gender, DbMapper>
+    public partial class DbMapper : DatabaseMapperEx<Gender, DbMapper>
     {
-        /// <summary>
-        /// Initializes a new instance of the <see cref="DbMapper"/> class.
-        /// </summary>
-        public DbMapper()
+        /// <inheritdoc />
+        protected override void OnMapToDb(Gender value, DatabaseParameterCollection parameters, OperationTypes operationType)
         {
-            Property(s => s.Id, "GenderId").SetPrimaryKey(true);
-            Property(s => s.Code);
-            Property(s => s.Text);
-            Property(s => s.IsActive);
-            Property(s => s.SortOrder);
-            Property(s => s.AlternateName);
-            Property(s => s.TripCode);
-            Property(s => s.Country, "CountryId").SetConverter(ReferenceDataIdConverter<RefDataNamespace.Country, Guid?>.Default);
-            Property(s => s.ETag, "RowVersion", operationTypes: OperationTypes.AnyExceptCreate).SetConverter(StringToBase64Converter.Default);
-            DbMapperCtor();
+            parameters.AddParameter("GenderId", value.Id).SetDirectionToOutputOnCreate(operationType);
+            parameters.AddParameter("Code", value.Code);
+            parameters.AddParameter("Text", value.Text);
+            parameters.AddParameter("IsActive", value.IsActive);
+            parameters.AddParameter("SortOrder", value.SortOrder);
+            parameters.AddParameter("AlternateName", value.AlternateName);
+            parameters.AddParameter("TripCode", value.TripCode);
+            parameters.AddParameter("CountryId", ReferenceDataIdConverter<RefDataNamespace.Country, Guid?>.Default.ConvertToDestination(value.Country));
+            WhenAnyExceptCreate(operationType, () => parameters.AddParameter(parameters.Database.DatabaseColumns.RowVersionName, StringToBase64Converter.Default.ConvertToDestination(value.ETag)));
+            OnMapToDbEx(value, parameters, operationType);
         }
-
-        partial void DbMapperCtor(); // Enables the DbMapper constructor to be extended.
+
+        /// <inheritdoc />
+        protected override void OnMapFromDb(DatabaseRecord record, Gender value, OperationTypes operationType)
+        {
+            value.Id = record.GetValue<Guid>("GenderId");
+            value.Code = record.GetValue<string?>("Code");
+            value.Text = record.GetValue<string?>("Text");
+            value.IsActive = record.GetValue<bool>("IsActive");
+            value.SortOrder = record.GetValue<int>("SortOrder");
+            value.AlternateName = record.GetValue<string?>("AlternateName");
+            value.TripCode = record.GetValue<string?>("TripCode");
+            value.Country = (RefDataNamespace.Country?)ReferenceDataIdConverter<RefDataNamespace.Country, Guid?>.Default.ConvertToSource(record.GetValue("CountryId"));
+            WhenAnyExceptCreate(operationType, () => value.ETag = (string?)StringToBase64Converter.Default.ConvertToSource(record.GetValue(record.Database.DatabaseColumns.RowVersionName)));
+            OnMapFromDbEx(record, value, operationType);
+        }
+
+        /// <inheritdoc />
+        protected override void OnMapKeyToDb(CompositeKey key, DatabaseParameterCollection parameters)
+        {
+            key.AssertLength(1);
+            parameters.AddParameter("GenderId", key.Args[0]);
+            OnMapKeyToDbEx(key, parameters);
+        }
+
+        partial void OnMapToDbEx(Gender value, DatabaseParameterCollection parameters, OperationTypes operationType); // Enables the DbMapper.OnMapToDb to be extended.
+        partial void OnMapFromDbEx(DatabaseRecord record, Gender value, OperationTypes operationType); // Enables the DbMapper.OnMapFromDb to be extended.
+        partial void OnMapKeyToDbEx(CompositeKey key, DatabaseParameterCollection parameters); // Enables the DbMapper.OnMapKeyToDb to be extended.
     }
 }
 

samples/Demo/Beef.Demo.Business/Data/Generated/IPersonData.cs

@@ -183,6 +183,13 @@ public partial interface IPersonData
     /// <param name="id">The <see cref="Person"/> identifier.</param>
     /// <returns>A resultant <see cref="FileContentResult"/>.</returns>
     Task<FileContentResult> GetDocumentationAsync(Guid id);
+
+    /// <summary>
+    /// Simulate Work.
+    /// </summary>
+    /// <param name="id">The <see cref="Person"/> identifier.</param>
+    /// <returns>A resultant <see cref="string"/>.</returns>
+    Task<Result<string?>> SimulateWorkAsync(Guid id);
 }
 
 #pragma warning restore