Module io.avaje.http.client

Package io.avaje.http.client

package io.avaje.http.client

Provides a HTTP client with support for adapting body content (like JSON) to java types.

Uses the Java http client

   HttpClientContext ctx = HttpClientContext.newBuilder()
       .withBaseUrl("http://localhost:8080")
       .withBodyAdapter(new JacksonBodyAdapter(new ObjectMapper()))
       .build();

  HelloDto dto = ctx.request()
       .path("hello")
       .queryParam("say", "Ki ora")
       .get()
       .bean(HelloDto.class);

 

Interface Summary

Interface	Description
AuthToken	Represents an Authorization Bearer token that can be held on the context.
AuthTokenProvider	Use to obtain an Authorization bearer token that is expected to be used.
BodyAdapter	Adaptor between beans and content of a request or response.
BodyReader<T>	Read content as a java type.
BodyWriter	Writes beans as content for a specific content type.
HttpApi	Provides Http client service implementations for a given interface type.
HttpApiProvider<T>	Provides http client implementations for an interface.
HttpClientContext	The HTTP client context that we use to build and process requests.
HttpClientContext.Builder	Builds the HttpClientContext.
HttpClientRequest	Http request that is built and sent to the server.
HttpClientResponse	Controls how the response is processed including potential conversion into beans.
RequestIntercept	Interceptor for before the request is made and after the response is obtained.
RequestListener	Listen to responses.
RequestListener.Event	The response event details.

Class Summary

Class	Description
AuthToken.Basic	Standard AuthToken implementation.
BodyContent	Content of request or response body used for adapting to beans.
JacksonBodyAdapter	Jackson BodyAdapter to read and write beans as JSON.
PathConversion	Helper methods to convert common types to String path values.
RequestLogger	Logs request and response details for debug logging purposes.
UrlBuilder	Build a URL typically using a base url and adding path and query parameters.

Exception Summary

Exception	Description
HttpException	HTTP Exception with support for converting the error response body into a bean.