Test de REST. Testen van RESTful webservices met REST Assured. Bas Dijkstra

Transcriptie

1 Test de REST Testen van RESTful webservices met REST Assured Bas Dijkstra

2 WiFi _Voorjaarsevenement 2016, password congres2016 _NBCSocialLogin

3 Wat gaan we doen? _RESTful webservices _REST Assured _Aan de slag

4 Voorbereiding _Installatie Eclipse (of een andere IDE) _Installatie TestNG-plugin (voor Eclipse) _Installatie m2e (of tegenhanger voor andere IDE) _Importeren Maven-project in IDE _Update project (Eclipse) of tegenhanger

5 Hoe werken RESTful webservices? _HTTP requestmethoden (GET, POST, PUT, ) _URI s _CRUD-operaties op gegevens POST GET PUT DELETE Create Read Update Delete

6 Een voorbeeld _GET _Geeft als resultaat:

7 Gebruik van RESTful webservices _Mobiele applicaties _Internet Of Things _API Economy

8 Waarom REST (en bijvoorbeeld niet SOAP)? _Ondersteuning van verschillende dataformaten _ JSON _ XML _ _Kleinere overhead en daarmee betere performance

9 Waarom SOAP(en bijvoorbeeld niet REST)? _WS-Security _WS-ReliableMessaging _WS-AtomicTransaction _Voornamelijk gebruikt voor bijvoorbeeld banking-applicaties

10 Tools voor testen van RESTful webservices _Browser (met plugins zoals Postman voor Chrome) _Open source (SoapUI, REST Assured) _Commercieel (Parasoft SOAtest, SoapUI Pro)

11 REST Assured _Java library voor schrijven tests voor RESTful web services _Veel minder boilerplate code nodig _Eenvoudig te integreren in bestaand Javatestframework _ JUnit, TestNG _ Selenium WebDriver

12 Configuratie REST Assured _Download via _Toevoegen als dependency aan project _Maven

13 Een voorbeeldtest

14 REST Assured features _Ondersteuning HTTP methods (GET, POST, PUT, ) _Ondersteuning BDD / Gherkin (Given/When/Then) _Gebruik Hamcrest matchers voor checks (equalto) _Gebruik JSONPath voor selecteren data uit JSONresponse

15 Over Hamcrest matchers _Uitdrukken van verwachtingen in leesbare taal _Voorbeelden: equalto(x) Is een object gelijk aan X? hasitem( Rome ) Bevat een collectie het item Rome? hassize(3) Heeft een collectie de grootte 3? not(equalto(x)) Inverteert matcher equalto() _

16 Over JSONPath _Syntax voor het selecteren van elementen uit een JSON-string _JSONPath is voor JSON wat XPath is voor XML _http://goessner.net/articles/jsonpath/

17 Voorbeeld JSONPath

18 Validatie van technische responsedata _HTTP statuscode _MIME-type van ontvangen gegevens _Cookies en de waarde daarvan _

19 Ons testobject _Ergast F1 API _Geeft historische gegevens van Formule 1-races, coureurs, circuits, etc. _Gegevens beschikbaar in XML- en in JSON-formaat _Documentatie op

20 Een paar voorbeelden _Gegevens van coureur Max Verstappen (in JSON): _De lijst van circuits voor seizoen 2015 (in JSON):

21 Demo _Documentatie van de API _Gebruik van de testsuite _Uitvoeren van tests _Bekijken van testresultaten

22 Aan de slag! _RestAssuredExercises1 _Eenvoudige validaties _ Validatie op individuele velden _ Validatie op collecties en items daarin _ Validatie op technische response-eigenschappen _RestAssuredExamples bevat alle voorbeelden uit de sheets

23 Parameters in RESTful webservices _Path parameters _ _ _Query string parameters _ _ _Er is geen officiele standaard!

24 Toepassen in REST Assured _Voorbeelden query parameters: _ Call naar _ Call naar

25 Toepassen in REST Assured _Voorbeelden path parameters: _ Call naar _ Call naar

26 Toepassen in REST Assured _Iteratie over verzameling van parameterwaarden: _ Aanmaken van combinaties van coureurs en nummers _ Gebruik van testdata in aanroep API en validatie van responsegegevens

27 Aan de slag! _RestAssuredExercises2 _Data driven tests _ Aanmaken van testdata-object _ Gebruiken van testdata in aanroep juiste URI _ Gebruiken van testdata in validaties _RestAssuredExamples bevat alle voorbeelden uit de sheets

28 Authenticatie _Beveiliging van webservices _Basic authentication (preemptive / challenged) _OAuth(2) _Digest / Form

29 Basic authentication _Username/password in de header van elk request

30 OAuth(2) _Aanvragen authenticatietoken met gebruikersnaam en wachtwoord (Basic authentication) _Meesturen authenticatietoken met alle volgende requests

31 Meten van responsetijden _Meten van responsetijd individuele requests _Zetten van thresholds voor responsetijd _ Test faalt wanneer threshold wordt overschreden _Geen volwaardige performancetest _Wel een eerste grove indicatie van responsiviteit van een API

32 Meten van responsetijden _Een voorbeeld:

33 Aan de slag! _ RestAssuredExercises3 _ Communicatie met een API beveiligd met OAuth2 _ Aanvragen authenticatietoken _ Gebruik authenticatietoken in opvolgende requests _ Meten van de responsetijd van een API _ Uitvoeren van een specifieke call _ Vergelijken responsetijd met een vooraf gestelde threshold _ RestAssuredExamples bevat alle voorbeelden uit de sheets

34 Delen van variabelen tussen tests _Voorbeeld authorisatietest _Kopieren / plakken OAuth2-token niet handig _Liever: opslaan en hergebruiken!

35 Delen van variabelen tussen tests _REST Assured ondersteunt dit met extract()

36 Aan de slag! _RestAssuredExercises4 _Probeer het zelf _Kun je ook toepassingen verzinnen voor de Formule 1 webservice? _RestAssuredExamplesParameterPassing bevat de voorbeelden uit de sheets

37 Uitvoeren tests in CI _REST Assured-tests zijn niet anders dan andere Java (unit-)tests _Eenvoudig toe te voegen aan een CI-systeem _Onderdeel van build-proces _Demonstratie (Jenkins)

38 Vragen

39 Contact _ _Weblog: