Package org.springframework.graphql.client

Class AbstractGraphQlClientSyncBuilder<B extends AbstractGraphQlClientSyncBuilder<B>>

java.lang.Object

org.springframework.graphql.client.AbstractGraphQlClientSyncBuilder<B>

Type Parameters:

B - the type of builder

All Implemented Interfaces:

GraphQlClient.BaseBuilder<B>, GraphQlClient.SyncBuilder<B>

public abstract class AbstractGraphQlClientSyncBuilder<B extends AbstractGraphQlClientSyncBuilder<B>>
extends Object
implements GraphQlClient.SyncBuilder<B>

Abstract, base class for transport specific GraphQlClient.SyncBuilder implementations.

Subclasses must implement GraphQlClient.BaseBuilder.build() and call buildGraphQlClient(SyncGraphQlTransport) to obtain a default, transport agnostic GraphQlClient. A transport specific extension can then wrap this default tester by extending AbstractDelegatingGraphQlClient.

Since:

1.3.0

Author:

Rossen Stoyanchev

See Also:

• AbstractDelegatingGraphQlClient

Field Summary

Fields

Modifier and Type	Field	Description
protected static final boolean	jackson2Present

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractGraphQlClientSyncBuilder()	Default constructor for use from subclasses.

Method Summary

Modifier and Type	Method	Description
B	blockingTimeout(Duration blockingTimeout)	Configure a timeout to use for blocking execution.
protected GraphQlClient	buildGraphQlClient(SyncGraphQlTransport transport)	Build the default transport-agnostic client that subclasses can then wrap with AbstractDelegatingGraphQlClient.
B	documentSource(DocumentSource documentSource)	Configure a DocumentSource strategy to resolve a document by name.
protected Consumer<AbstractGraphQlClientSyncBuilder<?>>	getBuilderInitializer()	Return a Consumer to initialize new builders from "this" builder.
B	interceptor(SyncGraphQlClientInterceptor... interceptors)	Configure interceptors to be invoked before delegating to the SyncGraphQlTransport to perform the request.
B	interceptors(Consumer<List<SyncGraphQlClientInterceptor>> interceptorsConsumer)	Customize the list of interceptors.
B	scheduler(reactor.core.scheduler.Scheduler scheduler)	The scheduler to use for non-blocking execution with GraphQlClient.RequestSpec.execute() and GraphQlClient.RequestSpec.retrieve(String).
protected void	setJsonConverter(HttpMessageConverter<Object> converter)	Transport-specific subclasses can provide their JSON Encoder and Decoder for use at the client level, for mapping response data to some target entity type.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.graphql.client.GraphQlClient.BaseBuilder

build

Field Details

jackson2Present

protected static final boolean jackson2Present

Constructor Details

AbstractGraphQlClientSyncBuilder

protected AbstractGraphQlClientSyncBuilder()

Default constructor for use from subclasses.

Subclasses must set the transport to use before GraphQlClient.BaseBuilder.build() or during, by overriding GraphQlClient.BaseBuilder.build().

Method Details

interceptor

public B interceptor(SyncGraphQlClientInterceptor... interceptors)

Description copied from interface: GraphQlClient.SyncBuilder

Configure interceptors to be invoked before delegating to the SyncGraphQlTransport to perform the request.

Specified by:

interceptor in interface GraphQlClient.SyncBuilder<B extends AbstractGraphQlClientSyncBuilder<B>>

Parameters:

interceptors - the interceptors to add

Returns:

this builder

interceptors

public B interceptors(Consumer<List<SyncGraphQlClientInterceptor>> interceptorsConsumer)

Description copied from interface: GraphQlClient.SyncBuilder

Customize the list of interceptors. The provided list is "live", so the consumer can inspect and insert interceptors accordingly.

Specified by:

interceptors in interface GraphQlClient.SyncBuilder<B extends AbstractGraphQlClientSyncBuilder<B>>

Parameters:

interceptorsConsumer - consumer to customize the interceptors with

Returns:

this builder

documentSource

public B documentSource(DocumentSource documentSource)

Description copied from interface: GraphQlClient.BaseBuilder

Configure a DocumentSource strategy to resolve a document by name. For use within GraphQlClient.documentName(String).

By default, this is set to ResourceDocumentSource with classpath location "graphql-documents/" and ResourceDocumentSource.FILE_EXTENSIONS as extensions.

Specified by:

documentSource in interface GraphQlClient.BaseBuilder<B extends AbstractGraphQlClientSyncBuilder<B>>

Parameters:

documentSource - the strategy for resolving documents by their names

scheduler

public B scheduler(reactor.core.scheduler.Scheduler scheduler)

Description copied from interface: GraphQlClient.SyncBuilder

The scheduler to use for non-blocking execution with GraphQlClient.RequestSpec.execute() and GraphQlClient.RequestSpec.retrieve(String).

By default this is set to Schedulers.boundedElastic().

Specified by:

scheduler in interface GraphQlClient.SyncBuilder<B extends AbstractGraphQlClientSyncBuilder<B>>

Parameters:

scheduler - the scheduler

blockingTimeout

public B blockingTimeout(@Nullable
 Duration blockingTimeout)

Description copied from interface: GraphQlClient.BaseBuilder

Configure a timeout to use for blocking execution.

By default this is not set, in which case the behavior depends on connection and request timeout settings of the underlying transport. We recommend configuring timeout values directly if possible on the underlying transport library such an HTTP client library as that can provide more control over such settings.

Specified by:

blockingTimeout in interface GraphQlClient.BaseBuilder<B extends AbstractGraphQlClientSyncBuilder<B>>

Parameters:

blockingTimeout - the timeout to use

setJsonConverter

protected void setJsonConverter(HttpMessageConverter<Object> converter)

Transport-specific subclasses can provide their JSON Encoder and Decoder for use at the client level, for mapping response data to some target entity type.

Parameters:

converter - the message converter for JSON payloads

buildGraphQlClient

protected GraphQlClient buildGraphQlClient(SyncGraphQlTransport transport)

Build the default transport-agnostic client that subclasses can then wrap with AbstractDelegatingGraphQlClient.

Parameters:

transport - the GraphQL transport to be used by the client

getBuilderInitializer

protected Consumer<AbstractGraphQlClientSyncBuilder<?>> getBuilderInitializer()

Return a Consumer to initialize new builders from "this" builder.