Merge pull request #714 from overture-stack/rc/4.5.0

rc 4.5.0 
Configurable swagger to run behind reverse proxy

Author: blabadi

pom.xml

@@ -21,7 +21,7 @@
     <groupId>bio.overture</groupId>
     <artifactId>song</artifactId>
     <packaging>pom</packaging>
-    <version>4.4.0</version>
+    <version>4.5.0</version>
     <modules>
         <module>song-core</module>
         <module>song-java-sdk</module>

song-client/pom.xml

@@ -18,7 +18,7 @@
 	<parent>
 		<artifactId>song</artifactId>
 		<groupId>bio.overture</groupId>
-		<version>4.4.0</version>
+		<version>4.5.0</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 
@@ -35,12 +35,12 @@
 		<dependency>
 			<groupId>bio.overture</groupId>
 			<artifactId>song-java-sdk</artifactId>
-			<version>4.4.0</version>
+			<version>4.5.0</version>
 		</dependency>
 		<dependency>
 			<groupId>bio.overture</groupId>
 			<artifactId>song-core</artifactId>
-			<version>4.4.0</version>
+			<version>4.5.0</version>
 		</dependency>
 
 		<!-- CLI -->

song-core/pom.xml

@@ -19,7 +19,7 @@
 	<parent>
 		<artifactId>song</artifactId>
 		<groupId>bio.overture</groupId>
-		<version>4.4.0</version>
+		<version>4.5.0</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 

song-java-sdk/pom.xml

@@ -18,7 +18,7 @@
 	<parent>
 		<artifactId>song</artifactId>
 		<groupId>bio.overture</groupId>
-		<version>4.4.0</version>
+		<version>4.5.0</version>
 	</parent>
 	<modelVersion>4.0.0</modelVersion>
 

song-server/pom.xml

@@ -19,7 +19,7 @@
     <parent>
         <artifactId>song</artifactId>
         <groupId>bio.overture</groupId>
-        <version>4.4.0</version>
+        <version>4.5.0</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -37,7 +37,7 @@
         <dependency>
             <groupId>bio.overture</groupId>
             <artifactId>song-core</artifactId>
-            <version>4.4.0</version>
+            <version>4.5.0</version>
         </dependency>
 
         <!-- Spring -->

song-server/src/main/java/bio/overture/song/server/config/SwaggerConfig.java

@@ -27,6 +27,7 @@
 import springfox.documentation.builders.ApiInfoBuilder;
 import springfox.documentation.service.ApiInfo;
 import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spring.web.paths.RelativePathProvider;
 import springfox.documentation.spring.web.plugins.Docket;
 import springfox.documentation.swagger.web.UiConfiguration;
 import springfox.documentation.swagger2.annotations.EnableSwagger2;
@@ -42,15 +43,30 @@ public class SwaggerConfig {
   @Getter
   private String alternateSwaggerUrl;
 
+  // default is empty
+  @Value("${swagger.host:}")
+  private String swaggerHost;
+
+  // default is empty
+  @Value("${swagger.basePath:}")
+  private String basePath;
+
   @Bean
   public Docket api() {
     return new Docket(DocumentationType.SWAGGER_2)
         .apiInfo(apiInfo())
         .select()
         .apis(basePackage("bio.overture.song.server.controller"))
-        .paths(any())
         .build()
-        .pathMapping("/");
+        .host(swaggerHost)
+        .pathProvider(
+            new RelativePathProvider(null) {
+                @Override
+                public String getApplicationBasePath() {
+                  return basePath;
+                }
+            }
+        );
   }
 
   @Bean

song-server/src/main/resources/application.yml

@@ -80,6 +80,11 @@ management:
 
 swagger:
   alternateUrl: "/api-docs"
+  # host and base url are needed if you run song behind a reverse proxy
+  # and rewrite the url eg: http://mydomain.com/song/swagger-ui.html
+  # in this case host = mydomain.com, baseUrl = /song
+  host: ""
+  basePath: ""
 
 security.basic.enabled: false