Kotlin DSL http client

License	Apache License 2.0
Categories	Jackson Data JSON
GroupId	io.github.rybalkinsd
ArtifactId	kohttp-jackson
Last Version	0.12.0
Release Date	May 23, 2020
Type	jar
Description	Kotlin DSL http client Kotlin DSL http client
Project URL	https://github.com/rybalkinsd/kohttp
Project Organization	io.github.rybalkinsd
Source Code Management	https://github.com/rybalkinsd/kohttp

Download kohttp-jackson

Filename	Size
kohttp-jackson-0.12.0.pom
kohttp-jackson-0.12.0.jar	7 KB
kohttp-jackson-0.12.0-sources.jar	1 KB
kohttp-jackson-0.12.0-javadoc.jar	261 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.rybalkinsd/kohttp-jackson/ -->
<dependency>
    <groupId>io.github.rybalkinsd</groupId>
    <artifactId>kohttp-jackson</artifactId>
    <version>0.12.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.rybalkinsd/kohttp-jackson/
implementation 'io.github.rybalkinsd:kohttp-jackson:0.12.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.rybalkinsd/kohttp-jackson/
implementation ("io.github.rybalkinsd:kohttp-jackson:0.12.0")

Apache Buildr

'io.github.rybalkinsd:kohttp-jackson:jar:0.12.0'

Apache Ivy

<dependency org="io.github.rybalkinsd" name="kohttp-jackson" rev="0.12.0">
  <artifact name="kohttp-jackson" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.rybalkinsd', module='kohttp-jackson', version='0.12.0')
)

Scala SBT

libraryDependencies += "io.github.rybalkinsd" % "kohttp-jackson" % "0.12.0"

Leiningen

[io.github.rybalkinsd/kohttp-jackson "0.12.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
io.github.rybalkinsd : kohttp	jar	0.12.0
com.fasterxml.jackson.core : jackson-databind	jar	2.9.9

runtime (2)

Group / Artifact	Type	Version
org.jetbrains.kotlin : kotlin-stdlib-jdk8	jar	1.3.50
com.fasterxml.jackson.module : jackson-module-kotlin	jar	2.9.9

Project Modules

There are no modules declared in this project.

Introduction

Kotlin DSL http client

Features

🔹 Developers Experience-driven library without verbosity.

🔹 Native way to use http client in Kotlin.

🔹 HTTP GET/POST/PUT/HEAD/DELETE/PATCH requests.

🔹 Asynchronous and blocking requests.

🔹 Upload files.

🔹 Logging - easily dump your http requests or convert them to cURL commands.

🔹 Minimal footprint.

Quick start

// Use String or URL extensions send simple request
val response = "https://my-host.com/users?admin=true".httpGet()

// Parse response with your favorite library
val users = response.toJson()

// Use sync or async methods to send your requests
// Configure method params, headers, cookies and body in a concise way
val notifications: List<Deferred<Response>> = users.forEach { user ->
    httpPostAsync {
        url("https://my-host.com/friends/push")
        
        param {
            "userId" to user[id]
            "eventType" to NewFriend
        }
        
        header {
            "locale" to "en_EN"
            cookie {
                "user_session" to "toFycNV"
                "authToken" to "d2dwa6011w96c93ct3e3493d4a1b5c8751563217409"
            }
        }
    }
}

Samples

• Android application
• Spring Boot application

About kohttp

• Kotlin weekly mentioned us
• Android weekly (CN) mentioned us
• Kotlin http client. Making kohttp 0.11.0 - medium post
• Write your Android network as Kotlin DSL - medium post
• Upload files to Google Drive with Kotlin - medium post
• Production Kotlin DSL (RU + subtitles) - Kotlin/Everywhere talk, YouTube

Installation

Gradle

Kotlin DSL:

implementation(group = "io.github.rybalkinsd", name = "kohttp", version = "0.12.0")

Groovy DSL:

implementation 'io.github.rybalkinsd:kohttp:0.12.0'

Maven:

<dependency>
  <groupId>io.github.rybalkinsd</groupId>
  <artifactId>kohttp</artifactId>
  <version>0.12.0</version>
</dependency>

Table of contents

• Synchronous calls
  • GET
  • POST
  • PUT
  • HEAD
  • DELETE
  • PATCH
  • Upload files
  • Generic requests
• Asynchronous calls
  • async GET
  • async POST
  • async PUT
  • async HEAD
  • async DELETE
  • async PATCH
  • async Upload files
  • async Generic requests
• Response usage
• Interceptors
• Customisation
• Experimental features
• Changelog

Versions

Version
0.12.0 May 23, 2020
0.11.1 Oct 27, 2019
0.11.0 Sep 11, 2019