rest assured

Tester et valider les services REST en Java est plus difficile que dans les langages dynamiques tels que Ruby et Groovy. REST Assured apporte la simplicité d'utilisation de ces langages dans le domaine Java.

Nouvelles

• 05/07/2024 : REST Assured 5.5.0 est publié avec plusieurs corrections de bugs et un nouveau module d'extension Scala 3. Voir le journal des modifications pour plus de détails.
• 08/12/2023 : REST Assured 5.4.0 est publié avec plusieurs corrections de bugs et un module d'extension Kotlin pour Spring WebTest. Voir le journal des modifications pour plus de détails.
• 08/09/2023 : REST Assured 5.3.2 est publié avec plusieurs corrections de bogues, une meilleure prise en charge de Spring MockMvc, une meilleure prise en charge des versions plus récentes de Spring Security, etc. Voir le journal des modifications pour plus de détails.

Actualités plus anciennes

Exemples

Voici un exemple de comment effectuer une requête GET et valider la réponse JSON ou XML :

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

Obtenez et vérifiez tous les identifiants des gagnants :

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

Utilisation des paramètres :

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

Utilisation de X-Path (XML uniquement) :

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

Besoin d'une authentification ? REST Assured propose plusieurs mécanismes d'authentification :

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

Obtenir et analyser un corps de réponse :

 // 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 prend en charge n'importe quelle méthode HTTP mais prend en charge explicitement POST , GET , PUT , DELETE , OPTIONS , PATCH et HEAD et inclut la spécification et la validation, par exemple, des paramètres, des en-têtes, des cookies et du corps facilement.

Documentation

• Commencer
• Guide d'utilisation (cliquez ici pour la documentation existante)
• Javadoc
• Rassurez-vous Javadoc
• Soyez assuréMockMvc Javadoc
• XmlPath Javadoc
• Javadoc JsonPath
• Notes de version
• FAQ

Accompagnement et discussion

Rejoignez la liste de diffusion de notre groupe Google.

Links

• Journal des modifications
• REST assuré sur openhub
• Liste de diffusion pour les questions et l'assistance