rest assured

Тестирование и проверка служб REST на Java сложнее, чем на динамических языках, таких как Ruby и Groovy. REST Assured обеспечивает простоту использования этих языков в области Java.

Новости

• 05.07.2024: Выпущена версия REST Assured 5.5.0 с несколькими исправлениями ошибок и новым модулем расширения Scala 3. Подробности смотрите в журнале изменений.
• 08.12.2023: Выпущена версия REST Assured 5.4.0 с несколькими исправлениями ошибок и модулем расширения Kotlin для Spring WebTest. Подробности смотрите в журнале изменений.
• 08.09.2023: Выпущена версия REST Assured 5.3.2 с несколькими исправлениями ошибок, улучшенной поддержкой Spring MockMvc, улучшенной поддержкой новых версий Spring Security и т. д. Дополнительные сведения см. в журнале изменений.

Старые новости

Примеры

Вот пример того, как сделать запрос GET и проверить ответ JSON или XML:

 get ( "/lotto" ). then (). assertThat (). body ( "lotto.lottoId" , equalTo ( 5 ));

Получите и проверьте все идентификаторы победителей:

 get ( "/lotto" ). then (). assertThat (). body ( "lotto.winners.winnerId" , hasItems ( 23 , 54 ));

Использование параметров:

 given ().
    param ( "key1" , "value1" ).
    param ( "key2" , "value2" ).
when ().
    post ( "/somewhere" ).
then ().
    body ( containsString ( "OK" ));

Использование X-Path (только XML):

 given ().
    params ( "firstName" , "John" , "lastName" , "Doe" ).
when ().
    post ( "/greetMe" ).
then ().
    body ( hasXPath ( "/greeting/firstName[text()='John']" )).

Нужна аутентификация? REST Assured предоставляет несколько механизмов аутентификации:

 given (). auth (). basic ( username , password ). when (). get ( "/secured" ). then (). statusCode ( 200 );

Получение и анализ тела ответа:

 // Example with JsonPath
String json = get ( "/lotto" ). asString ();
List < String > winnerIds = from ( json ). get ( "lotto.winners.winnerId" );
    
// Example with XmlPath
String xml = post ( "/shopping" ). andReturn (). body (). asString ();
Node category = from ( xml ). get ( "shopping.category[0]" );

REST Assured поддерживает любой метод HTTP, но имеет явную поддержку POST , GET , PUT , DELETE , OPTIONS , PATCH и HEAD и включает в себя простое указание и проверку, например, параметров, заголовков, файлов cookie и тела.

Документация

• Начиная
• Руководство по использованию (нажмите здесь, чтобы просмотреть устаревшую документацию)
• Javadoc
• Будьте уверены Javadoc
• Будьте увереныMockMvc Javadoc
• XmlPath Javaдокументация
• JsonPath Javaдокументация
• Примечания к выпуску
• Часто задаваемые вопросы

Поддержка и обсуждение

Присоединяйтесь к списку рассылки в нашей группе Google.

Ссылки

• Журнал изменений
• Гарантия REST на openhub
• Список рассылки для вопросов и поддержки