Skip to main content

HTTP Client API

PetarLib provides a wrapper around Java's HttpClient for simplified asynchronous HTTP requests with retry logic.

Overview​

HttpClientWrapper handles GET and POST requests asynchronously, with automatic retries on failure.

Usage​

Creating a Client​

import com.petarmc.lib.net.HttpClientWrapper;

HttpClientWrapper client = new HttpClientWrapper(3); // max 3 retries

GET Request​

CompletableFuture<String> future = client.get("https://api.example.com/data");
future.thenAccept(body -> {
    System.out.println("Response: " + body);
}).exceptionally(throwable -> {
    System.err.println("Request failed: " + throwable.getMessage());
    return null;
});

POST Request​

import java.net.http.HttpRequest;
import java.net.URI;

HttpRequest postRequest = HttpRequest.newBuilder()
    .uri(URI.create("https://api.example.com/post"))
    .POST(HttpRequest.BodyPublishers.ofString("{\"key\":\"value\"}"))
    .header("Content-Type", "application/json")
    .build();

CompletableFuture<String> future = client.post(postRequest);
// Handle response as above

Shutdown​

client.shutdown(); // Call when done to free resources

Features​

  • Asynchronous requests using CompletableFuture.
  • Automatic retries on failure (configurable max retries).
  • Logging of requests and errors.
  • Timeout settings (10s connect, 20s request).