Merge branch 'main' into bugfix/hard-version

CHANGELOG.md

@@ -9,6 +9,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [1.4.2] - 2024-05-21
 
+### Added
+
+- `GetDefaultHandlerTypes` added to `KiotaClientFactory` if you're creating your own `HttpClient` and still want to use the default handlers.
+
 ### Changed
 
 - Fixed an issue where fixed versions of abstractions would result in restore failures. [#256](https://github.com/microsoft/kiota-http-dotnet/issues/256)

src/KiotaClientFactory.cs

@@ -28,21 +28,21 @@ public static HttpClient Create(HttpMessageHandler? finalHandler = null)
             var handler = ChainHandlersCollectionAndGetFirstLink(finalHandler ?? GetDefaultHttpMessageHandler(), defaultHandlers.ToArray());
             return handler != null ? new HttpClient(handler) : new HttpClient();
         }
-
-        /// <summary>
-        /// Initializes the <see cref="HttpClient"/> with a custom middleware pipeline.
-        /// </summary>
-        /// <param name="handlers">The <see cref="DelegatingHandler"/> instances to create the <see cref="DelegatingHandler"/> from.</param>
-        /// <param name="finalHandler">The final <see cref="HttpMessageHandler"/> in the http pipeline. Can be configured for proxies, auto-decompression and auto-redirects</param>
-        /// <returns>The <see cref="HttpClient"/> with the custom handlers.</returns>
-        public static HttpClient Create(IList<DelegatingHandler> handlers, HttpMessageHandler? finalHandler = null)
-        {
-            if(handlers == null || !handlers.Any())
-                return Create(finalHandler);
-            var handler = ChainHandlersCollectionAndGetFirstLink(finalHandler ?? GetDefaultHttpMessageHandler(), handlers.ToArray());
-            return handler != null ? new HttpClient(handler) : new HttpClient();
-        }
-
+
+        /// <summary>
+        /// Initializes the <see cref="HttpClient"/> with a custom middleware pipeline.
+        /// </summary>
+        /// <param name="handlers">The <see cref="DelegatingHandler"/> instances to create the <see cref="DelegatingHandler"/> from.</param>
+        /// <param name="finalHandler">The final <see cref="HttpMessageHandler"/> in the http pipeline. Can be configured for proxies, auto-decompression and auto-redirects</param>
+        /// <returns>The <see cref="HttpClient"/> with the custom handlers.</returns>
+        public static HttpClient Create(IList<DelegatingHandler> handlers, HttpMessageHandler? finalHandler = null)
+        {
+            if(handlers == null || !handlers.Any())
+                return Create(finalHandler);
+            var handler = ChainHandlersCollectionAndGetFirstLink(finalHandler ?? GetDefaultHttpMessageHandler(), handlers.ToArray());
+            return handler != null ? new HttpClient(handler) : new HttpClient();
+        }
+
         /// <summary>
         /// Creates a default set of middleware to be used by the <see cref="HttpClient"/>.
         /// </summary>
@@ -51,7 +51,7 @@ public static IList<DelegatingHandler> CreateDefaultHandlers()
         {
             return new List<DelegatingHandler>
             {
-                //add the default middlewares as they are ready
+                //add the default middlewares as they are ready, and add them to the list below as well
                 new UriReplacementHandler<UriReplacementHandlerOption>(),
                 new RetryHandler(),
                 new RedirectHandler(),
@@ -60,6 +60,25 @@ public static IList<DelegatingHandler> CreateDefaultHandlers()
                 new HeadersInspectionHandler(),
             };
         }
+
+        /// <summary>
+        /// Gets the default handler types.
+        /// </summary>
+        /// <returns>A list of all the default handlers</returns>
+        /// <remarks>Order matters</remarks>
+        public static IList<System.Type> GetDefaultHandlerTypes()
+        {
+            return new List<System.Type>
+            {
+                typeof(UriReplacementHandler<UriReplacementHandlerOption>),
+                typeof(RetryHandler),
+                typeof(RedirectHandler),
+                typeof(ParametersNameDecodingHandler),
+                typeof(UserAgentHandler),
+                typeof(HeadersInspectionHandler),
+            };
+        }
+
         /// <summary>
         /// Creates a <see cref="DelegatingHandler"/> to use for the <see cref="HttpClient" /> from the provided <see cref="DelegatingHandler"/> instances. Order matters.
         /// </summary>
@@ -81,7 +100,7 @@ public static IList<DelegatingHandler> CreateDefaultHandlers()
                 }
             }
             if(finalHandler != null)
-                handlers[handlers.Length-1].InnerHandler = finalHandler;
+                handlers[handlers.Length - 1].InnerHandler = finalHandler;
             return handlers[0];//first
         }
         /// <summary>
@@ -91,7 +110,7 @@ public static IList<DelegatingHandler> CreateDefaultHandlers()
         /// <returns>The created <see cref="DelegatingHandler"/>.</returns>
         public static DelegatingHandler? ChainHandlersCollectionAndGetFirstLink(params DelegatingHandler[] handlers)
         {
-            return ChainHandlersCollectionAndGetFirstLink(null,handlers);
+            return ChainHandlersCollectionAndGetFirstLink(null, handlers);
         }
         /// <summary>
         /// Gets a default Http Client handler with the appropriate proxy configurations

src/Middleware/Options/UriReplacementHandlerOption.cs

@@ -43,6 +43,13 @@ public UriReplacementHandlerOption(bool isEnabled, IEnumerable<KeyValuePair<stri
         this.replacementPairs = replacementPairs;
     }
 
+    /// <summary>
+    /// Creates a new instance of UriReplacementOption with no replacements.
+    /// </summary>
+    /// <param name="isEnabled">Whether replacement is enabled.</param>
+    /// <remarks>Replacement is disabled by default.</remarks>
+    public UriReplacementHandlerOption(bool isEnabled = false) : this(isEnabled, Array.Empty<KeyValuePair<string, string>>()) { }
+
     /// <inheritdoc/>
     public bool IsEnabled()
     {