com.oracle.bmc.http.internal

Class ResponseHelper

java.lang.Object

com.oracle.bmc.http.internal.ResponseHelper

public class ResponseHelper
extends Object

A BmcException exception is thrown in response to failures from a REST endpoint. It contains the status code of the HTTP response as well as an application code and message describing the problem.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ResponseHelper.ErrorCodeAndMessage

Constructor Summary

Constructors

Constructor and Description
ResponseHelper()

Method Summary

Modifier and Type	Method and Description
static void	closeResponseSilently(javax.ws.rs.core.Response response) Closes a given Response and ignores any thrown exceptions.
static void	closeResponseSilentlyIfNotBuffered(@NonNull javax.ws.rs.core.Response response) Closes a Response silently if a Response is not buffered or is not backed by an unconsumed stream (e.g., for responses with no body).
static <T> T	readEntity(@NonNull javax.ws.rs.core.Response response, Class<T> entityType) Reads an entity out of the given response if its status code is 2xx or 304.
static <T> T	readEntity(@NonNull javax.ws.rs.core.Response response, javax.ws.rs.core.GenericType<T> entityType) Reads an entity out of the given response if its status code is 2xx or 304.
static void	readWithoutEntity(@NonNull javax.ws.rs.core.Response response) Simple response handler that just cleans up the response, assuming no entity needs to be read out.
static void	shouldAutoCloseResponseInputStream(boolean shouldAutoClose) Sets the boolean value to indicate if the SDK should auto-close the InputStream stream returned from the response once the stream has been read until the content-length of the stream Note : This has been added to automatically release connections from the connection pool when using the Apache Connector since the Apache Connector uses connection pooling by default
static void	throwIfNotSuccessful(@NonNull javax.ws.rs.core.Response response) Throws BmcException if the response status is not in the family Family.SUCCESSFUL, or is not Status.NOT_MODIFIED.

Methods inherited from class java.lang.Object

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

Constructor Detail

ResponseHelper

public ResponseHelper()

Method Detail

throwIfNotSuccessful

public static void throwIfNotSuccessful(@NonNull
                                        @NonNull javax.ws.rs.core.Response response)

Throws BmcException if the response status is not in the family Family.SUCCESSFUL, or is not Status.NOT_MODIFIED.

Parameters:

response - The response received.

readWithoutEntity

public static void readWithoutEntity(@NonNull
                                     @NonNull javax.ws.rs.core.Response response)

Simple response handler that just cleans up the response, assuming no entity needs to be read out.

Parameters:

response - the response

readEntity

public static <T> T readEntity(@NonNull
                               @NonNull javax.ws.rs.core.Response response,
                               javax.ws.rs.core.GenericType<T> entityType)

Reads an entity out of the given response if its status code is 2xx or 304. Must call throwIfNotSuccessful(Response) first.

Parameters:

response - the response

entityType - the type of the entity to read

Returns:

the entity (if the response’s status code was 2xx)

readEntity

public static <T> T readEntity(@NonNull
                               @NonNull javax.ws.rs.core.Response response,
                               Class<T> entityType)
                        throws BmcException

Reads an entity out of the given response if its status code is 2xx or 304. Must call throwIfNotSuccessful(Response) first.

Parameters:

response - the response

entityType - the type of the entity to read

Returns:

the entity (if the response’s status code was 2xx), or null if 304

Throws:

BmcException

closeResponseSilently

public static void closeResponseSilently(javax.ws.rs.core.Response response)

Closes a given Response and ignores any thrown exceptions. Closing a response is idempotent, so there is no harm in closing a Response once the response has been fully processed to ensure that the client connection is not left in use.

Parameters:

response - the response to close

closeResponseSilentlyIfNotBuffered

public static void closeResponseSilentlyIfNotBuffered(@NonNull
                                                      @NonNull javax.ws.rs.core.Response response)

Closes a Response silently if a Response is not buffered or is not backed by an unconsumed stream (e.g., for responses with no body).

Parameters:

response - the response to close

shouldAutoCloseResponseInputStream

public static void shouldAutoCloseResponseInputStream(boolean shouldAutoClose)

Sets the boolean value to indicate if the SDK should auto-close the InputStream stream returned from the response once the stream has been read until the content-length of the stream Note : This has been added to automatically release connections from the connection pool when using the Apache Connector since the Apache Connector uses connection pooling by default