RestTemplate: exchange () vs postForEntity () vs execute ()

Если вы посмотрите на реализацию как postForEntity, так и метода exchange, вы увидите, что оба используют методы выполнения в задней части. Использование метода обмена даст вам больше свободы для вызова различных методов http.

RestTemplate - это клиент синхронный для выполнения HTTP-запросов. Он предлагает шаблоны для общих сценариев для каждого метода HTTP в дополнение к обобщенным методам exchange(...) и execute(...), которые поддерживают менее частые случаи.

Документация по интеграции Spring суммирует использование каждого метода:

postForEntity

Create a new resource via POST and return the representation from the response.

exchange

More generalized, and less opinionated version, of the above methods that provides extra flexibility when needed. It accepts RequestEntity, including HTTP method, URL, headers, and body as input, and returns a ResponseEntity.

These methods allow the use of ParameterizedTypeReference instead of Class to specify a response type with generics.

execute

The most generalized way to perform a request, with full control over request preparation and response extraction via callback interfaces.

В конце концов, оба метода postForEntity(...), exchange(...) и execute(...) вызовут защищенный метод doExecute(...), который будет выполнять фактический HTTP-запрос. Вы можете проверить исходный код для подробностей

RestTemplate - очень универсальный объект.

Начнем с execute, так как это наиболее общий метод:

execute(String url, HttpMethod method, @Nullable RequestCallback requestCallback,
        @Nullable ResponseExtractor<T> responseExtractor, Object... uriVariables)

Обратите внимание, что uriVariables также может передаваться как Map.

execute разработан для применения в самых разнообразных возможных сценариях:

• Первый и второй параметры допускают любую допустимую комбинацию URL-адреса и метода.
• Запрос можно изменить множеством различных способов, передав собственный RequestCallback (@FunctionalInterface с одним методом doWithRequest(ClientHttpRequest request)) перед его отправкой.
• Ответ, возвращаемый удаленным ресурсом, может быть десериализован любым необходимым способом путем передачи настраиваемого ResponseExtractor.

Сравните это с exchange:

exchange(String url, HttpMethod method, @Nullable HttpEntity<?> requestEntity,
         Class<T> responseType, Object... uriVariables)

Здесь есть два основных отличия:

• Теперь вы можете передавать HttpEntity напрямую, тогда как раньше его нужно было настраивать вручную с помощью RequestCallback.
• Механизм десериализации предоставляется из коробки путем передачи желаемого типа ответа Class.

Как видите, для повседневного использования это намного удобнее.

Такие методы, как getForEntity и postForEntity, даже короче, их легче понять:

getForEntity(String url, Class<T> responseType, Object... uriVariables)

postForEntity(String url, @Nullable Object request, Class<T> responseType,
              Object... uriVariables)

Обратите внимание, что postForEntity теперь позволяет отправлять любой Object напрямую без оболочки. Использование этих дисков вместо execute не дает ни преимущества в производительности, ни ущерба, поскольку они сами называют себя execute - это просто вопрос удобства.

Выполнять(..) Самый простой способ сделать вызов REST.

Обмен(..) Обертка над методом Execute.

PostForEntity (..) Метод-оболочка, который еще больше упрощает использование вызовов REST. Вы указываете тип запроса в самом имени метода (getForEntity, postForEntity), поэтому, не нужно указывать тип запроса в параметре. Само по себе название метода говорит само за себя.

В Обмен и postForEntity ответ должен быть в Форматы Json. Этот Json далее преобразуется в класс Model библиотеками json-mapper. В то время как в Выполнять мы принимаем ответ в любой формат, поскольку мы передаем десериализатор в аргументе Response Executor.