[Kotlin][server] Add kotlin-vertx-server

bin/kotlin-vertx-server-petstore.sh

@@ -0,0 +1,31 @@
+#!/bin/sh
+
+SCRIPT="$0"
+
+while [ -h "$SCRIPT" ] ; do
+  ls=$(ls -ld "$SCRIPT")
+  link=$(expr "$ls" : '.*-> \(.*\)$')
+  if expr "$link" : '/.*' > /dev/null; then
+    SCRIPT="$link"
+  else
+    SCRIPT=$(dirname "$SCRIPT")/"$link"
+  fi
+done
+
+if [ ! -d "${APP_DIR}" ]; then
+  APP_DIR=$(dirname "$SCRIPT")/..
+  APP_DIR=$(cd "${APP_DIR}"; pwd)
+fi
+
+executable="./modules/openapi-generator-cli/target/openapi-generator-cli.jar"
+
+if [ ! -f "$executable" ]
+then
+  mvn clean package
+fi
+
+# if you've executed sbt assembly previously it will use that instead.
+export JAVA_OPTS="${JAVA_OPTS} -Xmx1024M -DloggerPath=conf/log4j.properties"
+ags="$@ generate -i modules/openapi-generator/src/test/resources/2_0/petstore.yaml -g kotlin-vertx -o samples/server/petstore/kotlin/vertx"
+
+java ${JAVA_OPTS} -jar ${executable} ${ags}

bin/windows/kotlin-vertx-server-petstore.bat

@@ -0,0 +1,10 @@
+set executable=.\modules\openapi-generator-cli\target\openapi-generator-cli.jar
+
+If Not Exist %executable% (
+  mvn clean package
+)
+
+REM set JAVA_OPTS=%JAVA_OPTS% -Xmx1024M -DloggerPath=conf/log4j.properties
+set ags=generate  --artifact-id "kotlin-vertx-petstore-server" -i modules\openapi-generator\src\test\resources\2_0\petstore.yaml -g kotlin-vertx -o samples\server\petstore\kotlin\vertx
+
+java %JAVA_OPTS% -jar %executable% %ags%

docs/generators.md

@@ -95,6 +95,7 @@ The following generators are available:
 * [jaxrs-spec](generators/jaxrs-spec)  
 * [kotlin-server](generators/kotlin-server)  
 * [kotlin-spring](generators/kotlin-spring)  
+* [korlin-vertx](generators/kotlin-vertx)
 * [nodejs-express-server (beta)](generators/nodejs-express-server)  
 * [nodejs-server-deprecated (deprecated)](generators/nodejs-server-deprecated)  
 * [php-laravel](generators/php-laravel)  

docs/generators/kotlin-vertx.md

@@ -0,0 +1,18 @@
+
+---
+id: generator-opts-server-kotlin-vertx
+title: Config Options for kotlin-vertx
+sidebar_label: kotlin-vertx
+---
+
+| Option | Description | Values | Default |
+| ------ | ----------- | ------ | ------- |
+|sourceFolder|source folder for generated code| |src/main/kotlin|
+|modelPackage|package for generated models| |org.openapitools.server.api.model|
+|apiPackage|package for generated api classes| |org.openapitools.server.api.verticle|
+|apiSuffix|suffix for api classes| |Api|
+|groupId|Generated artifact package's organization (i.e. maven groupId).| |org.openapitools|
+|artifactId|Generated artifact id (name of jar).| |kotlin-server|
+|artifactVersion|Generated artifact's package version.| |1.0.0|
+|enumPropertyNaming|Naming convention for enum properties: 'camelCase', 'PascalCase', 'snake_case', 'UPPERCASE', and 'original'| |camelCase|
+|parcelizeModels|toggle "@Parcelize" for generated models| |null|

modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/KotlinVertxServerCodegen.java

@@ -0,0 +1,85 @@
+/*
+ * Copyright 2018 OpenAPI-Generator Contributors (https://openapi-generator.tech)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.openapitools.codegen.languages;
+
+import org.openapitools.codegen.CodegenConstants;
+import org.openapitools.codegen.CodegenType;
+import org.openapitools.codegen.SupportingFile;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.io.File;
+import java.util.Locale;
+
+public class KotlinVertxServerCodegen extends AbstractKotlinCodegen {
+
+    protected String rootPackage = "org.openapitools.server.api";
+    protected String apiVersion = "1.0.0-SNAPSHOT";
+
+    public static final String ROOT_PACKAGE = "rootPackage";
+
+    public static final String PROJECT_NAME = "projectName";
+
+    static Logger LOGGER = LoggerFactory.getLogger(KotlinVertxServerCodegen.class);
+
+    public CodegenType getTag() {
+        return CodegenType.SERVER;
+    }
+
+    public String getName() {
+        return "kotlin-vertx";
+    }
+
+    public String getHelp() {
+        return "Generates a kotlin-vertx server.";
+    }
+
+    public KotlinVertxServerCodegen() {
+        super();
+
+        outputFolder = "generated-code" + File.separator + "kotlin-vertx";
+        modelTemplateFiles.put("model.mustache", ".kt");
+
+        apiTestTemplateFiles.clear();
+        modelDocTemplateFiles.clear();
+        supportingFiles.clear();
+
+        apiTemplateFiles.clear();
+        apiTemplateFiles.put("api.mustache", ".kt");
+        apiTemplateFiles.put("apiProxy.mustache", "VertxProxyHandler.kt");
+        apiTemplateFiles.put("api_verticle.mustache","Verticle.kt");
+
+        embeddedTemplateDir = templateDir = "kotlin-vertx-server";
+        apiPackage = rootPackage + ".verticle";
+        modelPackage = rootPackage + ".model";
+        artifactId = "openapi-kotlin-vertx-server";
+        artifactVersion = apiVersion;
+
+        updateOption(CodegenConstants.API_PACKAGE, apiPackage);
+        updateOption(CodegenConstants.MODEL_PACKAGE, modelPackage);
+        additionalProperties.put(ROOT_PACKAGE, rootPackage);
+
+        supportingFiles.add(new SupportingFile("pom.mustache", "", "pom.xml"));
+        supportingFiles.add(new SupportingFile("README.mustache", "", "README.md"));
+
+    }
+
+    @Override
+    public String escapeReservedWord(String name) {
+        return name;
+    }
+}

modules/openapi-generator/src/main/resources/META-INF/services/org.openapitools.codegen.CodegenConfig

@@ -28,6 +28,7 @@ org.openapitools.codegen.languages.ErlangClientCodegen
 org.openapitools.codegen.languages.ErlangProperCodegen
 org.openapitools.codegen.languages.ErlangServerCodegen
 org.openapitools.codegen.languages.FlashClientCodegen
+org.openapitools.codegen.languages.FsharpGiraffeServerCodegen
 org.openapitools.codegen.languages.GoClientCodegen
 org.openapitools.codegen.languages.GoClientExperimentalCodegen
 org.openapitools.codegen.languages.GoServerCodegen
@@ -38,6 +39,7 @@ org.openapitools.codegen.languages.GroovyClientCodegen
 org.openapitools.codegen.languages.KotlinClientCodegen
 org.openapitools.codegen.languages.KotlinServerCodegen
 org.openapitools.codegen.languages.KotlinSpringServerCodegen
+org.openapitools.codegen.languages.KotlinVertxServerCodegen
 org.openapitools.codegen.languages.HaskellHttpClientCodegen
 org.openapitools.codegen.languages.HaskellServantCodegen
 org.openapitools.codegen.languages.JavaClientCodegen
@@ -114,5 +116,4 @@ org.openapitools.codegen.languages.TypeScriptJqueryClientCodegen
 org.openapitools.codegen.languages.TypeScriptNodeClientCodegen
 org.openapitools.codegen.languages.TypeScriptRxjsClientCodegen
 org.openapitools.codegen.languages.FsharpGiraffeServerCodegen
-
 org.openapitools.codegen.languages.AsciidocDocumentationCodegen

modules/openapi-generator/src/main/resources/kotlin-vertx-server/README.mustache

@@ -0,0 +1,76 @@
+# {{packageName}} - Kotlin Server library for {{appName}}
+
+## Requires
+
+* Kotlin 1.3.10
+* Maven 3.3
+
+## Build
+
+```
+mvn clean package
+```
+
+This runs all tests and packages the library.
+
+## Features/Implementation Notes
+
+* Supports JSON inputs/outputs and Form inputs.
+* Supports collection formats for query parameters: csv, tsv, ssv, pipes.
+* Some Kotlin and Java types are fully qualified to avoid conflicts with types defined in OpenAPI definitions.
+
+{{#generateApiDocs}}
+    <a name="documentation-for-api-endpoints"></a>
+    ## Documentation for API Endpoints
+
+    All URIs are relative to *{{{basePath}}}*
+
+    Class | Method | HTTP request | Description
+    ------------ | ------------- | ------------- | -------------
+    {{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{classname}}* | [**{{operationId}}**]({{apiDocPath}}{{classname}}.md#{{operationIdLowerCase}}) | **{{httpMethod}}** {{path}} | {{#summary}}{{{summary}}}{{/summary}}
+    {{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}
+{{/generateApiDocs}}
+
+{{#generateModelDocs}}
+    <a name="documentation-for-models"></a>
+    ## Documentation for Models
+
+    {{#modelPackage}}
+        {{#models}}{{#model}} - [{{{modelPackage}}}.{{{classname}}}]({{modelDocPath}}{{{classname}}}.md)
+        {{/model}}{{/models}}
+    {{/modelPackage}}
+    {{^modelPackage}}
+        No model defined in this package
+    {{/modelPackage}}
+{{/generateModelDocs}}
+
+<a name="documentation-for-authorization"></a>{{! TODO: optional documentation for authorization? }}
+## Documentation for Authorization
+
+{{^authMethods}}
+    All endpoints do not require authorization.
+{{/authMethods}}
+{{#authMethods}}
+    {{#last}}
+        Authentication schemes defined for the API:
+    {{/last}}
+{{/authMethods}}
+{{#authMethods}}
+    <a name="{{name}}"></a>
+    ### {{name}}
+
+    {{#isApiKey}}- **Type**: API key
+    - **API key parameter name**: {{keyParamName}}
+    - **Location**: {{#isKeyInQuery}}URL query string{{/isKeyInQuery}}{{#isKeyInHeader}}HTTP header{{/isKeyInHeader}}
+    {{/isApiKey}}
+    {{#isBasic}}- **Type**: HTTP basic authentication
+    {{/isBasic}}
+    {{#isOAuth}}- **Type**: OAuth
+    - **Flow**: {{flow}}
+    - **Authorization URL**: {{authorizationUrl}}
+    - **Scopes**: {{^scopes}}N/A{{/scopes}}
+    {{#scopes}}  - {{scope}}: {{description}}
+    {{/scopes}}
+    {{/isOAuth}}
+
+{{/authMethods}}

modules/openapi-generator/src/main/resources/kotlin-vertx-server/api.mustache

@@ -0,0 +1,53 @@
+package {{package}}
+
+{{#imports}}import {{import}}
+{{/imports}}
+import io.vertx.core.Vertx
+import io.vertx.core.json.JsonObject
+import io.vertx.core.json.JsonArray
+import com.github.wooyme.openapi.Response
+import io.vertx.ext.web.api.OperationRequest
+import io.vertx.kotlin.ext.web.api.contract.openapi3.OpenAPI3RouterFactory
+import io.vertx.serviceproxy.ServiceBinder
+import io.vertx.ext.web.handler.CookieHandler
+import io.vertx.ext.web.handler.SessionHandler
+import io.vertx.ext.web.sstore.LocalSessionStore
+import java.util.List
+import java.util.Map
+
+
+interface {{classname}}  {
+    fun init(vertx:Vertx,config:JsonObject)
+{{#operations}}
+    {{#operation}}
+    /* {{operationId}}
+     * {{summary}} */
+    suspend fun {{operationId}}({{#allParams}}{{paramName}}:{{^isFile}}{{{dataType}}}{{/isFile}}{{#isFile}}kotlin.collections.List<java.io.File>{{/isFile}}{{^isRequired}}?{{/isRequired}},{{/allParams}}context:OperationRequest):Response<{{#returnType}}{{{returnType}}}{{/returnType}}{{^returnType}}Void{{/returnType}}>
+    {{/operation}}
+{{/operations}}
+    companion object {
+        const val address = "{{classname}}-service"
+        suspend fun createRouterFactory(vertx: Vertx,path:String): io.vertx.ext.web.api.contract.openapi3.OpenAPI3RouterFactory {
+            val routerFactory = OpenAPI3RouterFactory.createAwait(vertx,path)
+            routerFactory.addGlobalHandler(CookieHandler.create())
+            routerFactory.addGlobalHandler(SessionHandler.create(LocalSessionStore.create(vertx)))
+            routerFactory.setExtraOperationContextPayloadMapper{
+                JsonObject().put("files",JsonArray(it.fileUploads().map { it.uploadedFileName() }))
+            }
+            val opf = routerFactory::class.java.getDeclaredField("operations")
+            opf.isAccessible = true
+            val operations = opf.get(routerFactory) as Map<String, Any>
+            for (m in {{classname}}::class.java.methods) {
+                val methodName = m.name
+                val op = operations[methodName]
+                if (op != null) {
+                    val method = op::class.java.getDeclaredMethod("mountRouteToService",String::class.java,String::class.java)
+                    method.isAccessible = true
+                    method.invoke(op,address,methodName)
+                }
+            }
+            routerFactory.mountServiceInterface({{classname}}::class.java, address)
+            return routerFactory
+        }
+    }
+}