com.microsoft.azure

Class AzureResponseBuilder<T,E extends RestException>

java.lang.Object

com.microsoft.azure.AzureResponseBuilder<T,E>

Type Parameters:

T - the return type from caller.

E - the exception to throw in case of error.

All Implemented Interfaces:

ResponseBuilder<T,E>

public final class AzureResponseBuilder<T,E extends RestException>
extends Object
implements ResponseBuilder<T,E>

The builder for building a ServiceResponse customized for Azure.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AzureResponseBuilder.Factory A factory to create an Azure response builder.

Method Summary

Modifier and Type	Method and Description
ServiceResponse<T>	build(retrofit2.Response<okhttp3.ResponseBody> response) Build a ServiceResponse instance from a REST call response and a possible error.
ServiceResponse<T>	buildEmpty(retrofit2.Response<Void> response) Build a ServiceResponse instance from a REST call response and a possible error, which does not have a response body.
<THeader> ServiceResponseWithHeaders<T,THeader>	buildEmptyWithHeaders(retrofit2.Response<Void> response, Class<THeader> headerType) Build a ServiceResponseWithHeaders instance from a REST call response, a header in JSON format, and a possible error, which does not have a response body.
<THeader> ServiceResponseWithHeaders<T,THeader>	buildWithHeaders(retrofit2.Response<okhttp3.ResponseBody> response, Class<THeader> headerType) Build a ServiceResponseWithHeaders instance from a REST call response, a header in JSON format, and a possible error.
ResponseBuilder<T,E>	register(int statusCode, Type type) Register a mapping from a response status code to a response destination type.
ResponseBuilder<T,E>	registerError(Class<? extends RestException> type) Register a destination type for errors with models.
AzureResponseBuilder<T,E>	withThrowOnGet404(boolean throwOnGet404) Specifies whether to throw on 404 responses from a GET call.

Methods inherited from class java.lang.Object

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

Method Detail

register

public ResponseBuilder<T,E> register(int statusCode,
                                     Type type)

Description copied from interface: ResponseBuilder

Register a mapping from a response status code to a response destination type.

Specified by:

register in interface ResponseBuilder<T,E extends RestException>

Parameters:

statusCode - the status code.

type - the type to deserialize.

Returns:

the same builder instance.

registerError

public ResponseBuilder<T,E> registerError(Class<? extends RestException> type)

Description copied from interface: ResponseBuilder

Register a destination type for errors with models.

Specified by:

registerError in interface ResponseBuilder<T,E extends RestException>

Parameters:

type - the type to deserialize.

Returns:

the same builder instance.

build

public ServiceResponse<T> build(retrofit2.Response<okhttp3.ResponseBody> response)
                         throws IOException

Description copied from interface: ResponseBuilder

Build a ServiceResponse instance from a REST call response and a possible error.

If the status code in the response is registered, the response will be considered valid and deserialized into the specified destination type. If the status code is not registered, the response will be considered invalid and deserialized into the specified error type if there is one. An AutoRestException is also thrown.

Specified by:

build in interface ResponseBuilder<T,E extends RestException>

Parameters:

response - the Response instance from REST call

Returns:

a ServiceResponse instance of generic type T

Throws:

IOException - exceptions from deserialization

buildEmpty

public ServiceResponse<T> buildEmpty(retrofit2.Response<Void> response)
                              throws E extends RestException,
                                     IOException

Description copied from interface: ResponseBuilder

Build a ServiceResponse instance from a REST call response and a possible error, which does not have a response body.

If the status code in the response is registered, the response will be considered valid. If the status code is not registered, the response will be considered invalid. An AutoRestException is also thrown.

Specified by:

buildEmpty in interface ResponseBuilder<T,E extends RestException>

Parameters:

response - the Response instance from REST call

Returns:

a ServiceResponse instance of generic type T

Throws:

E - exceptions from the REST call

IOException - exceptions from deserialization

E extends RestException

buildWithHeaders

public <THeader> ServiceResponseWithHeaders<T,THeader> buildWithHeaders(retrofit2.Response<okhttp3.ResponseBody> response,
                                                                        Class<THeader> headerType)
                                                                 throws IOException

Description copied from interface: ResponseBuilder

Build a ServiceResponseWithHeaders instance from a REST call response, a header in JSON format, and a possible error.

If the status code in the response is registered, the response will be considered valid and deserialized into the specified destination type. If the status code is not registered, the response will be considered invalid and deserialized into the specified error type if there is one. An AutoRestException is also thrown.

Specified by:

buildWithHeaders in interface ResponseBuilder<T,E extends RestException>

Type Parameters:

THeader - the type of the header

Parameters:

response - the Response instance from REST call

headerType - the type of the header

Returns:

a ServiceResponseWithHeaders instance of generic type T

Throws:

IOException - exceptions from deserialization

buildEmptyWithHeaders

public <THeader> ServiceResponseWithHeaders<T,THeader> buildEmptyWithHeaders(retrofit2.Response<Void> response,
                                                                             Class<THeader> headerType)
                                                                      throws IOException

Description copied from interface: ResponseBuilder

Build a ServiceResponseWithHeaders instance from a REST call response, a header in JSON format, and a possible error, which does not have a response body.

If the status code in the response is registered, the response will be considered valid. If the status code is not registered, the response will be considered invalid. An AutoRestException is also thrown.

Specified by:

buildEmptyWithHeaders in interface ResponseBuilder<T,E extends RestException>

Type Parameters:

THeader - the type of the header

Parameters:

response - the Response instance from REST call

headerType - the type of the header

Returns:

a ServiceResponseWithHeaders instance of generic type T

Throws:

IOException - exceptions from deserialization

withThrowOnGet404

public AzureResponseBuilder<T,E> withThrowOnGet404(boolean throwOnGet404)

Specifies whether to throw on 404 responses from a GET call.

Parameters:

throwOnGet404 - true if to throw; false to simply return null. Default is false.

Returns:

the response builder itself