Cannot override servers in api-docs.yaml using OpenApiCustomiser. Fixes #1188.

Author: bnasslahsen

springdoc-openapi-common/src/main/java/org/springdoc/api/AbstractOpenApiResource.java

@@ -66,6 +66,7 @@
 import io.swagger.v3.oas.models.media.StringSchema;
 import io.swagger.v3.oas.models.parameters.Parameter;
 import io.swagger.v3.oas.models.responses.ApiResponses;
+import io.swagger.v3.oas.models.servers.Server;
 import org.apache.commons.lang3.ArrayUtils;
 import org.apache.commons.lang3.StringUtils;
 import org.slf4j.Logger;
@@ -295,7 +296,10 @@ protected synchronized OpenAPI getOpenApi() {
 				this.removeBrokenReferenceDefinitions(openApi);
 
 			// run the optional customisers
+			List<Server> servers = openApi.getServers();
 			openApiCustomisers.ifPresent(apiCustomisers -> apiCustomisers.forEach(openApiCustomiser -> openApiCustomiser.customise(openApi)));
+			if(!servers.equals(openApi.getServers()))
+				openAPIService.setServersPresent(true);
 
 			openAPIService.setCachedOpenAPI(openApi);
 			openAPIService.resetCalculatedOpenAPI();

springdoc-openapi-webmvc-core/src/test/java/test/org/springdoc/api/app162/OpenApiConfig.java

@@ -0,0 +1,24 @@
+package test.org.springdoc.api.app162;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import io.swagger.v3.oas.models.servers.Server;
+import org.springdoc.core.customizers.OpenApiCustomiser;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class OpenApiConfig {
+    @Bean
+    OpenApiCustomiser openApiCustomiser() {
+        return openApi -> {
+            openApi.getInfo().version("v1");
+            Server server = new Server().url("");
+            List<Server> servers=new ArrayList<>();
+            servers.add(server);
+            openApi.servers(servers);
+        };
+    }
+}

springdoc-openapi-webmvc-core/src/test/java/test/org/springdoc/api/app162/SpringDocApp162Test.java

@@ -0,0 +1,18 @@
+package test.org.springdoc.api.app162;
+
+import org.junit.jupiter.api.Test;
+import test.org.springdoc.api.AbstractSpringDocTest;
+
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+public class SpringDocApp162Test extends AbstractSpringDocTest {
+
+	@SpringBootApplication
+	static class SpringDocTestApp {}
+
+	@Test
+	public void testApp2() throws Exception {
+		super.testApp();
+	}
+
+}

springdoc-openapi-webmvc-core/src/test/resources/results/app162.json

@@ -0,0 +1,14 @@
+{
+  "openapi": "3.0.1",
+  "info": {
+    "title": "OpenAPI definition",
+    "version": "v1"
+  },
+  "servers": [
+    {
+      "url": ""
+    }
+  ],
+  "paths": {},
+  "components": {}
+}