В этой статье мы начнем изучать спецификацию JSON-API и то, как ее можно интегрировать в REST API, поддерживаемый Spring.
Мы будем использовать реализацию JSON-API Katharsis на Java — и мы настроим приложение Spring на основе Katharsis — так что все, что нам нужно, — это приложение Spring.
Во-первых, давайте посмотрим на нашу конфигурацию maven — нам нужно добавить следующую зависимость в наш pom.xml :
В этом руководстве мы познакомимся с облегченной средой Java REST RESTX .
Создать RESTful API довольно просто с помощью RESTX framework. Он имеет все значения по умолчанию, которые мы можем ожидать от среды REST, такие как обслуживание и использование JSON, параметры запроса и пути, механизмы маршрутизации и фильтрации, статистика использования и мониторинг.
RESTX также поставляется с интуитивно понятной веб-консолью администратора и установщиком командной строки для простой загрузки.
Часто нашим веб-службам необходимо использовать другие веб-службы для выполнения своей работы. Может быть сложно обслуживать запросы пользователей, сохраняя при этом малое время отклика. Медленная внешняя служба может увеличить наше время отклика и привести к тому, что наша система будет накапливать запросы, используя больше ресурсов. Вот где неблокирующий подход может быть очень полезен
В этом руководстве мы отправим несколько асинхронных запросов к службе из приложения Play Framework . Используя неблокирующие HTTP-возможности Java, мы сможем беспрепятственно запрашивать внешние ресурсы, не затрагивая нашу собственную основную логику.
В нашем примере мы рассмотрим библиотеку Play WebService .
В этой статье мы кратко познакомимся с фреймворком Spark . Spark framework — это веб-фреймворк для быстрой разработки, вдохновленный фреймворком Sinatra для Ruby и построенный на философии Java 8 Lambda Expression, что делает его менее подробным, чем большинство приложений, написанных в других фреймворках Java.
Это хороший выбор, если вы хотите получить опыт работы с Node.js при разработке веб-API или микросервисов на Java. С помощью Spark вы можете получить готовый REST API для обслуживания JSON менее чем за десять строк кода.
Мы быстро начнем с примера «Hello World», за которым последует простой REST API.
REST-assured был разработан для упрощения тестирования и проверки REST API, и на него сильно повлияли методы тестирования, используемые в динамических языках, таких как Ruby и Groovy.
Библиотека имеет надежную поддержку HTTP, начиная, конечно, с глаголов и стандартных операций HTTP, но также выходит далеко за рамки этих основ.
В этом руководстве мы собираемся изучить REST-assured и будем использовать Hamcrest для утверждения. Если вы еще не знакомы с Hamcrest, вам следует сначала освежить в памяти учебник: Testing with Hamcrest .
Кроме того, чтобы узнать о более продвинутых вариантах использования REST-assured, ознакомьтесь с другими нашими статьями:
Spring REST Docs и OpenAPI 3.0 — это два способа создания документации API для REST API.
В этом уроке мы рассмотрим их относительные преимущества и недостатки.
Spring REST Docs — это платформа, разработанная сообществом Spring для создания точной документации для RESTful API. Он использует подход, основанный на тестах, при котором документация написана либо как тесты Spring MVC, WebTestClient Spring Webflux , либо как REST-Assured.
В этой статье основное внимание будет уделено тестированию службы REST с несколькими типами/представлениями мультимедиа.
Мы напишем интеграционные тесты, способные переключаться между несколькими типами представлений, поддерживаемыми API. Цель состоит в том, чтобы иметь возможность запускать один и тот же тест, используя те же самые URI службы, просто запрашивая другой тип носителя.
Любой REST API должен предоставлять свои ресурсы как представления с использованием одного или нескольких типов мультимедиа. Клиент установит заголовок Accept , чтобы выбрать тип представления, который он запрашивает у службы.
В этой статье мы будем использовать проекты Swagger Codegen и OpenAPI Generator для создания клиентов REST из файла спецификации OpenAPI/Swagger .
Также мы создадим проект Spring Boot, в котором будем использовать сгенерированные классы.
Мы будем использовать пример API Swagger Petstore для всего.
Библиотека с поддержкой REST обеспечивает поддержку тестирования REST API, обычно в формате JSON.
Время от времени может быть желательно, без детального анализа ответа, сначала узнать, соответствует ли тело JSON определенному формату JSON.
В этом кратком руководстве мы рассмотрим, как мы можем проверить ответ JSON на основе предопределенной схемы JSON .
В нескольких последних статьях серии Registration здесь, на ForEach , мы создали большую часть необходимой нам функциональности в стиле MVC.
Теперь мы собираемся перевести некоторые из этих API на более RESTful-подход.
регистрации