Add Path provider and path prefix provider into setting

Author: xuzhg

src/Microsoft.OpenApi.OData.Reader/Edm/ODataContext.cs

@@ -49,7 +49,8 @@ public ODataContext(IEdmModel model, OpenApiConvertSettings settings)
             OperationHanderProvider = new OperationHandlerProvider();
             PathItemHanderProvider = new PathItemHandlerProvider();
 
-            _pathProvider = new ODataPathProvider();
+            // If no path provider, use the default path provider.
+            _pathProvider = settings.PathProvider ?? new ODataPathProvider();
 
             if (settings.EnableKeyAsSegment != null)
             {

src/Microsoft.OpenApi.OData.Reader/Extensions/IODataRoutePathPrefixProvider.cs

@@ -0,0 +1,26 @@
+// ------------------------------------------------------------
+//  Copyright (c) Microsoft Corporation.  All rights reserved.
+//  Licensed under the MIT License (MIT). See LICENSE in the repo root for license information.
+// ------------------------------------------------------------
+
+using System.Collections.Generic;
+using Microsoft.OpenApi.Models;
+
+namespace Microsoft.OpenApi.OData.Extensions
+{
+    /// <summary>
+    /// The interface for route prefix.
+    /// </summary>
+    public interface IODataRoutePathPrefixProvider
+    {
+        /// <summary>
+        /// The route prefix.
+        /// </summary>
+        public string PathPrefix { get; }
+
+        /// <summary>
+        /// The route prefix parameters.
+        /// </summary>
+        public IEnumerable<OpenApiParameter> Parameters { get; }
+    }
+}

src/Microsoft.OpenApi.OData.Reader/Extensions/ODataRoutePathPrefixProvider.cs

@@ -0,0 +1,26 @@
+// ------------------------------------------------------------
+//  Copyright (c) Microsoft Corporation.  All rights reserved.
+//  Licensed under the MIT License (MIT). See LICENSE in the repo root for license information.
+// ------------------------------------------------------------
+
+using System.Collections.Generic;
+using Microsoft.OpenApi.Models;
+
+namespace Microsoft.OpenApi.OData.Extensions
+{
+    /// <summary>
+    /// Default implementation of <see cref="IODataRoutePathPrefixProvider"/>.
+    /// </summary>
+    public class ODataRoutePathPrefixProvider : IODataRoutePathPrefixProvider
+    {
+        /// <summary>
+        /// Gets/sets the path prefix.
+        /// </summary>
+        public string PathPrefix { get; set; }
+
+        /// <summary>
+        /// Gets/sets the associated parameters for the path prefix.
+        /// </summary>
+        public IEnumerable<OpenApiParameter> Parameters { get; set; }
+    }
+}

src/Microsoft.OpenApi.OData.Reader/OpenApiConvertSettings.cs

@@ -4,6 +4,9 @@
 // ------------------------------------------------------------
 
 using System;
+using Microsoft.OpenApi.OData.Common;
+using Microsoft.OpenApi.OData.Edm;
+using Microsoft.OpenApi.OData.Extensions;
 
 namespace Microsoft.OpenApi.OData
 {
@@ -118,7 +121,35 @@ public class OpenApiConvertSettings
         /// <summary>
         /// Gets/sets a value that specifies a prefix to be prepended to all generated paths.
         /// </summary>
-        public string PathPrefix { get; set; } = string.Empty;
+        public string PathPrefix
+        {
+            get
+            {
+                if (RoutePathPrefixProvider != null)
+                {
+                    return RoutePathPrefixProvider.PathPrefix;
+                }
+
+                return null;
+            }
+            set
+            {
+                if (string.IsNullOrWhiteSpace(value))
+                {
+                    throw Error.ArgumentNullOrEmpty("value");
+                }
+
+                RoutePathPrefixProvider = new ODataRoutePathPrefixProvider
+                {
+                    PathPrefix = value
+                };
+            }
+        }
+
+        /// <summary>
+        /// Gets/sets a route path prefix provider.
+        /// </summary>
+        public IODataRoutePathPrefixProvider RoutePathPrefixProvider { get; set; }
 
         /// <summary>
         /// Gets/Sets a value indicating whether or not to show the OpenAPI links in the responses.
@@ -135,6 +166,11 @@ public class OpenApiConvertSettings
         /// </summary>
         public bool ShowRootPath { get; set; } = false;
 
+        /// <summary>
+        /// Gets/sets a the path provider.
+        /// </summary>
+        public IODataPathProvider PathProvider { get; set; }
+
         internal OpenApiConvertSettings Clone()
         {
             var newSettings = new OpenApiConvertSettings
@@ -159,10 +195,11 @@ internal OpenApiConvertSettings Clone()
                 EnableDiscriminatorValue = this.EnableDiscriminatorValue,
                 EnableDerivedTypesReferencesForResponses = this.EnableDerivedTypesReferencesForResponses,
                 EnableDerivedTypesReferencesForRequestBody = this.EnableDerivedTypesReferencesForRequestBody,
-                PathPrefix = this.PathPrefix,
+                RoutePathPrefixProvider = this.RoutePathPrefixProvider,
                 ShowLinks = this.ShowLinks,
                 ShowSchemaExamples = this.ShowSchemaExamples,
-                ShowRootPath = this.ShowRootPath
+                ShowRootPath = this.ShowRootPath,
+                PathProvider = this.PathProvider
             };
 
             return newSettings;

src/Microsoft.OpenApi.OData.Reader/Operation/OperationHandler.cs

@@ -128,6 +128,15 @@ protected virtual void SetParameters(OpenApiOperation operation)
             }
 
             AppendCustomParameters(operation);
+
+            // Add the route prefix parameter v1{data}
+            if (Context.Settings.RoutePathPrefixProvider != null && Context.Settings.RoutePathPrefixProvider.Parameters != null)
+            {
+                foreach (var parameter in Context.Settings.RoutePathPrefixProvider.Parameters)
+                {
+                    operation.Parameters.Add(parameter);
+                }
+            }
         }
 
         /// <summary>

test/Microsoft.OpenAPI.OData.Reader.Tests/Generator/OpenApiPathsGeneratorTests.cs

@@ -95,7 +95,6 @@ public void CreatePathsReturnsForBasicModelWithPrefix()
             Assert.Contains("/some/prefix/Me", paths.Keys);
         }
 
-
         [Fact]
         public void CreatePathsReturnsForContractModelWithHierarhicalClass()
         {