fuel-kotlinx-serialization

The kotlinx-serialization extension package for Fuel.

Installation

You can download and install fuel-kotlinx-serialization with Maven and Gradle. The kotlinx-serialization package has the following dependencies:

  1. implementation 'com.github.kittinunf.fuel:fuel:<latest-version>'
  2. implementation 'com.github.kittinunf.fuel:fuel-kotlinx-serialization:<latest-version>'

Usage

  1. @Serializabledata class HttpBinUserAgentModel(var userAgent: String = "")
  2. Fuel.get("/user-agent")    .responseObject<HttpBinUserAgentModel> { , , result -> }

This is by default strict and will reject unknown keys, for that you can pass a custom Json instance Json(strictMode = false) or use a built-in alternate like Json.nonstrict

  1. @Serializabledata class HttpBinUserAgentModel(var userAgent: String = "")
  2. Fuel.get("/user-agent")    .responseObject<HttpBinUserAgentModel>(json = Json.nonstrict) { , , result -> }

kotlinx.serialization can not always guess the correct serialzer to use, when generics are involved for example

  1. @Serializabledata class HttpBinUserAgentModel(var userAgent: String = "")
  2. Fuel.get("/list/user-agent")    .responseObject<HttpBinUserAgentModel>(loader = HttpBinUserAgentModel.serializer().list) { , , result -> }

It can be used with coroutines by using kotlinxDeserializerOf() it takes the same json and loader as parameters

  1. @Serializabledata class HttpBinUserAgentModel(var userAgent: String = "")
  2. Fuel.get("/user-agent")    .awaitResponseObject<HttpBinUserAgentModel>(kotlinxDeserializerOf()) { , , result -> }