new: enhance server section of OpenAPI spec

Author: ludomikula

server/api-service/lowcoder-server/src/main/java/org/lowcoder/api/OpenAPIDocsConfiguration.java

@@ -1,21 +1,34 @@
 package org.lowcoder.api;
 
+import java.util.Arrays;
+
+import org.lowcoder.sdk.config.CommonConfig;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+import io.swagger.v3.oas.annotations.enums.SecuritySchemeIn;
 import io.swagger.v3.oas.models.Components;
 import io.swagger.v3.oas.models.OpenAPI;
 import io.swagger.v3.oas.models.info.Info;
 import io.swagger.v3.oas.models.security.SecurityRequirement;
 import io.swagger.v3.oas.models.security.SecurityScheme;
 import io.swagger.v3.oas.models.servers.Server;
-import org.springframework.context.annotation.Bean;
-import org.springframework.context.annotation.Configuration;
-import org.lowcoder.sdk.config.CommonConfig;
-import org.springframework.beans.factory.annotation.Autowired;
+import io.swagger.v3.oas.models.servers.ServerVariable;
+import io.swagger.v3.oas.models.servers.ServerVariables;
 
 @Configuration
 public class OpenAPIDocsConfiguration {
     @Autowired
     private CommonConfig commonConfig;
 
+    @Value("${server.port:8080}")
+    private int serverPort;
+    
+    @Value("${spring.webflux.base-path:/}")
+    private String contextPath;
+    
     @Bean
     OpenAPI customizeOpenAPI() {
         final String securitySchemeName = commonConfig.getCookieName();
@@ -24,7 +37,14 @@ OpenAPI customizeOpenAPI() {
                         .title("Lowcoder API")
                         .version(commonConfig.getApiVersion()))
                 .addServersItem(new Server()
-                        .url("/"))
+                		.url(createLocalServerUrl("localhost", serverPort, contextPath))
+                		.description("Local development API service")
+                )
+                .addServersItem(createCustomServer())
+                .addServersItem(new Server()
+                		.url("https://api-service.lowcoder.cloud/")
+                		.description("Lowcoder Community Edition: Public Cloud API Access")
+                )
                 .addSecurityItem(new SecurityRequirement()
                         .addList(securitySchemeName)).components(new Components()
                         .addSecuritySchemes(
@@ -33,6 +53,60 @@ OpenAPI customizeOpenAPI() {
                                         .name(securitySchemeName)
                                         .type(SecurityScheme.Type.APIKEY)
                                         .in(SecurityScheme.In.COOKIE)
-                        ));
+                        )
+                        .addSecuritySchemes(
+		                        "API Key",
+		                        new SecurityScheme()
+		                        .name("API key")
+		                        .type(SecurityScheme.Type.HTTP)
+		                        .scheme("bearer")
+		                        .bearerFormat("JWT")
+		                )
+		        );
+    }
+    
+    
+    private static String createLocalServerUrl(String domain, int port, String contextPath)    
+    {
+    	StringBuilder sb = new StringBuilder("http");
+    	
+    	if (port == 443)
+    	{
+    		sb.append("s");
+    	}
+    	sb.append("://").append(domain);
+
+    	if (port != 80 && port != 443)
+    	{
+    		sb.append(":").append(port);
+    	}
+    	sb.append(contextPath);
+    	
+    	return sb.toString();
+    }
+    
+    private Server createCustomServer()
+    {
+    	String url = "{scheme}://{domain}:{port}{basePath}";
+    	
+    	Server server = new Server()
+    			.description("Lowcoder Self-hosted Installation API Access")
+    			.url(url)
+    			.variables(new ServerVariables()
+    					.addServerVariable("scheme", new ServerVariable()
+	    	    			._default("http")
+	    	    			.description("HTTP scheme")
+	    	    			._enum(Arrays.asList("http", "https")))
+    					.addServerVariable("domain", new ServerVariable()
+    							.description("Lowcoder IP address or domain")
+    	    	    			._default("localhost"))
+    					.addServerVariable("port", new ServerVariable()
+    							.description("Port")
+    							._default("3000"))
+    					.addServerVariable("basePath", new ServerVariable()
+    							.description("Base path")
+    							._default(contextPath))    					
+    			);
+    	return server;
     }
 }

server/api-service/lowcoder-server/src/main/resources/selfhost/ce/application.yml

@@ -15,6 +15,8 @@ spring:
     allow-circular-references: true
   codec:
     max-in-memory-size: 20MB
+  webflux:
+    context-path: /
 
 server:
   compression: