Главная » Spring » Операции класса RestTemplate Spring

0

В табл. 12.1 был представлен список из семи методов HTTP, при- меняемых для взаимодействия с ресурсами RESTful. Эти методы играют роль глаголов в диалоге в стиле RESTful.

Класс RestTemplate определяет 33 метода и использует все методы HTTP для взаимодействия с ресурсами REST. К сожалению, в этой главе не так много места, чтобы можно было подробно рассмотреть все 33 метода. Но, как оказывается, в действительности класс под- держивает всего 11 уникальных операций, каждая из которых имеет три реализации в виде перегруженных методов. Список из 11 уни-

1   http://hc.apache.org/httpcomponents-client/index.html.

2   http://jackson.codehaus.org/.

кальных операций, поддерживаемых классом RestTemplate, представ- лен в табл. 12.3.

Таблица 12.3. Класс RestTemplate определяет 11 уникальных операций, каждая из которых поддерживается тремя перегруженными методами общим числом 33

Метод

Описание

delete()

Выполняет запрос HTTP DELETE к ресурсу с указанным URL

exchange()

Выполняет HTTP-запрос требуемого типа к ресурсу

с указанным URL и возвращает экземпляр ResponseEntity, содержащий объект, отображающий тело ответа

execute()

Выполняет HTTP-запрос требуемого типа к ресурсу

с указанным URL, возвращает объект, отображающий тело ответа

getForEntity()

Выполняет запрос HTTP GET и возвращает экземпляр ResponseEntity, содержащий объект, отображающий тело ответа

getForObject()

Выполняет запрос HTTP GET и возвращает объект, отображающий тело ответа

headForHeaders()

Выполняет запрос HTTP HEAD к ресурсу с указанным URL и возвращает заголовки ответа

optionsForAllow()

Выполняет запрос HTTP OPTIONS и возвращает заголовок

Allow для указанного URL

postForEntity()

Выполняет запрос HTTP POST и возвращает экземпляр ResponseEntity, содержащий объект, отображающий тело ответа

postForLocation()

Выполняет запрос HTTP POST и возвращает URL нового ресурса

postForObject()

Выполняет запрос HTTP POST и возвращает объект, отображающий тело ответа

put()

Выполняет запрос HTTP PUT, отправляя измененный ресурс с указанным URL

Класс RestTemplate использует все методы HTTP, за исключением TRACE. Кроме того, методы execute() и exchange() предлагают возмож- ность выполнения любых HTTP-запросов.

Каждая операция из представленных в табл. 12.3 реализована в форме трех перегруженных методов:

#  один принимает URL в виде java.net.URI без поддержки пара-

метризованных адресов URL;

# один принимает URL в виде строки с параметрами URL в виде экземпляра Map;

# один принимает URL в виде строки, с параметрами URL в виде списка аргументов переменной длины.

Познакомившись с 11 операциями, предоставляемыми классом RestTemplate, и особенностями их использования, вы без труда смо- жете создавать собственные клиентские приложения для работы с ресурсами REST. Познакомимся поближе с операциями, предла- гаемыми классом RestTemplate, которые используют четыре основных метода HTTP: GET, PUT, DELETE и POST. И начнем знакомство с операций getForObject()  и getForEntity(), использующих метод GET.

Источник:   Уоллс К., Spring в действии. – М.: ДМК Пресс, 2013. – 752 с.: ил.

По теме:

  • Комментарии