geospatial-messenger/README.md

This is a sample application that demonstrates how to build a Kotlin + Spring Boot applications with a PostgreSQL database.

It is used as a playground to demonstrate various features:

• Simple User and Message domain model classes thanks to Kotlin data classes.
• The Application class shows how to configure a Kotlin Spring Boot application.
• Typesafe SQL DSL with Exposed that allows to define your SQL tables and describe your SQL requests with a fluent API without requiring code generation.
• Controllers demonstrates how to use Spring Framework 4.3 upcoming @GetMapping and PostMapping annotation shortcuts, as well as Server-Sent Events to push data to the client.
• Kotlin extensions allows to add Geospatial support to Exposed and use it as if this was supported out of the box.
• The REST API is fully tested and documented thanks to the awesome Spring REST docs , see MessageControllerTests and index.adoc.
• The client side is a pure HTML + Javascript application developed with [OpenLayers] mapping library, see index.html and map.js.

Run the application

• Install a PostgreSQL database with PostGis extension, on Mac you can use Postgresapp
• Clone this repository
• Customize database configuration on application.yml
• Run it within your IDE or with ./gradlew bootRun
• Open http://localhost:8080/ in your browser, documentation should be available at http://localhost:8080/docs/index.html when run from the JAR.

Improvements I have in mind

• Exposed issue #24: see if Exposed could support natively data classes + repository patten.
• Exposed issue #25: allow to support SQL transaction with @Transactional.
• Spring HATEOAS issue #401: add HATEOAS support, but without having to extend ResourceSupport or wrapping it into a Resource<Foo> container .
• Kotlin issue KT-11235: avoid mandatory usage of arrayOf in annotation array attribute (for example in @SpringApplicationConfiguration(classes = arrayOf(Application::class)).