com.azure.core.http

Class HttpPipelineBuilder

java.lang.Object

com.azure.core.http.HttpPipelineBuilder

public class HttpPipelineBuilder
extends Object

This class provides a fluent builder API to help aid the configuration and instantiation of the HttpPipeline, calling build constructs an instance of the pipeline.

A pipeline is configured with a HttpClient that sends the request, if no client is set a default is used. A pipeline may be configured with a list of policies that are applied to each request.

Code Samples

Create a pipeline without configuration

 HttpPipeline pipeline = new HttpPipelineBuilder().build();
 

Create a pipeline using the default HTTP client and a retry policy

 HttpPipeline pipeline = new HttpPipelineBuilder()
     .httpClient(HttpClient.createDefault())
     .policies(new RetryPolicy())
     .build();
 

See Also:

HttpPipeline

Constructor Summary

Constructors

Constructor and Description
HttpPipelineBuilder() Creates a new instance of HttpPipelineBuilder that can configure options for the HttpPipeline before creating an instance of it.

Method Summary

Modifier and Type	Method and Description
HttpPipeline	build() Creates an HttpPipeline based on options set in the builder.
HttpPipelineBuilder	clientOptions(ClientOptions clientOptions) Sets the ClientOptions that will configure the pipeline.
HttpPipelineBuilder	httpClient(HttpClient httpClient) Sets the HttpClient that the pipeline will use to send requests.
HttpPipelineBuilder	policies(HttpPipelinePolicy... policies) Adds policies to the set of policies that the pipeline will use when sending requests.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HttpPipelineBuilder

public HttpPipelineBuilder()

Creates a new instance of HttpPipelineBuilder that can configure options for the HttpPipeline before creating an instance of it.

Method Detail

build

public HttpPipeline build()

Creates an HttpPipeline based on options set in the builder. Every time build() is called, a new instance of HttpPipeline is created.

If HttpClient is not set then a default HttpClient is used.

Returns:

A HttpPipeline with the options set from the builder.

httpClient

public HttpPipelineBuilder httpClient(HttpClient httpClient)

Sets the HttpClient that the pipeline will use to send requests.

Parameters:

httpClient - The HttpClient the pipeline will use when sending requests.

Returns:

The updated HttpPipelineBuilder object.

policies

public HttpPipelineBuilder policies(HttpPipelinePolicy... policies)

Adds policies to the set of policies that the pipeline will use when sending requests.

Parameters:

policies - Policies to add to the policy set.

Returns:

The updated HttpPipelineBuilder object.

clientOptions

public HttpPipelineBuilder clientOptions(ClientOptions clientOptions)

Sets the ClientOptions that will configure the pipeline.

Parameters:

clientOptions - The ClientOptions that will configure the pipeline.

Returns:

The updated HttpPipelineBuilder object.