De servermodus

Restorm kan een server hosten, en niet alleen er een aanroepen. U definieert een route en de respons daarvan, u start het luisteren, en daarna laat u een client erop wijzen — doorgaans de code van uw eigen applicatie — om te testen hoe die de dienst verbruikt.

Dat is wat u nodig hebt wanneer de echte dienst nog niet bestaat, wanneer het moeilijk is om die de respons te laten geven die u interesseert (een 503-fout, een SOAP-fault, een specifieke gRPC-status), of wanneer u een vaste dataset wilt voor een reproduceerbare test.

Het principe is eenvoudig, en dat maakt het prettig: wat u op de server instelt, is de respons die wordt aangeboden. De status, de headers en de body die u invoert, zijn precies wat de aanroeper ontvangt.

Ondersteunde protocollen

Server	Pagina
HTTP	Een HTTP-API mocken
GraphQL	Een GraphQL-API mocken
gRPC	Een gRPC-service mocken
SOAP	Een SOAP-service mocken
WebSocket, Socket.IO, MQTT	WebSocket, Socket.IO en MQTT mocken
OData	Een OData-service mocken

Een server maken

Rechtsklik op een map ▸ Toevoegen ▸ en dan het gewenste item. Het menu biedt acht servers, elk een apart soort element:

HTTP-server · GraphQL-server · gRPC-server · SOAP-server · WebSocket-server · Socket.IO-server · MQTT-server · OData-server

Het aangemaakte element draagt in de boom een badge SRV. Voor een HTTP-server zijn de startwaarden GET, localhost:8080/, status 200.

Starten en stoppen

In het paneel is de verzendknop vervangen door een schakelaar Listen ↔ Stop. Het responspaneel toont de toestand live: Not listening, of Listening — N request(s) served.

De host staat vast op localhost: alleen de poort en het pad kunt u bewerken. Een mockserver is niet bedoeld om aan het netwerk te worden blootgesteld.

De server stopt via de knop Stop, door het bestand te sluiten, of door de applicatie af te sluiten.

Poorten delen

Restorm opent maar één socket per poort en routeert op basis van de aard van de inkomende aanroep: gewone verzoeken naar de HTTP-routes, upgrade-verzoeken naar WebSocket of Socket.IO.

Concreet: een HTTP-mockserver en een Socket.IO-server kunnen samen op :8080 luisteren. De poort komt pas vrij als de laatste route ervan stopt.

Variabelen worden live opgelost

De headers en de body die worden aangeboden, worden op het moment van antwoorden opgelost, niet bij het starten: een omgevingsvariabele wijzigen terwijl de server luistert, verandert dus de volgende respons. Zie Variabelen en omgevingen.

In een scenario

De acties … -server / … -server sluiten hosten een server zolang het scenario duurt, met een uitvoer served die één event per inkomende aanroep uitstuurt. Daarmee test u een webhook van begin tot eind in één enkele graaf. Zie Gehoste servers.

Vergelijking met gehoste mockservers

	Restorm	Gehoste servers (zoals Postman Mock Servers)
Waar het draait	Op uw eigen machine	Bij de aanbieder
Latentie	Geen netwerkomweg	Een omweg over internet
Werkt offline	✔	✘
Bron van de respons	Het verzoek zelf, bewerkbaar	Een opgeslagen voorbeeld
{{ }}-templates	✔, bij elke aanroep opgelost	Beperkt
Poorten delen	✔	Niet van toepassing
Vertrouwelijkheid	Er verlaat niets uw machine	De gegevens lopen via de dienst