Module io.avaje.http.client

Package io.avaje.http.client

Interface HttpClient

public interface HttpClient

The HTTP client context that we use to build and process requests.

   HttpClient client = HttpClient.builder()
       .baseUrl("http://localhost:8080")
       .bodyAdapter(new JacksonBodyAdapter())
       .build();

  HelloDto dto = client.request()
       .path("hello")
       .queryParam("name", "Rob")
       .queryParam("say", "Whats up")
       .GET()
       .bean(HelloDto.class);

 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	HttpClient.Builder	Builds the HttpClient.
static interface	HttpClient.GeneratedComponent	Components register Generated Client interface Providers
static interface	HttpClient.Metrics	Statistic metrics collected to provide an overview of activity of this client.

Method Summary

Modifier and Type	Method	Description
BodyAdapter	bodyAdapter()	Return the BodyAdapter that this client is using.
static HttpClient.Builder	builder()	Return the builder to config and build the client context.
<T> T	create(Class<T> clientInterface)	Return the http client API implementation.
HttpClient.Metrics	metrics()	Return the current aggregate metrics.
HttpClient.Metrics	metrics(boolean reset)	Return the current metrics with the option of resetting the underlying counters.
HttpClientRequest	request()	Create a new request.
UrlBuilder	url()	Returns a UrlBuilder to build a URL, considering the base URL.

Method Details

builder

static HttpClient.Builder builder()

Return the builder to config and build the client context.

   HttpClient client = HttpClient.builder()
       .baseUrl("http://localhost:8080")
       .bodyAdapter(new JacksonBodyAdapter())
       .build();

  HttpResponse<String> res = client.request()
       .path("hello")
       .GET().asString();

 

create

<T> T create(Class<T> clientInterface)

Return the http client API implementation.

Type Parameters:

T - The service type.

Parameters:

clientInterface - A @Client interface with annotated API methods.

Returns:

The http client API implementation.

request

HttpClientRequest request()

Create a new request.

url

UrlBuilder url()

Returns a UrlBuilder to build a URL, considering the base URL.

bodyAdapter

BodyAdapter bodyAdapter()

Return the BodyAdapter that this client is using.

metrics

HttpClient.Metrics metrics()

Return the current aggregate metrics.

These metrics are collected for all requests sent via this context.

metrics

HttpClient.Metrics metrics(boolean reset)

Return the current metrics with the option of resetting the underlying counters.

These metrics are collected for all requests sent via this context.