software.amazon.awssdk.protocols.xml

Class AwsXmlProtocolFactory

java.lang.Object

software.amazon.awssdk.protocols.xml.AwsXmlProtocolFactory

Direct Known Subclasses:

AwsS3ProtocolFactory

public class AwsXmlProtocolFactory
extends Object

Factory to generate the various protocol handlers and generators to be used for communicating with REST/XML services.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AwsXmlProtocolFactory.Builder<SubclassT extends AwsXmlProtocolFactory.Builder> Builder for AwsXmlProtocolFactory.

Field Summary

Fields

Modifier and Type	Field and Description
static OperationMetadataAttribute<String>	ROOT_MARSHALL_LOCATION_ATTRIBUTE Some services like Route53 specifies the location for the request shape.
static OperationMetadataAttribute<String>	XML_NAMESPACE_ATTRIBUTE Attribute for configuring the XML namespace to include in the xmlns attribute of the root element.

Method Summary

Modifier and Type	Method and Description
static AwsXmlProtocolFactory.Builder	builder()
<T extends AwsResponse> HttpResponseHandler<Response<T>>	createCombinedResponseHandler(Supplier<SdkPojo> pojoSupplier, XmlOperationMetadata staxOperationMetadata)
HttpResponseHandler<AwsServiceException>	createErrorResponseHandler()
protected Function<AwsXmlUnmarshallingContext,AwsServiceException>	createErrorTransformer()
ProtocolMarshaller<SdkHttpFullRequest>	createProtocolMarshaller(OperationInfo operationInfo) Creates an instance of XmlProtocolMarshaller to be used for marshalling the request.
<T extends SdkPojo> HttpResponseHandler<T>	createResponseHandler(Function<SdkHttpFullResponse,SdkPojo> pojoSupplier, XmlOperationMetadata staxOperationMetadata)
<T extends SdkPojo> HttpResponseHandler<T>	createResponseHandler(Supplier<SdkPojo> pojoSupplier, XmlOperationMetadata staxOperationMetadata)
protected <T extends AwsResponse> Function<AwsXmlUnmarshallingContext,T>	createResponseTransformer(Supplier<SdkPojo> pojoSupplier)

Methods inherited from class java.lang.Object

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

Field Detail

XML_NAMESPACE_ATTRIBUTE

public static final OperationMetadataAttribute<String> XML_NAMESPACE_ATTRIBUTE

Attribute for configuring the XML namespace to include in the xmlns attribute of the root element.

ROOT_MARSHALL_LOCATION_ATTRIBUTE

public static final OperationMetadataAttribute<String> ROOT_MARSHALL_LOCATION_ATTRIBUTE

Some services like Route53 specifies the location for the request shape. This should be the root of the generated xml document. Other services Cloudfront, s3 don't specify location param for the request shape. For them, this value will be null.

Method Detail

createProtocolMarshaller

public ProtocolMarshaller<SdkHttpFullRequest> createProtocolMarshaller(OperationInfo operationInfo)

Creates an instance of XmlProtocolMarshaller to be used for marshalling the request.

Parameters:

operationInfo - Info required to marshall the request

createResponseHandler

public <T extends SdkPojo> HttpResponseHandler<T> createResponseHandler(Supplier<SdkPojo> pojoSupplier,
                                                                        XmlOperationMetadata staxOperationMetadata)

createResponseHandler

public <T extends SdkPojo> HttpResponseHandler<T> createResponseHandler(Function<SdkHttpFullResponse,SdkPojo> pojoSupplier,
                                                                        XmlOperationMetadata staxOperationMetadata)

createResponseTransformer

protected <T extends AwsResponse> Function<AwsXmlUnmarshallingContext,T> createResponseTransformer(Supplier<SdkPojo> pojoSupplier)

createErrorTransformer

protected Function<AwsXmlUnmarshallingContext,AwsServiceException> createErrorTransformer()

createErrorResponseHandler

public HttpResponseHandler<AwsServiceException> createErrorResponseHandler()

createCombinedResponseHandler

public <T extends AwsResponse> HttpResponseHandler<Response<T>> createCombinedResponseHandler(Supplier<SdkPojo> pojoSupplier,
                                                                                              XmlOperationMetadata staxOperationMetadata)

builder

public static AwsXmlProtocolFactory.Builder builder()