Package org.apache.beam.sdk.io.aws2.common

Interface ClientBuilderFactory

All Known Implementing Classes:

ClientBuilderFactory.DefaultClientBuilder

public interface ClientBuilderFactory

Factory to build and configure any AwsClientBuilder using a specific ClientConfiguration or the globally provided settings in AwsOptions as fallback.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	ClientBuilderFactory.DefaultClientBuilder	Default implementation of ClientBuilderFactory.

Method Summary

Modifier and Type	Method	Description
static <BuilderT extends software.amazon.awssdk.awscore.client.builder.AwsClientBuilder<BuilderT,ClientT>,ClientT> ClientT	buildClient(AwsOptions options, BuilderT builder, ClientConfiguration config)	Utility to directly build a client of type ClientBuilderFactory using builder of ClientBuilderFactory.
void	checkConfiguration(ClientConfiguration config, AwsOptions defaults)	Check if all necessary configuration is available to create clients.
<BuilderT extends software.amazon.awssdk.awscore.client.builder.AwsClientBuilder<BuilderT,ClientT>,ClientT> BuilderT	create(BuilderT builder, ClientConfiguration config, AwsOptions defaults)	Configure a client builder ClientBuilderFactory using the provided ClientConfiguration and fall back to the global defaults in AwsOptions where necessary.
default <BuilderT extends software.amazon.awssdk.awscore.client.builder.AwsClientBuilder<BuilderT,ClientT>,ClientT> BuilderT	create(BuilderT builder, AwsOptions defaults)	Configure a client builder ClientBuilderFactory using the global defaults in AwsOptions.
static ClientBuilderFactory	defaultFactory()	The default ClientBuilderFactory instance.
static ClientBuilderFactory	getFactory(AwsOptions options)	Get a ClientBuilderFactory instance according to AwsOptions.getClientBuilderFactory().
static void	validate(AwsOptions options, ClientConfiguration config)	Utility to validate if all necessary configuration is available to create clients using the ClientBuilderFactory configured in AwsOptions.

Method Detail

create

default <BuilderT extends software.amazon.awssdk.awscore.client.builder.AwsClientBuilder<BuilderT,ClientT>,ClientT> BuilderT create(BuilderT builder,
                                                                                                                                                @Nullable
                                                                                                                                                AwsOptions defaults)

Configure a client builder ClientBuilderFactory using the global defaults in AwsOptions.

create

<BuilderT extends software.amazon.awssdk.awscore.client.builder.AwsClientBuilder<BuilderT,ClientT>,ClientT> BuilderT create(BuilderT builder,
                                                                                                                                        ClientConfiguration config,
                                                                                                                                        @Nullable
                                                                                                                                        AwsOptions defaults)

Configure a client builder ClientBuilderFactory using the provided ClientConfiguration and fall back to the global defaults in AwsOptions where necessary.

checkConfiguration

void checkConfiguration(ClientConfiguration config,
                        @Nullable
                        AwsOptions defaults)

Check if all necessary configuration is available to create clients.

Throws:

java.lang.RuntimeException - if configuration is incomplete.

defaultFactory

static ClientBuilderFactory defaultFactory()

The default ClientBuilderFactory instance.

getFactory

static ClientBuilderFactory getFactory(AwsOptions options)

Get a ClientBuilderFactory instance according to AwsOptions.getClientBuilderFactory().

validate

static void validate(AwsOptions options,
                     ClientConfiguration config)

Utility to validate if all necessary configuration is available to create clients using the ClientBuilderFactory configured in AwsOptions.

buildClient

static <BuilderT extends software.amazon.awssdk.awscore.client.builder.AwsClientBuilder<BuilderT,ClientT>,ClientT> ClientT buildClient(AwsOptions options,
                                                                                                                                                   BuilderT builder,
                                                                                                                                                   ClientConfiguration config)

Utility to directly build a client of type ClientBuilderFactory using builder of ClientBuilderFactory.

The client is created using the ClientBuilderFactory configured in AwsOptions with the provided ClientConfiguration and global defaults from AwsOptions.