HttpBuilder (Groovy 6.0.0-SNAPSHOT)

groovy.http.HttpBuilder

@Incubating
final class HttpBuilder
extends Object

Tiny DSL over JDK HttpClient.

Nested Class Summary

Nested classes
Modifiers	Name	Description
`static class`	`HttpBuilder.Config`
`static class`	`HttpBuilder.RequestSpec`

Methods Summary

Methods
Type Params	Return Type	Name and description
	`HttpResult`	`delete(Object uri, Closure<?> spec)`
	`CompletableFuture<HttpResult>`	`deleteAsync(Object uri, Closure<?> spec)`
	`HttpResult`	`get(Object uri, Closure<?> spec)`
	`CompletableFuture<HttpResult>`	`getAsync(Object uri, Closure<?> spec)`
	`CompletableFuture<HttpStreamResult>`	`getStreamAsync(Object uri, Closure<?> spec)`
	`static HttpBuilder`	`http(Closure<?> spec)`
	`static HttpBuilder`	`http(String baseUri)`
	`HttpResult`	`patch(Object uri, Closure<?> spec)`
	`CompletableFuture<HttpResult>`	`patchAsync(Object uri, Closure<?> spec)`
	`HttpResult`	`post(Object uri, Closure<?> spec)`
	`CompletableFuture<HttpResult>`	`postAsync(Object uri, Closure<?> spec)`
	`CompletableFuture<HttpStreamResult>`	`postStreamAsync(Object uri, Closure<?> spec)`
	`HttpResult`	`put(Object uri, Closure<?> spec)`
	`CompletableFuture<HttpResult>`	`putAsync(Object uri, Closure<?> spec)`
	`HttpResult`	`request(String method, Object uri, Closure<?> spec)`
	`CompletableFuture<HttpResult>`	`requestAsync(String method, Object uri, Closure<?> spec)`
	`CompletableFuture<HttpStreamResult>`	`streamAsync(String method, Object uri, Closure<?> spec)` Streams the response body without buffering.

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class Object`	`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- Method Detail
  - HttpResult delete(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - CompletableFuture<HttpResult> deleteAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - HttpResult get(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - CompletableFuture<HttpResult> getAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - CompletableFuture<HttpStreamResult> getStreamAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - static HttpBuilder http(@DelegatesTo(value=Config, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - static HttpBuilder http(String baseUri)
  - HttpResult patch(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - CompletableFuture<HttpResult> patchAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - HttpResult post(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - CompletableFuture<HttpResult> postAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - CompletableFuture<HttpStreamResult> postStreamAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - HttpResult put(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - CompletableFuture<HttpResult> putAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - HttpResult request(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - CompletableFuture<HttpResult> requestAsync(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
  - CompletableFuture<HttpStreamResult> streamAsync(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
    Closure<?> spec)
    
    Streams the response body without buffering. Returns an HttpStreamResult whose bodyAsPublisher() delivers List<ByteBuffer> chunks as they arrive — enabling for await (chunk in result.bodyAsPublisher()) via the FlowPublisherAdapter.
    Streaming always uses HttpResponse.BodyHandlers.ofPublisher(); any bodyHandler configured on the RequestSpec is ignored.

Summary:
Nested
Method

| Detail:
Method

[Groovy] Class HttpBuilder

Nested Class Summary

Methods Summary

Inherited Methods Summary

Method Detail

HttpResult delete(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> deleteAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

HttpResult get(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> getAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpStreamResult> getStreamAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

static HttpBuilder http(@DelegatesTo(value=Config, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

static HttpBuilder http(String baseUri)

HttpResult patch(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> patchAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

HttpResult post(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> postAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpStreamResult> postStreamAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

HttpResult put(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> putAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

HttpResult request(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> requestAsync(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpStreamResult> streamAsync(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

[Groovy] Class HttpBuilder

Nested Class Summary

Methods Summary

Inherited Methods Summary

Method Detail

HttpResult delete(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

CompletableFuture<HttpResult> deleteAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

HttpResult get(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

CompletableFuture<HttpResult> getAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

CompletableFuture<HttpStreamResult> getStreamAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

static HttpBuilder http(@DelegatesTo(value=Config, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

static HttpBuilder http(String baseUri)

HttpResult patch(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

CompletableFuture<HttpResult> patchAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

HttpResult post(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

CompletableFuture<HttpResult> postAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

CompletableFuture<HttpStreamResult> postStreamAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

HttpResult put(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

CompletableFuture<HttpResult> putAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

HttpResult request(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

CompletableFuture<HttpResult> requestAsync(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

CompletableFuture<HttpStreamResult> streamAsync(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)Closure<?> spec)

HttpResult delete(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> deleteAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

HttpResult get(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> getAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpStreamResult> getStreamAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

static HttpBuilder http(@DelegatesTo(value=Config, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

HttpResult patch(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> patchAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

HttpResult post(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> postAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpStreamResult> postStreamAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

HttpResult put(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> putAsync(Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

HttpResult request(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpResult> requestAsync(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)

CompletableFuture<HttpStreamResult> streamAsync(String method, Object uri, @DelegatesTo(value=RequestSpec, strategy=Closure.DELEGATE_FIRST)
Closure<?> spec)