Package software.amazon.awssdk.protocols.json

Class BaseAwsJsonProtocolFactory.Builder<SubclassT extends BaseAwsJsonProtocolFactory.Builder>

java.lang.Object

software.amazon.awssdk.protocols.json.BaseAwsJsonProtocolFactory.Builder<SubclassT>

Direct Known Subclasses:

AwsJsonProtocolFactory.Builder

Enclosing class:

BaseAwsJsonProtocolFactory

public abstract static class BaseAwsJsonProtocolFactory.Builder<SubclassT extends BaseAwsJsonProtocolFactory.Builder>
extends Object

Builder for AwsJsonProtocolFactory.

Field Summary

Fields

Modifier and Type	Field	Description
protected Supplier<ProtocolUnmarshallDependencies>	protocolUnmarshallDependencies

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Builder()

Method Summary

Modifier and Type	Method	Description
SubclassT	clientConfiguration(SdkClientConfiguration clientConfiguration)	Sets the SdkClientConfiguration which contains the service endpoint.
SubclassT	contentType(String contentType)	ContentType of the client (By default it is used from BaseAwsJsonProtocolFactory.AWS_JSON ).
SubclassT	customErrorCodeFieldName(String customErrorCodeFieldName)	Custom field name containing the error code that identifies the exception.
SubclassT	defaultServiceExceptionSupplier(Supplier<SdkPojo> exceptionBuilderSupplier)	A supplier for the services base exception builder.
SubclassT	hasAwsQueryCompatible(boolean hasAwsQueryCompatible)	Provides a check on whether AwsQueryCompatible trait is found in Metadata.
SubclassT	protocol(AwsJsonProtocol protocol)
protected SubclassT	protocolUnmarshallDependencies(Supplier<ProtocolUnmarshallDependencies> protocolUnmarshallDependencies)	Provides the unmarshalling dependencies instance.
SubclassT	protocolVersion(String protocolVersion)	Protocol version of the client (right now supports JSON 1.0 and JSON 1.1).
SubclassT	registerModeledException(ExceptionMetadata errorMetadata)	Deprecated. Users should favor using BaseAwsJsonProtocolFactory.createErrorResponseHandler(JsonOperationMetadata, Function), which allows the creation of an error unmarshaller that uses a mapping function to map from error code to the associated ExceptionMetadata.

Methods inherited from class java.lang.Object

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

Field Detail

protocolUnmarshallDependencies

protected Supplier<ProtocolUnmarshallDependencies> protocolUnmarshallDependencies

Constructor Detail

Builder

protected Builder()

Method Detail

registerModeledException

@Deprecated
public final SubclassT registerModeledException(ExceptionMetadata errorMetadata)

Deprecated.

Users should favor using BaseAwsJsonProtocolFactory.createErrorResponseHandler(JsonOperationMetadata, Function), which allows the creation of an error unmarshaller that uses a mapping function to map from error code to the associated ExceptionMetadata.

Registers a new modeled exception by the error code.

Parameters:

errorMetadata - Metadata to unmarshall the modeled exception.

Returns:

This builder for method chaining.

defaultServiceExceptionSupplier

public final SubclassT defaultServiceExceptionSupplier(Supplier<SdkPojo> exceptionBuilderSupplier)

A supplier for the services base exception builder. This is used when we can't identify any modeled exception to unmarshall into.

Parameters:

exceptionBuilderSupplier - Suppplier of the base service exceptions Builder.

Returns:

This builder for method chaining.

protocol

public final SubclassT protocol(AwsJsonProtocol protocol)

Parameters:

protocol - Protocol of the client (i.e. REST or RPC).

Returns:

This builder for method chaining.

protocolVersion

public final SubclassT protocolVersion(String protocolVersion)

Protocol version of the client (right now supports JSON 1.0 and JSON 1.1). Used to determine content type.

Parameters:

protocolVersion - JSON protocol version.

Returns:

This builder for method chaining.

contentType

public final SubclassT contentType(String contentType)

ContentType of the client (By default it is used from BaseAwsJsonProtocolFactory.AWS_JSON ). Used to determine content type.

Parameters:

contentType - JSON protocol contentType.

Returns:

This builder for method chaining.

customErrorCodeFieldName

public final SubclassT customErrorCodeFieldName(String customErrorCodeFieldName)

Custom field name containing the error code that identifies the exception. Currently only used by Glacier which uses the "code" field instead of the traditional "__type".

Parameters:

customErrorCodeFieldName - Custom field name to look for error code.

Returns:

This builder for method chaining.

clientConfiguration

public final SubclassT clientConfiguration(SdkClientConfiguration clientConfiguration)

Sets the SdkClientConfiguration which contains the service endpoint.

Parameters:

clientConfiguration - Configuration of the client.

Returns:

This builder for method chaining.

hasAwsQueryCompatible

public final SubclassT hasAwsQueryCompatible(boolean hasAwsQueryCompatible)

Provides a check on whether AwsQueryCompatible trait is found in Metadata. If true, custom error codes can be provided

Parameters:

hasAwsQueryCompatible - boolean of whether the AwsQueryCompatible trait is found

Returns:

This builder for method chaining.

protocolUnmarshallDependencies

protected final SubclassT protocolUnmarshallDependencies(Supplier<ProtocolUnmarshallDependencies> protocolUnmarshallDependencies)

Provides the unmarshalling dependencies instance.

Parameters:

protocolUnmarshallDependencies - the set of dependencies used to create an unmarshaller

Returns:

This builder for method chaining.