Add "root-path" to swagger-ui

extensions/swagger-ui/deployment/src/main/java/io/quarkus/swaggerui/deployment/SwaggerUiConfig.java

@@ -364,4 +364,10 @@ public class SwaggerUiConfig {
      */
     @ConfigItem(defaultValue = "false")
     boolean tryItOutEnabled;
+
+    /**
+     * If application behind the proxy with custom location path.
+     */
+    @ConfigItem
+    Optional<String> locationPath;
 }

extensions/swagger-ui/deployment/src/main/java/io/quarkus/swaggerui/deployment/SwaggerUiProcessor.java

@@ -120,6 +120,9 @@ public void getSwaggerUiFinalDestination(
             }
 
             String openApiPath = nonApplicationRootPathBuildItem.resolvePath(openapi.path);
+            if (swaggerUiConfig.locationPath.isPresent()) {
+                openApiPath = swaggerUiConfig.locationPath.get() + openApiPath;
+            }
 
             String swaggerUiPath = nonApplicationRootPathBuildItem.resolvePath(swaggerUiConfig.path);
             ThemeHref theme = swaggerUiConfig.theme.orElse(ThemeHref.feeling_blue);
@@ -379,6 +382,12 @@ private byte[] generateIndexHtml(String openApiPath, String swaggerUiPath, Swagg
         if (swaggerUiConfig.queryConfigEnabled) {
             options.put(Option.queryConfigEnabled, "true");
         }
+        if (swaggerUiConfig.locationPath.isPresent()) {
+            var locationPath = swaggerUiConfig.locationPath.get();
+            addLocationPath(locationPath, Option.selfHref, options);
+            addLocationPath(locationPath, Option.backHref, options);
+            addLocationPath(locationPath, Option.oauth2RedirectUrl, options);
+        }
 
         ObjectMapper objectMapper = new ObjectMapper();
         Map<String, String> oauthAdditionalQueryStringParamMap = new HashMap<>();
@@ -437,6 +446,13 @@ private byte[] generateIndexHtml(String openApiPath, String swaggerUiPath, Swagg
         return IndexHtmlCreator.createIndexHtml(urlsMap, swaggerUiConfig.urlsPrimaryName.orElse(null), options);
     }
 
+    private void addLocationPath(String locationPath, Option key, Map<Option, String> options) {
+        var value = options.get(key);
+        if (value != null) {
+            options.put(key, locationPath + value);
+        }
+    }
+
     private static boolean shouldInclude(LaunchModeBuildItem launchMode, SwaggerUiConfig swaggerUiConfig) {
         return launchMode.getLaunchMode().isDevOrTest() || swaggerUiConfig.alwaysInclude;
     }

extensions/swagger-ui/deployment/src/test/java/io/quarkus/swaggerui/deployment/LocationPathTest.java

@@ -0,0 +1,43 @@
+package io.quarkus.swaggerui.deployment;
+
+import static org.hamcrest.Matchers.containsString;
+
+import org.jboss.shrinkwrap.api.asset.StringAsset;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.RegisterExtension;
+
+import io.quarkus.test.QuarkusUnitTest;
+import io.restassured.RestAssured;
+
+public class LocationPathTest {
+
+    @RegisterExtension
+    static final QuarkusUnitTest config = new QuarkusUnitTest()
+            .withApplicationRoot((jar) -> jar
+                    .addAsResource(new StringAsset(
+                            "quarkus.swagger-ui.location-path=/nginx/path"), "application.properties"));
+
+    @Test
+    public void shouldUseCustomOpenApiPath() {
+        RestAssured.when().get("/q/swagger-ui").then().statusCode(200).body(containsString("/nginx/path/q/openapi"));
+        RestAssured.when().get("/q/swagger-ui/index.html").then().statusCode(200).body(containsString("/nginx/path/q/openapi"));
+        RestAssured.when().get("/q/swagger-ui").then()
+                .statusCode(200)
+                .body(containsString("/nginx/path/q/swagger-ui/oauth2-redirect.html"));
+        RestAssured.when().get("/q/swagger-ui/index.html").then()
+                .statusCode(200)
+                .body(containsString("/nginx/path/q/swagger-ui/oauth2-redirect.html"));
+        RestAssured.when().get("/q/swagger-ui").then()
+                .statusCode(200)
+                .body(containsString("/nginx/path/q/dev"));
+        RestAssured.when().get("/q/swagger-ui/index.html").then()
+                .statusCode(200)
+                .body(containsString("/nginx/path/q/dev"));
+        RestAssured.when().get("/q/swagger-ui").then()
+                .statusCode(200)
+                .body(containsString("/nginx/path/q/swagger-ui"));
+        RestAssured.when().get("/q/swagger-ui/index.html").then()
+                .statusCode(200)
+                .body(containsString("/nginx/path/q/swagger-ui"));
+    }
+}