Module io.helidon.webclient

Package io.helidon.webclient

Class WebClient.Builder

java.lang.Object

io.helidon.webclient.WebClient.Builder

All Implemented Interfaces:

io.helidon.common.Builder<WebClient.Builder,WebClient>, MediaContextBuilder<WebClient.Builder>, ParentingMediaContextBuilder<WebClient.Builder>, Supplier<WebClient>

Enclosing interface:

WebClient

public static final class WebClient.Builder
extends Object
implements io.helidon.common.Builder<WebClient.Builder,WebClient>, ParentingMediaContextBuilder<WebClient.Builder>, MediaContextBuilder<WebClient.Builder>

Fluent API builder for WebClient.

Method Summary

Modifier and Type	Method	Description
WebClient.Builder	addCookie(String name, String value)	Add a default cookie.
WebClient.Builder	addHeader(String header, String... value)	Add a default header (such as accept).
WebClient.Builder	addMediaSupport(MediaSupport mediaSupport)
WebClient.Builder	addReader(MessageBodyReader<?> reader)
WebClient.Builder	addService(WebClientService service)	Register new instance of WebClientService.
WebClient.Builder	addService(Supplier<? extends WebClientService> serviceSupplier)	Register new instance of WebClientService.
WebClient.Builder	addStreamReader(MessageBodyStreamReader<?> streamReader)
WebClient.Builder	addStreamWriter(MessageBodyStreamWriter<?> streamWriter)
WebClient.Builder	addWriter(MessageBodyWriter<?> writer)
WebClient.Builder	baseUri(String uri)	Sets base uri for each request.
WebClient.Builder	baseUri(URI uri)	Sets base uri for each request.
WebClient.Builder	baseUri(URL url)	Sets base url for each request.
WebClient	build()
WebClient.Builder	config(Config config)	Config of this client.
WebClient.Builder	connectTimeout(long amount, TimeUnit unit)	Sets new connection timeout.
WebClient.Builder	context(Context context)	Sets specific context which should be used in requests.
WebClient.Builder	followRedirects(boolean follow)	Sets if redirects should be followed or not.
WebClient.Builder	keepAlive(boolean keepAlive)	Set whether connection to server should be kept alive after request.
WebClient.Builder	mediaContext(MediaContext mediaContext)
WebClient.Builder	proxy(Proxy proxy)	Sets new proxy which will used for the requests.
WebClient.Builder	readTimeout(long amount, TimeUnit unit)	Sets new read timeout.
WebClient.Builder	tls(WebClientTls webClientTls)	Sets new WebClientTls instance which contains ssl configuration.
WebClient.Builder	userAgent(String userAgent)	Sets user agent name.
WebClient.Builder	useSystemServiceLoader(boolean useServiceLoader)	Sets if Java Service loader should be used to load all WebClientServiceProvider.
WebClient.Builder	validateHeaders(boolean validate)	Whether to validate header names.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.helidon.common.Builder

get, identity, update

Method Details

build

public WebClient build()

Specified by:

build in interface io.helidon.common.Builder<WebClient.Builder,WebClient>

addService

public WebClient.Builder addService(WebClientService service)

Register new instance of WebClientService.

Parameters:

service - client service instance

Returns:

updated builder instance

addService

public WebClient.Builder addService(Supplier<? extends WebClientService> serviceSupplier)

Register new instance of WebClientService.

Parameters:

serviceSupplier - client service instance

Returns:

updated builder instance

useSystemServiceLoader

public WebClient.Builder useSystemServiceLoader(boolean useServiceLoader)

Sets if Java Service loader should be used to load all WebClientServiceProvider.

Parameters:

useServiceLoader - whether to use the Java Service loader

Returns:

updated builder instance

proxy

public WebClient.Builder proxy(Proxy proxy)

Sets new proxy which will used for the requests.

Parameters:

proxy - proxy instance

Returns:

updated builder instance

mediaContext

public WebClient.Builder mediaContext(MediaContext mediaContext)

Specified by:

mediaContext in interface ParentingMediaContextBuilder<WebClient.Builder>

addMediaSupport

public WebClient.Builder addMediaSupport(MediaSupport mediaSupport)

Specified by:

addMediaSupport in interface MediaContextBuilder<WebClient.Builder>

addReader

public WebClient.Builder addReader(MessageBodyReader<?> reader)

Specified by:

addReader in interface MediaContextBuilder<WebClient.Builder>

addStreamReader

public WebClient.Builder addStreamReader(MessageBodyStreamReader<?> streamReader)

Specified by:

addStreamReader in interface MediaContextBuilder<WebClient.Builder>

addWriter

public WebClient.Builder addWriter(MessageBodyWriter<?> writer)

Specified by:

addWriter in interface MediaContextBuilder<WebClient.Builder>

addStreamWriter

public WebClient.Builder addStreamWriter(MessageBodyStreamWriter<?> streamWriter)

Specified by:

addStreamWriter in interface MediaContextBuilder<WebClient.Builder>

config

public WebClient.Builder config(Config config)

Config of this client.

Parameters:

config - client config

Returns:

updated builder instance

connectTimeout

public WebClient.Builder connectTimeout(long amount,
 TimeUnit unit)

Sets new connection timeout.

Parameters:

amount - amount of time

unit - time unit

Returns:

updated builder instance

readTimeout

public WebClient.Builder readTimeout(long amount,
 TimeUnit unit)

Sets new read timeout.

Parameters:

amount - amount of time

unit - time unit

Returns:

updated builder instance

tls

public WebClient.Builder tls(WebClientTls webClientTls)

Sets new WebClientTls instance which contains ssl configuration.

Parameters:

webClientTls - tls instance

Returns:

updated builder instance

context

public WebClient.Builder context(Context context)

Sets specific context which should be used in requests.

Parameters:

context - context

Returns:

updated builder instance

addCookie

public WebClient.Builder addCookie(String name,
 String value)

Add a default cookie.

Parameters:

name - cookie name

value - cookie value

Returns:

updated builder instance

addHeader

public WebClient.Builder addHeader(String header,
 String... value)

Add a default header (such as accept).

Parameters:

header - header name

value - header values

Returns:

updated builder instance

baseUri

public WebClient.Builder baseUri(URI uri)

Sets base uri for each request.

Parameters:

uri - base uri

Returns:

updated builder instance

baseUri

public WebClient.Builder baseUri(String uri)

Sets base uri for each request.

Parameters:

uri - base uri

Returns:

updated builder instance

baseUri

public WebClient.Builder baseUri(URL url)

Sets base url for each request.

Parameters:

url - base url

Returns:

updated builder instance

followRedirects

public WebClient.Builder followRedirects(boolean follow)

Sets if redirects should be followed or not.

Parameters:

follow - follow redirects

Returns:

updated builder instance

userAgent

public WebClient.Builder userAgent(String userAgent)

Sets user agent name.

Parameters:

userAgent - user agent

Returns:

updated builder instance

keepAlive

public WebClient.Builder keepAlive(boolean keepAlive)

Set whether connection to server should be kept alive after request. This also sets header Http.Header.CONNECTION to keep-alive.

Parameters:

keepAlive - keep connection alive

Returns:

updated builder instance

validateHeaders

public WebClient.Builder validateHeaders(boolean validate)

Whether to validate header names. Defaults to true.

Parameters:

validate - whether to validate the header name contains only allowed characters

Returns:

updated builder instance