com.philiprehberger:http-client
v0.1.7680 downloadsMIT
Lightweight HTTP client DSL with retry, timeout, and JSON support
$
implementation com.philiprehberger:http-clientREADME
http-client
Lightweight HTTP client DSL with retry, timeout, and JSON support.
Installation
Gradle (Kotlin DSL)
implementation("com.philiprehberger:http-client:0.1.6")
Maven
<dependency>
<groupId>com.philiprehberger</groupId>
<artifactId>http-client</artifactId>
<version>0.1.6</version>
</dependency>
Usage
import com.philiprehberger.httpclient.*
val client = httpClient {
baseUrl = "https://api.example.com"
timeout = 10.seconds
defaultHeaders["Authorization"] = "Bearer $token"
}
val users = client.get("/users") { query("page", "1") }
val created = client.post("/users") { json(CreateUserRequest("Alice")) }
API
| Function / Class | Description |
|---|---|
httpClient { } | Create a configured HTTP client |
HttpClient.get(path) { } | GET request |
HttpClient.post(path) { json(body) } | POST with JSON body |
RequestBuilder.query(key, value) | Add query parameter |
RequestBuilder.header(name, value) | Add header |
RequestBuilder.form(vararg pairs) | Form-encoded body |
HttpResponse.json<T>() | Deserialize response body |
HttpResponse.isSuccess() | Check 2xx status |
HttpException | Thrown for non-2xx responses |
Development
./gradlew test
./gradlew build
Support
If you find this project useful: