В этом руководстве мы обсудим, как реализовать глобальный обработчик ошибок для Spring REST API.
Мы будем использовать семантику каждого исключения для создания осмысленных сообщений об ошибках для клиента с четкой целью предоставить этому клиенту всю информацию, чтобы легко диагностировать проблему.
REST — это архитектура без сохранения состояния, в которой клиенты могут получать доступ к ресурсам на сервере и управлять ими. Как правило, службы REST используют HTTP для объявления набора ресурсов, которыми они управляют, и предоставляют API, который позволяет клиентам получать или изменять состояние этих ресурсов.
В этом руководстве мы узнаем о некоторых передовых методах обработки ошибок REST API, включая полезные подходы к предоставлению пользователям соответствующей информации, примеры с крупных веб-сайтов и конкретную реализацию с использованием примера приложения Spring REST.
В этом кратком руководстве мы рассмотрим, как получить доступ к заголовкам HTTP в Spring Rest Controller .
Во-первых, мы будем использовать аннотацию @RequestHeader для чтения заголовков как по отдельности, так и все вместе.
После этого мы более подробно рассмотрим атрибуты @RequestHeader .
В этой пятой статье серии мы проиллюстрируем создание языка REST API Query с помощью классной библиотеки — rsql-parser .
RSQL — это расширенный набор языка запросов к элементам веб-каналов ( FIQL ) — чистый и простой синтаксис фильтров для веб-каналов; поэтому он вполне естественно вписывается в REST API. **
**
В этом руководстве мы собираемся пролить свет на исключение Spring HttpMessageNotWritableException: исключение «Не найден конвертер для возвращаемого значения типа» .
Во-первых, мы объясним основные причины исключения. Затем мы копнем глубже, чтобы увидеть, как создать его на реальном примере и, наконец, как это исправить.
Обычно это исключение возникает, когда Spring не может получить свойства возвращаемого объекта.
В этом руководстве представлен краткий обзор тестирования REST API с помощью curl.
curl — это инструмент командной строки для передачи данных, который поддерживает около 22 протоколов, включая HTTP. Эта комбинация делает его очень хорошим специальным инструментом для тестирования наших REST-сервисов.
В этом руководстве представлены общие сведения о Cucumber , широко используемом инструменте для приемочного тестирования пользователей, и о том, как использовать его в тестах REST API.
Кроме того, чтобы сделать статью автономной и независимой от каких-либо внешних REST-сервисов, мы будем использовать WireMock, библиотеку веб-сервисов-заглушек и имитаторов. Если вы хотите узнать больше об этой библиотеке, обратитесь к введению в WireMock .
Cucumber — это среда тестирования, поддерживающая разработку, управляемую поведением (BDD) , позволяющая пользователям определять операции приложения в виде обычного текста. Он работает на основе доменного языка Gherkin (DSL). Этот простой, но мощный синтаксис Gherkin позволяет разработчикам и тестировщикам писать сложные тесты, делая его понятным даже для нетехнических пользователей.
В этой статье мы познакомим вас с Karate , средой тестирования Behavior Driven Development (BDD) для Java.
Karate построен на основе Cucumber , другой среды тестирования BDD , и использует некоторые из тех же концепций. Одним из таких является использование файла Gherkin, который описывает тестируемую функцию . Однако, в отличие от Cucumber, тесты написаны не на Java и полностью описаны в файле Gherkin.
Файл корнишона сохраняется с расширением « .feature» . Он начинается с ключевого слова Feature , за которым следует имя функции в той же строке. Он также содержит различные тестовые сценарии, каждый из которых начинается с ключевого слова « Сценарий » и состоит из нескольких шагов с ключевыми словами « Дано », « Когда », « Тогда », « И » и « Но » .
В этом кратком руководстве мы покажем, как использовать Spring RestTemplate для выполнения запросов POST, отправляющих содержимое JSON.
Начнем с добавления простого класса модели Person для представления публикуемых данных:
При создании документации Swagger нам часто приходится скрывать конечные точки от конечных пользователей. Чаще всего это делается, когда конечная точка еще не готова. Кроме того, у нас могут быть некоторые частные конечные точки, которые мы не хотим раскрывать.
В этой короткой статье мы рассмотрим, как мы можем скрыть конечные точки из документации Swagger API . Для этого мы будем использовать аннотации в нашем классе контроллера.
@ApiIgnore Аннотация @ApiIgnore позволяет скрыть конечную точку . Давайте добавим эту аннотацию для конечной точки в наш контроллер: