Merge branch 'feature/4.0-swagger' into feature/5.3-swagger

# Conflicts:
#	web/src/main/java/com/graphhopper/application/ObjectNodeConverter.java

Author: drndos

web/pom.xml

@@ -50,6 +50,17 @@
             <scope>test</scope>
         </dependency>
 
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-jaxrs2</artifactId>
+            <version>2.1.11</version>
+        </dependency>
+        <dependency>
+            <groupId>io.swagger.core.v3</groupId>
+            <artifactId>swagger-jaxrs2-servlet-initializer-v2</artifactId>
+            <version>2.1.11</version>
+        </dependency>
+
         <!-- for integration tests of service -->
         <dependency>
             <groupId>com.graphhopper</groupId>

web/src/main/java/com/graphhopper/application/GraphHopperApplication.java

@@ -26,11 +26,23 @@
 import com.graphhopper.navigation.NavigateResource;
 import io.dropwizard.Application;
 import io.dropwizard.assets.AssetsBundle;
+import io.dropwizard.configuration.EnvironmentVariableSubstitutor;
+import io.dropwizard.configuration.SubstitutingSourceProvider;
 import io.dropwizard.setup.Bootstrap;
 import io.dropwizard.setup.Environment;
-
-import javax.servlet.DispatcherType;
+import io.swagger.v3.core.converter.ModelConverters;
+import io.swagger.v3.jaxrs2.integration.JaxrsOpenApiContextBuilder;
+import io.swagger.v3.jaxrs2.integration.resources.OpenApiResource;
+import io.swagger.v3.oas.integration.OpenApiConfigurationException;
+import io.swagger.v3.oas.integration.SwaggerConfiguration;
+import io.swagger.v3.oas.models.OpenAPI;
+import io.swagger.v3.oas.models.info.Info;
+import io.swagger.v3.oas.models.servers.Server;
+import java.util.Collections;
 import java.util.EnumSet;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+import javax.servlet.DispatcherType;
 
 public final class GraphHopperApplication extends Application<GraphHopperServerConfiguration> {
 
@@ -40,6 +52,9 @@ public static void main(String[] args) throws Exception {
 
     @Override
     public void initialize(Bootstrap<GraphHopperServerConfiguration> bootstrap) {
+        bootstrap.setConfigurationSourceProvider(new SubstitutingSourceProvider(
+            bootstrap.getConfigurationSourceProvider(),
+            new EnvironmentVariableSubstitutor(false)));
         bootstrap.addBundle(new GraphHopperBundle());
         bootstrap.addBundle(new RealtimeBundle());
         bootstrap.addCommand(new ImportCommand());
@@ -51,8 +66,34 @@ public void initialize(Bootstrap<GraphHopperServerConfiguration> bootstrap) {
 
     @Override
     public void run(GraphHopperServerConfiguration configuration, Environment environment) {
+        setupOpenApi(configuration.getGraphHopperConfiguration().getString("api_basepath","http://localhost:8989/"));
+        ModelConverters.getInstance().addConverter(new ObjectNodeConverter());
         environment.jersey().register(new RootResource());
+        environment.jersey().register(new OpenApiResource());
         environment.jersey().register(NavigateResource.class);
         environment.servlets().addFilter("cors", CORSFilter.class).addMappingForUrlPatterns(EnumSet.allOf(DispatcherType.class), false, "*");
     }
+
+    private void setupOpenApi(String apiBasePath) {
+        OpenAPI oas = new OpenAPI()
+            .info(new Info()
+                .title("Graphhopper API")
+                .description("Basic Graphhopper autogenerated REST API documentation."))
+            .servers(Collections.singletonList(new Server().url(apiBasePath)));
+
+        SwaggerConfiguration oasConfig = new SwaggerConfiguration()
+            .openAPI(oas)
+            .prettyPrint(true)
+            .resourcePackages(Stream.of("com.graphhopper").collect(Collectors.toSet()));
+
+        try {
+            new JaxrsOpenApiContextBuilder()
+                //.servletConfig(servletConfig)
+                //.application(this)
+                .openApiConfiguration(oasConfig)
+                .buildContext(true);
+        } catch (OpenApiConfigurationException e) {
+            throw new RuntimeException(e.getMessage(), e);
+        }
+    }
 }

web/src/main/java/com/graphhopper/application/ObjectNodeConverter.java

@@ -0,0 +1,30 @@
+package com.graphhopper.application;
+
+import com.fasterxml.jackson.databind.JavaType;
+import com.fasterxml.jackson.databind.node.ObjectNode;
+import io.swagger.v3.core.converter.AnnotatedType;
+import io.swagger.v3.core.converter.ModelConverter;
+import io.swagger.v3.core.converter.ModelConverterContext;
+import io.swagger.v3.core.util.Json;
+import io.swagger.v3.oas.models.media.ObjectSchema;
+import io.swagger.v3.oas.models.media.Schema;
+import java.util.Iterator;
+
+public class ObjectNodeConverter implements ModelConverter {
+
+  @Override
+  public Schema resolve(AnnotatedType type, ModelConverterContext context, Iterator<ModelConverter> chain) {
+    JavaType _type = Json.mapper().constructType(type.getType());
+    if (_type != null) {
+      Class<?> cls = _type.getRawClass();
+      if (ObjectNode.class.isAssignableFrom(cls)) {
+        return new ObjectSchema();
+      }
+    }
+    if (chain.hasNext()) {
+      return chain.next().resolve(type, context, chain);
+    } else {
+      return null;
+    }
+  }
+}