Photo by on Stephanie McCabe Unsplash The not-so-mainstream way of building an API When speaking of building a backend API, the most common tools is either Spring Boot for Java or ExpressJS for JavaScript. Even for Kotlin, Spring Boot and JetBrain’s own ktor is the usual option to go with. But today I’ll explore into the less popular option of spark-kotlin. Disclaimer : I am not in anyway affiliated nor do I work at the project. I just simply stumbled upon it and started using it when working on a side project. (coming soon ™ ) Understanding REST If you already know or built a RESTful API, you can skip this part. There are already a few guides out there that goes into the specifics of what REST is and all the amazing things about it. So instead, I’ll just cover the basics (more like, that’s all I know about it). It’s the standard way of communication on the internet through HTTP. In the world of internet, the frontend web interface needs a way to communicate with the backend. While the frontend can say all kinds of things, they still need to declare a set of standard ‘phrases’ between them so the backend knows what the frontend is asking for. quite Setting up Here are a few thing you might want to have installed before getting started: Maven / Gradle Kotlin Java? (not too sure but you’ll probably need it) (optional) IntelliJ Getting started According to the , here are the following things to include to use it for either Maven or Gradle. Personally, I’m using Gradle for this simply because I’ve never used it outside of Android Development. (Also, its the new sexy thing. Kinda?) official GitHub repo of spark-kotlin "com.sparkjava:spark-kotlin:1.0.0-alpha"...} dependencies {...compile The basics This is what attracted me to use it over spring-boot. It just looks so much easier and straightforward comparatively. Admittedly, I’ve never used spring-boot for server development so I could be totally wrong especially if/when it comes down to a large scale application. GET request That’s it! I could’ve just ended the article here and you can pretty much figure out the rest on your own. But yea, let’s explore into a few more interesting features. POST request For POST request, they work as easily too! All you need to know is that the request body can be retrieved with . request.body() More fun stuff redirect(), params() Now, what if you want to have the same output for separate links? Well, you can just do . You can also get information from the URL through tag. Something like this… redirect("/path") params(":path") Instance API You can also have a separate instance API that is running on a different port or with a different setting than the static API simply by declaring it as a separate variable. Of course, there are a lot of more advanced features (such as session, uri, etc.) that I did not cover. Feel free to explore them on your own following the . README of the repo From here on out, I’m including some relevant but not exactly spark-kotlin stuff on it. Dealing with JSON In many (or most) occasions, both requests and responses will be in JSON format. Here’s where ’ comes in handy. It is really easy to use and had a wide range of support. I put together a simple example below to show how it is and can be used. Google Developers Gson library Unit testing It took me a while to find a testing library that works as easily as I wished. This is a test library made specifically for the spark framework by called . Despegar spark-test A few things to keep in mind though: This is a Java library made for instead of spark-java spark-kotlin The server needs to be running on the background (in my case, on port 4567) for this to work Unable to attach a request body for DELETE request Note: As mentioned at the time of writing, the DELETE request is unable to attach any kind of request body to it making it hard to test your DELETE request. Personally, I use different URL each feature so I just redirect a POST request from the same url to the DELETE request and test it through the POST request instead. Not ideal, but it works for now. About me I currently work at Apple Inc. on the role of Siri Language Engineer as an Independent Contractor through AdvantisGlobal. I spend a lot of my free time experimenting and building new things with technologies I find fun and interesting. Follow my exploration journey or on . here GitHub References by Kotlin WebApp Tutorial Wayne Ellis by Build REST Service with Kotlin, Spark Java and Requery Vaclav Souhrada
