tornadofx-guide

JSON and REST
The datetime(key) function used to retrieve a LocalDateTime object from JSON will by
default expect a value of "Seconds since epoch". If your external webservice expects
"Milliseconds since epoch" instead,
you can either send datetime(key, millis = true) or configure it globally by setting
JsonConfig.DefaultDateTimeMillis = true .
Generating JSON objects
The JsonBuilder is an abstraction over javax.json.JsonObjectBuilder that supports null
values. Instead of blowing up, it silently dismisses the missing entry, which enables you to
build your JSON object graph
more fluently without checking for nulls.
REST Client
The REST Client that makes it easy to perform JSON based REST calls. The underlying
HTTP engine interface has two implementations. The default uses HttpURLConnection and
there is also an implementation based on Apache HttpClient. It is easy to extend the
Rest.Engine to support other http client libraries if needed.
To use the Apache HttpClient implementation, simply call Rest.useApacheHttpClient() in the
init method of your App class and include the org.apache.httpcomponents:httpclient
dependency in your project descriptor.
Configuration
If you mostly access the same api on every call, you can set a base uri so subsequent calls
only need to include relative urls. You can configure the base url anywhere you like, but the
init function of your App class is a good place to do it.
class MyApp : App() {
val api: Rest by inject()
}
init {
}
api.baseURI = "http://contoso.com/api"
260