Package com.commercetools.docs.meta

Class ExceptionDocumentation

java.lang.Object

com.commercetools.docs.meta.ExceptionDocumentation

public class ExceptionDocumentation
extends Object

Table of content

• Exceptions
• Errors
• Custom HttpExceptionFactory

The exception hierarchy documentation.

Exceptions

The SDK makes use of exceptions from the Java JDK, such as IllegalArgumentException, and provides own exceptions which all inherit from BaseException.

Problems concerning the ApiHttpClient throw a ApiHttpException.

JSON serializing and deserializing problems throw JsonException.

ApiHttpException is a base exception for all error responses from Composable Commerce (HTTP status code >= 400).

ApiClientException expresses errors which can be recovered by the client side (HTTP status code >= 400 and < 500). ApiServerException is for server errors.

Errors

If a command cannot be performed due to unfulfilled preconditions the API can return one error response with multiple errors (listing of error codes). The SDK will then put a BadRequestException into a CompletionStage.

Custom HttpExceptionFactory

In case a response with a status code of 400 or higher are treated as errors and raise exceptions. These exceptions are created by the DefaultHttpExceptionFactory. In case you want to override the handling you have to implement this interface and override the default methods if necessary.

import static org.assertj.core.api.Assertions.assertThatExceptionOfType;

import com.commercetools.api.client.ProjectApiRoot;

import com.commercetools.api.defaultconfig.ApiRootBuilder;

import com.commercetools.api.defaultconfig.ServiceRegion;

import io.vrap.rmf.base.client.*;

import io.vrap.rmf.base.client.error.HttpExceptionFactory;

import org.junit.jupiter.api.Test;

public class HttpExceptionFactoryTest {

    static class CustomExceptionFactory implements HttpExceptionFactory {
        @Override
        public ApiHttpException create(ApiHttpRequest request, ApiHttpResponse<byte[]> response) {
            return new ApiHttpException(response.getStatusCode(), request.getSecuredBody(), response.getHeaders(),
                "something bad happened", response, request);
        }

        @Override
        public ResponseSerializer getResponseSerializer() {
            return ResponseSerializer.of();
        }
    }

    @Test
    public void customFactory() {

        ProjectApiRoot client = ApiRootBuilder.of()
                .defaultClient(ServiceRegion.GCP_EUROPE_WEST1.getApiUrl())
                .withHttpExceptionFactory(CustomExceptionFactory::new)
                .build("my-project-key");

        assertThatExceptionOfType(ApiHttpException.class).isThrownBy(() -> client.get().executeBlocking())
                .withMessageStartingWith("detailMessage: something bad happened");

    }
}
See the test code.

Constructor Summary

Constructors

Constructor	Description
ExceptionDocumentation()

Method Summary

Methods inherited from class java.lang.Object

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

Constructor Details

ExceptionDocumentation

public ExceptionDocumentation()