Kotlin DSL http client

License	Apache License 2.0
GroupId	io.github.rybalkinsd
ArtifactId	kohttp
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

Filename	Size
kohttp-0.12.0.pom
kohttp-0.12.0.jar	146 KB
kohttp-0.12.0-sources.jar	31 KB
kohttp-0.12.0-javadoc.jar	261 bytes

How to add to project

Apache Maven

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

Gradle Groovy

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

Gradle Kotlin

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

Apache Buildr

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

Apache Ivy

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

Groovy Grape

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

Scala SBT

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

Leiningen

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

Dependencies

compile (2)

Group / Artifact	Type	Version
org.jetbrains.kotlinx : kotlinx-coroutines-core	jar	1.2.1
com.squareup.okhttp3 : okhttp	jar	3.14.2

runtime (1)

Group / Artifact	Type	Version
org.jetbrains.kotlin : kotlin-stdlib-jdk8	jar	1.3.50

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
0.10.0 Jul 1, 2019
0.9.0 Jun 7, 2019
0.8.0 Apr 17, 2019
0.7.1 Jan 9, 2019
0.7.0 Jan 7, 2019
0.6.0 Dec 24, 2018
0.5.0 Dec 7, 2018
0.4.0 Nov 2, 2018
0.3.3 Oct 26, 2018
0.3.2 Oct 22, 2018
0.3.1 Oct 9, 2018
0.3.0 Oct 8, 2018
0.2.0 Sep 11, 2018
0.1.0 Aug 22, 2018
0.0.4 Aug 8, 2018
0.0.3 Jul 27, 2018
0.0.1 Jul 27, 2018