Kotlin × jooby에서 REST API with API reference

What?

Why?

Try

$ git clone https://github.com/jooby-project/kotlin-gradle-starter.git && cd kotlin-gradle-starter

$ ./gradlew joobyRun # hot reloadもしてくれる https://jooby.org/doc/devtools/#gradle-hot-reload
$ curl http://localhost:8080/
Hello Kotlin!

$ ./gradlew test # spekがstarterに入ってる

REST API 엔드포인트 추가

dependencies {
    ~~~
    compile "org.jooby:jooby-jackson:$joobyVersion"
    ~~~
}

import org.jooby.json.Jackson

data class Hello(val hello: String)

class App : Kooby({
    use(Jackson())
    ~~~
    get("/hello/{name}") { Hello(param("name").value()) }
})

$ ./gradlew joobyRun
$ curl http://localhost:8080/hello/taro | jq
{
  "hello": "taro"
}

API reference를 도입해 보기

dependencies {
    ~~~
    compile "org.jooby:jooby-apitool:$joobyVersion"
    ~~~
}

import org.jooby.apitool.ApiTool

class App : Kooby({
    ~~~
    use(ApiTool().swagger().raml())
    ~~~
})

$ ./gradlew joobyRun
$ curl http://localhost:8080/swagger
$ curl http://localhost:8080/raml

Swagger

RAML

감상