Merge pull request #574 from fs123/feature/issue-572-missing-swagger-ui-property

Add support for swagger-ui-property 'urls.primaryName'.

Author: bnasslahsen

springdoc-openapi-common/src/main/java/org/springdoc/core/SwaggerUiConfigProperties.java

@@ -160,6 +160,8 @@ public class SwaggerUiConfigProperties {
 
 	private Direction groupsOrder = Direction.ASC;
 
+	private String urlsPrimaryName;
+
 	public void addGroup(String group) {
 		SwaggerUrl swaggerUrl = new SwaggerUrl(group);
 		urls.add(swaggerUrl);
@@ -204,6 +206,7 @@ public Map<String, Object> getConfigParameters() {
 		SpringDocPropertiesUtils.put("oauth2RedirectUrl", oauth2RedirectUrl, params);
 		SpringDocPropertiesUtils.put("url", url, params);
 		put("urls", urls, params);
+		SpringDocPropertiesUtils.put("urls.primaryName", urlsPrimaryName, params);
 		return params;
 	}
 
@@ -407,6 +410,14 @@ public boolean isAscending() {
 		}
 	}
 
+	public String getUrlsPrimaryName() {
+		return urlsPrimaryName;
+	}
+
+	public void setUrlsPrimaryName(String urlsPrimaryName) {
+		this.urlsPrimaryName = urlsPrimaryName;
+	}
+
 	static class SwaggerUrl {
 		private String url;
 

springdoc-openapi-ui/src/test/java/test/org/springdoc/ui/app4/SpringDocApp4Test.java

@@ -28,7 +28,7 @@
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
 import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
 
-@TestPropertySource(properties = "springdoc.swagger-ui.groups-order=DESC")
+@TestPropertySource(properties = {"springdoc.swagger-ui.groups-order=DESC", "springdoc.swagger-ui.urlsPrimaryName=pets"})
 public class SpringDocApp4Test extends AbstractSpringDocTest {
 
 	@Test
@@ -40,6 +40,7 @@ public void swagger_config_for_multiple_groups() throws Exception {
 				.andExpect(jsonPath("urls[0].url", equalTo("/v3/api-docs/stores")))
 				.andExpect(jsonPath("urls[0].name", equalTo("stores")))
 				.andExpect(jsonPath("urls[1].url", equalTo("/v3/api-docs/pets")))
-				.andExpect(jsonPath("urls[1].name", equalTo("pets")));
+				.andExpect(jsonPath("urls[1].name", equalTo("pets")))
+				.andExpect(jsonPath("$['urls.primaryName']", equalTo("pets")));
 	}
 }