[Doc] Doc & Changedlog updated

Author: JeremyBP

Apizr/Docs/Apizr.Docs/api/.manifest

@@ -183,8 +183,8 @@
   "Apizr.Caching.Attributes.CacheAttributeBase.ShouldInvalidateOnError": "Apizr.Caching.Attributes.CacheAttributeBase.yml",
   "Apizr.Caching.Attributes.CacheKeyAttribute": "Apizr.Caching.Attributes.CacheKeyAttribute.yml",
   "Apizr.Caching.Attributes.CacheKeyAttribute.#ctor": "Apizr.Caching.Attributes.CacheKeyAttribute.yml",
-  "Apizr.Caching.Attributes.CacheKeyAttribute.#ctor(System.String)": "Apizr.Caching.Attributes.CacheKeyAttribute.yml",
-  "Apizr.Caching.Attributes.CacheKeyAttribute.PropertyName": "Apizr.Caching.Attributes.CacheKeyAttribute.yml",
+  "Apizr.Caching.Attributes.CacheKeyAttribute.#ctor(System.String[])": "Apizr.Caching.Attributes.CacheKeyAttribute.yml",
+  "Apizr.Caching.Attributes.CacheKeyAttribute.PropertyNames": "Apizr.Caching.Attributes.CacheKeyAttribute.yml",
   "Apizr.Caching.Attributes.CacheReadAllAttribute": "Apizr.Caching.Attributes.CacheReadAllAttribute.yml",
   "Apizr.Caching.Attributes.CacheReadAllAttribute.#ctor": "Apizr.Caching.Attributes.CacheReadAllAttribute.yml",
   "Apizr.Caching.Attributes.CacheReadAllAttribute.#ctor(Apizr.Caching.CacheMode)": "Apizr.Caching.Attributes.CacheReadAllAttribute.yml",

Apizr/Docs/Apizr.Docs/api/Apizr.Caching.Attributes.CacheKeyAttribute.yml

@@ -6,8 +6,8 @@ items:
   parent: Apizr.Caching.Attributes
   children:
   - Apizr.Caching.Attributes.CacheKeyAttribute.#ctor
-  - Apizr.Caching.Attributes.CacheKeyAttribute.#ctor(System.String)
-  - Apizr.Caching.Attributes.CacheKeyAttribute.PropertyName
+  - Apizr.Caching.Attributes.CacheKeyAttribute.#ctor(System.String[])
+  - Apizr.Caching.Attributes.CacheKeyAttribute.PropertyNames
   langs:
   - csharp
   - vb
@@ -26,7 +26,7 @@ items:
   assemblies:
   - Apizr
   namespace: Apizr.Caching.Attributes
-  summary: Tells Apizr the key to cache value at
+  summary: The decorated parameter will be used as cache key
   example: []
   syntax:
     content: >-
@@ -111,7 +111,7 @@ items:
   assemblies:
   - Apizr
   namespace: Apizr.Caching.Attributes
-  summary: The decorated parameter will be used as cache key (should be primitive otherwise ToString() method will be used, unless providing a property name)
+  summary: The decorated parameter will be used as cache key
   example: []
   syntax:
     content: public CacheKeyAttribute()
@@ -120,16 +120,16 @@ items:
   nameWithType.vb: CacheKeyAttribute.New()
   fullName.vb: Apizr.Caching.Attributes.CacheKeyAttribute.New()
   name.vb: New()
-- uid: Apizr.Caching.Attributes.CacheKeyAttribute.#ctor(System.String)
-  commentId: M:Apizr.Caching.Attributes.CacheKeyAttribute.#ctor(System.String)
-  id: '#ctor(System.String)'
+- uid: Apizr.Caching.Attributes.CacheKeyAttribute.#ctor(System.String[])
+  commentId: M:Apizr.Caching.Attributes.CacheKeyAttribute.#ctor(System.String[])
+  id: '#ctor(System.String[])'
   parent: Apizr.Caching.Attributes.CacheKeyAttribute
   langs:
   - csharp
   - vb
-  name: CacheKeyAttribute(string)
-  nameWithType: CacheKeyAttribute.CacheKeyAttribute(string)
-  fullName: Apizr.Caching.Attributes.CacheKeyAttribute.CacheKeyAttribute(string)
+  name: CacheKeyAttribute(params string[])
+  nameWithType: CacheKeyAttribute.CacheKeyAttribute(params string[])
+  fullName: Apizr.Caching.Attributes.CacheKeyAttribute.CacheKeyAttribute(params string[])
   type: Constructor
   source:
     remote:
@@ -138,57 +138,59 @@ items:
       repo: https://github.com/Respawnsive/Apizr.git
     id: .ctor
     path: ../../Src/Apizr/Caching/Attributes/CacheKeyAttribute.cs
-    startLine: 23
+    startLine: 24
   assemblies:
   - Apizr
   namespace: Apizr.Caching.Attributes
   summary: >-
-    If you use non primitive type (like your ModelClass object) as Cache Primary key you should provide 
+    If you decorate a complex type as cache key, you may want to provide 
 
-    property name of primitive primary Id, otherwise ToString() method will be used.
+    its properties to include by name or to override its ToString() method.
+
+    Otherwise, Apizr will take all its non-null properties.
   example: []
   syntax:
-    content: public CacheKeyAttribute(string propertyName)
+    content: public CacheKeyAttribute(params string[] propertyNames)
     parameters:
-    - id: propertyName
-      type: System.String
-      description: Property name.
-    content.vb: Public Sub New(propertyName As String)
+    - id: propertyNames
+      type: System.String[]
+      description: 'Properties to include as cache key (default: all non-null properties).'
+    content.vb: Public Sub New(ParamArray propertyNames As String())
   overload: Apizr.Caching.Attributes.CacheKeyAttribute.#ctor*
-  nameWithType.vb: CacheKeyAttribute.New(String)
-  fullName.vb: Apizr.Caching.Attributes.CacheKeyAttribute.New(String)
-  name.vb: New(String)
-- uid: Apizr.Caching.Attributes.CacheKeyAttribute.PropertyName
-  commentId: P:Apizr.Caching.Attributes.CacheKeyAttribute.PropertyName
-  id: PropertyName
+  nameWithType.vb: CacheKeyAttribute.New(ParamArray String())
+  fullName.vb: Apizr.Caching.Attributes.CacheKeyAttribute.New(ParamArray String())
+  name.vb: New(ParamArray String())
+- uid: Apizr.Caching.Attributes.CacheKeyAttribute.PropertyNames
+  commentId: P:Apizr.Caching.Attributes.CacheKeyAttribute.PropertyNames
+  id: PropertyNames
   parent: Apizr.Caching.Attributes.CacheKeyAttribute
   langs:
   - csharp
   - vb
-  name: PropertyName
-  nameWithType: CacheKeyAttribute.PropertyName
-  fullName: Apizr.Caching.Attributes.CacheKeyAttribute.PropertyName
+  name: PropertyNames
+  nameWithType: CacheKeyAttribute.PropertyNames
+  fullName: Apizr.Caching.Attributes.CacheKeyAttribute.PropertyNames
   type: Property
   source:
     remote:
       path: Apizr/Src/Apizr/Caching/Attributes/CacheKeyAttribute.cs
       branch: dev
       repo: https://github.com/Respawnsive/Apizr.git
-    id: PropertyName
+    id: PropertyNames
     path: ../../Src/Apizr/Caching/Attributes/CacheKeyAttribute.cs
-    startLine: 31
+    startLine: 32
   assemblies:
   - Apizr
   namespace: Apizr.Caching.Attributes
-  summary: Property name of primitive primary Id
+  summary: 'Properties of to include as cache key (default: all non-null properties).'
   example: []
   syntax:
-    content: public string PropertyName { get; }
+    content: public string[] PropertyNames { get; }
     parameters: []
     return:
-      type: System.String
-    content.vb: Public ReadOnly Property PropertyName As String
-  overload: Apizr.Caching.Attributes.CacheKeyAttribute.PropertyName*
+      type: System.String[]
+    content.vb: Public ReadOnly Property PropertyNames As String()
+  overload: Apizr.Caching.Attributes.CacheKeyAttribute.PropertyNames*
 references:
 - uid: Apizr.Caching.Attributes
   commentId: N:Apizr.Caching.Attributes
@@ -2023,20 +2025,32 @@ references:
   nameWithType.vb: CacheKeyAttribute.New
   fullName.vb: Apizr.Caching.Attributes.CacheKeyAttribute.New
   name.vb: New
-- uid: System.String
-  commentId: T:System.String
-  parent: System
+- uid: System.String[]
   isExternal: true
   href: https://learn.microsoft.com/dotnet/api/system.string
-  name: string
-  nameWithType: string
-  fullName: string
-  nameWithType.vb: String
-  fullName.vb: String
-  name.vb: String
-- uid: Apizr.Caching.Attributes.CacheKeyAttribute.PropertyName*
-  commentId: Overload:Apizr.Caching.Attributes.CacheKeyAttribute.PropertyName
-  href: Apizr.Caching.Attributes.CacheKeyAttribute.html#Apizr_Caching_Attributes_CacheKeyAttribute_PropertyName
-  name: PropertyName
-  nameWithType: CacheKeyAttribute.PropertyName
-  fullName: Apizr.Caching.Attributes.CacheKeyAttribute.PropertyName
+  name: string[]
+  nameWithType: string[]
+  fullName: string[]
+  nameWithType.vb: String()
+  fullName.vb: String()
+  name.vb: String()
+  spec.csharp:
+  - uid: System.String
+    name: string
+    isExternal: true
+    href: https://learn.microsoft.com/dotnet/api/system.string
+  - name: '['
+  - name: ']'
+  spec.vb:
+  - uid: System.String
+    name: String
+    isExternal: true
+    href: https://learn.microsoft.com/dotnet/api/system.string
+  - name: (
+  - name: )
+- uid: Apizr.Caching.Attributes.CacheKeyAttribute.PropertyNames*
+  commentId: Overload:Apizr.Caching.Attributes.CacheKeyAttribute.PropertyNames
+  href: Apizr.Caching.Attributes.CacheKeyAttribute.html#Apizr_Caching_Attributes_CacheKeyAttribute_PropertyNames
+  name: PropertyNames
+  nameWithType: CacheKeyAttribute.PropertyNames
+  fullName: Apizr.Caching.Attributes.CacheKeyAttribute.PropertyNames

Apizr/Docs/Apizr.Docs/articles/config_datacaching.md

@@ -254,7 +254,7 @@ Back to the example, we are saying:
 
 #### CacheKey attribute
 
-By default, Apizr will use all the method parameters (name and value) to generate a cache key (excepting property parameters, neither cancellation token parameters).
+By default, Apizr will use all the method parameters (name and value) to generate a cache key (excepting property parameters, neither cancellation token).
 But you may want to define your own cache key, choosing by yourself which parameter to include and which not. 
 That's what the `CacheKey` attribute is made for.
 You can decorate one or more parameters with it, then it will be included in the cache key generation:
@@ -270,8 +270,64 @@ namespace Apizr.Sample
 }
 ```
 
-Cache key generation supports complex type parameters, so you can group your parameters into a single one to include them all.
-If you don't want them all included, but few of it, you can either provide property names to include within the CacheKey attribute constructor, or get the full control by overriding its ToString() method.
+Cache key generation supports complex type parameters, so you can group your parameters into a single one to include them all as cache key:
+```csharp
+public record GetUserParams
+{
+    [AliasAs("userId")]
+    public int UserId { get; init; }
+
+    [AliasAs("organizationId")]
+    public int OrganizationId { get; init; }
+
+    [AliasAs("serviceName")]
+    public string ServiceName { get; init; }
+}
+
+namespace Apizr.Sample
+{
+    [BaseAddress("https://reqres.in/api")]
+    public interface IReqResService
+    {
+        [Get("/users/{userId}"), Cache(CacheMode.GetOrFetch, "1.00:00:00")]
+        Task<UserDetails> GetUserAsync([Query, CacheKey] GetUserParams parameters);
+    }
+}
+```
+
+If you don't want them all included but few of it, you can provide properties to include by name within the CacheKey attribute constructor:
+```csharp
+namespace Apizr.Sample
+{
+    [BaseAddress("https://reqres.in/api")]
+    public interface IReqResService
+    {
+        [Get("/users/{userId}"), Cache(CacheMode.GetOrFetch, "1.00:00:00")]
+        Task<UserDetails> GetUserAsync([Query, CacheKey("UserId", "ServiceName")] GetUserParams parameters);
+    }
+}
+```
+
+Finally, if you want to get the full control of complex type's cache key formatting, you can still override its ToString() method:
+```csharp
+public record GetUserParams
+{
+    [AliasAs("userId")]
+    public int UserId { get; init; }
+
+    [AliasAs("organizationId")]
+    public int OrganizationId { get; init; }
+
+    [AliasAs("serviceName")]
+    public string ServiceName { get; init; }
+
+    public override string ToString()
+    {
+        // Some custom cache key formatting
+        return $"UserId: {UserId}";
+    }
+}
+```
 
 #### Fluent configuration
 

Apizr/Docs/Apizr.Docs/changelog.md

@@ -1,3 +1,19 @@
+6.3.0
+---
+
+### All
+
+- [New][Exceptions] Now we can **catch exceptions with a Func callback returning a Task of a handled boolean flag** thanks to `WithExCatching` fluent option
+- [New][Exceptions] Now we can **catch exceptions by providing a custom exception handler implementing `IApizrExceptionHandler`** thanks to `WithExCatching` fluent option
+- [New][ConfigureAwait] Now we can **adjust Http handlers task awaiting configuration** thanks to `ContinueOnCapturedContext` fluent option
+- [New][CacheKey] Now we can **choose multiple complex type's properties to be included in cache key** computation
+- [Fix][CacheKey] Now **providing a property name to the CacheKey attribute actually includes the property in cache key** computation as expected
+ 
+### Apizr.Extensions.Microsoft.DependencyInjection
+
+- [New][Exceptions] Now we can **catch exceptions with a Func callback providing IServiceProvider and returning a Task of a handled boolean flag** thanks to `WithExCatching` fluent option
+- [New][Exceptions] Now we can **catch exceptions by resolving a custom exception handler implementing `IApizrExceptionHandler`** thanks to `WithExCatching` fluent option
+ 
 6.2.0
 ---
 

Apizr/Samples/Apizr.Sample.MAUI/appsettings.json

@@ -39,7 +39,7 @@
         "ShouldInvalidateOnError": false
       }
     },
-    "IReqResService": {
+    "IReqResUserService": {
       "Caching": {
         "Mode": "FetchOrGet",
         "LifeSpan": "00:12:00",
@@ -49,6 +49,20 @@
         "HttpGet": [ "TestPipeline3" ]
       }
     },
+    "IReqResSimpleService": {
+      "BaseAddress": "https://reqres.in/api",
+      "RequestTimeout": "00:00:03",
+      "Headers": [
+        "testSettingsKey2: testSettingsValue2.1",
+        "testSettingsKey3: *testSettingsValue3.1*",
+        "testSettingsKey4: {0}",
+        "testSettingsKey5: *{0}*"
+      ],
+      "ResiliencePipelineOptions": {
+        "HttpGet": [ "TestPipeline3" ]
+      }
+      //"ResiliencePipelineKeys": [ "TestPipeline3" ]
+    },
     "IHttpBinService": {
       "BaseAddress": "https://httpbin.org",
       "RequestTimeout": "00:00:04",

Apizr/Src/Apizr/Apizr.xml

@@ -1,3 +1,19 @@
+6.3.0
+---
+
+### All
+
+- [New][Exceptions] Now we can **catch exceptions with a Func callback returning a Task of a handled boolean flag** thanks to `WithExCatching` fluent option
+- [New][Exceptions] Now we can **catch exceptions by providing a custom exception handler implementing `IApizrExceptionHandler`** thanks to `WithExCatching` fluent option
+- [New][ConfigureAwait] Now we can **adjust Http handlers task awaiting configuration** thanks to `ContinueOnCapturedContext` fluent option
+- [New][CacheKey] Now we can **choose multiple complex type's properties to be included in cache key** computation
+- [Fix][CacheKey] Now **providing a property name to the CacheKey attribute actually includes the property in cache key** computation as expected
+ 
+### Apizr.Extensions.Microsoft.DependencyInjection
+
+- [New][Exceptions] Now we can **catch exceptions with a Func callback providing IServiceProvider and returning a Task of a handled boolean flag** thanks to `WithExCatching` fluent option
+- [New][Exceptions] Now we can **catch exceptions by resolving a custom exception handler implementing `IApizrExceptionHandler`** thanks to `WithExCatching` fluent option
+
 6.2.0
 ---