SwaggerGenerator Updates (#433)

* introduce FHIRSwaggersGenerator for generating one-swagger-per-resource

Signed-off-by: Lee Surprenant <lmsurpre@us.ibm.com>

* Package edits for generating one swagger per resource type

TODO: do the same for FHIROpenApiGenerator and try out the OpenAPI files
in liberty.

Signed-off-by: Lee Surprenant <lmsurpre@us.ibm.com>

* fixed an issue with the swagger definition for Integer

Signed-off-by: Lee Surprenant <lmsurpre@us.ibm.com>

* Generate inline primitive types

In the previous version, we generated a definition for each FHIR
primitive type. This correctly captured the fact that these can have an
id and/or extensions (inhereted from Element) but would lead to the
wrong JSON since these elements need to get serialized differently in
JSON.

Technically, we should introduce a `_fieldname` variant for each
instance of a primitive type, but primitive extensions are not common
and it adds significant complexity to the swagger.

Signed-off-by: Lee Surprenant <lmsurpre@us.ibm.com>

Author: lmsurpre

fhir-swagger-generator/pom.xml

@@ -45,6 +45,18 @@
                     </formatFileSets>
                 </configuration>
             </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <configuration>
+                    <archive>
+                        <manifest>
+                            <addClasspath>true</addClasspath>
+                            <mainClass>com.ibm.fhir.swagger.generator.FHIRSwaggerGenerator</mainClass>
+                        </manifest>
+                    </archive>
+                </configuration>
+            </plugin>
         </plugins>
     </build>
 

fhir-swagger-generator/src/main/java/com/ibm/fhir/swagger/generator/APIConnectAdapter.java

@@ -0,0 +1,83 @@
+package com.ibm.fhir.swagger.generator;
+/*
+ * (C) Copyright IBM Corp. 2019
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import javax.json.Json;
+import javax.json.JsonArrayBuilder;
+import javax.json.JsonBuilderFactory;
+import javax.json.JsonObjectBuilder;
+
+/**
+ * 
+ */
+public class APIConnectAdapter {
+    
+    /**
+     * Set this to the hostname of your FHIR Server and the generated assembly will proxy this
+     */
+    private static final String HOST = "localhost";
+    
+    private static final JsonBuilderFactory factory = Json.createBuilderFactory(null);
+    
+    static void addApiConnectStuff(JsonObjectBuilder swagger) {
+        JsonObjectBuilder ibmConfig = factory.createObjectBuilder()
+                                        .add("gateway", "datapower-api-gateway")
+                                        .add("type", "rest")
+                                        .add("phase", "realized")
+                                        .add("enforced", true)
+                                        .add("testable", true)
+                                        .add("cors", factory.createObjectBuilder().add("enabled", true))
+                                        .add("assembly", buildAssembly())
+                                        .add("properties", buildProperties())
+                                        .add("activity-log", factory.createObjectBuilder()
+                                                               .add("enabled", true)
+                                                               .add("error-content", "header")
+                                                               .add("success-content", "activity"))
+                                        .add("application-authentication", factory.createObjectBuilder()
+                                                               .add("certificate", false))
+                                        .add("catalogs", factory.createObjectBuilder());
+        swagger.add("x-ibm-configuration", ibmConfig);
+    }
+    
+    private static JsonObjectBuilder buildAssembly() {
+        JsonObjectBuilder executeInvoke = factory.createObjectBuilder().add("invoke", buildExecuteInvoke());
+        
+        JsonArrayBuilder execute = factory.createArrayBuilder().add(executeInvoke);
+        
+        return factory.createObjectBuilder()
+                .add("execute", execute)
+                .add("catch", factory.createArrayBuilder());
+    }
+
+    private static JsonObjectBuilder buildExecuteInvoke() {
+        JsonObjectBuilder headerControl = factory.createObjectBuilder()
+                                            .add("type", "blacklist")
+                                            .add("values", factory.createArrayBuilder());
+        JsonObjectBuilder paramControl = factory.createObjectBuilder()
+                                            .add("type", "whitelist")
+                                            .add("values", factory.createArrayBuilder());
+        return factory.createObjectBuilder()
+                                    .add("version", "2.0.0")
+                                    .add("title", "invoke")
+                                    .add("header-control", headerControl)
+                                    .add("parameter-control",paramControl)
+                                    .add("timeout",  60)
+                                    .add("verb", "keep")
+                                    .add("cache-response", "protocol")
+                                    .add("cache-ttl", 900)
+                                    .add("stop-on-error", factory.createArrayBuilder())
+                                    .add("target-url", "$(target-url)$(api.operation.path)$(request.search)");
+    }
+    
+    private static JsonObjectBuilder buildProperties() {
+        JsonObjectBuilder targetUrl = factory.createObjectBuilder()
+                                            .add("value", "https://" + HOST + "/fhir-server/api/v4/")
+                                            .add("description", "The URL of the target service")
+                                            .add("encoded", false);
+        
+        return factory.createObjectBuilder().add("target-url", targetUrl);
+    }
+}