Herschrijfregels
Herschrijfregels bestaan uit twee delen: Matching Rules (welke verzoeken worden herschreven) en Rewriting Rules (hoe er wordt herschreven).
Rewrite Debug ondersteunt herschrijven voor HTTP(S), WebSocket, TCP en UDP. Je kunt verzoeken omleiden, pad/query/headers/body herschrijven of per protocol antwoorden mocken — zie TCP of WebSocket wijzigen voor de bijzonderheden van binaire streams.
1. Verzoeken omleiden voor 'HTTP&WebSocket&TCP'
Omleiden wordt gebruikt om het doeladres en de poort van een verzoek te wijzigen, en kan ook bepalen of SSL/TLS-versleuteling wordt gebruikt. Deze regel is bijzonder handig bij het frequente wisselen tussen testserver- en productieserveradressen tijdens het testen.
2. Paden herschrijven voor 'HTTP&WebSocket'
Het HTTP-pad verwijst naar het deel van de URL na de hostname en identificeert het pad van bronnen op de webserver.
https://example.com/api/user?name=john&age=25
In dit voorbeeld is /api/user het pad, doorgaans beginnend met /. Bij het herschrijven van het pad moet het hele pad worden vervangen. Wil je het pad vervangen door niets, vul dan gewoon / in.
3. Query's herschrijven voor 'HTTP&WebSocket'
De HTTP-query is een techniek om gegevens via een URL door te geven, waarbij parameters en waarden met het teken '?' in de URL kunnen worden meegegeven. Query's bestaan uit één of meer key-value-paren, gescheiden door '&'.
Bijvoorbeeld: de volgende URL bevat een querystring met twee parameters (name en age):
https://example.com/api/user?name=john&age=25
In dit voorbeeld is name=john&age=25 de querystring, samengesteld uit meerdere key-value-paren die met '&' worden verbonden. Bij het herschrijven parseert Hodor de query naar key-value-paren (met afhandeling van volgorde en arraysituaties) en wijzigt de bijbehorende Key en Value. Bovendien moeten deze parameternamen en -waarden URL-gecodeerd zijn; bijvoorbeeld 'value 1' wordt gecodeerd als 'value%201'. Hodor regelt deze conversies automatisch voor je.
4. Headers herschrijven voor 'HTTP&WebSocket'
HTTP-headers zijn een set key-value-paren. Je kunt waarden aan de HTTP-header toevoegen of verwijderen. Er zijn wel enkele bijzondere aandachtspunten voor velden als Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding en Transfer-Encoding: deze worden door het systeem beheerd en handmatig ingevulde waarden hebben geen effect. Als Content-Type wordt opgegeven, overschrijft het de mime-type-instelling van het systeem.
5. Body wijzigen voor 'HTTP'
De HTTP-body kan gegevens in verschillende encodingformaten versturen. Hodor ondersteunt het decoderen van gegevens naar vier encodingformaten (tekst, JSON, x-www-form-urlencoded, multipart/form-data) en het wijzigen ervan als key-value-paren. Je kunt ook de hele bodysectie dynamisch vervangen door vooraf voorbereide gegevens.
5.1. Decoderen als tekst en wijzigen met reguliere expressies
Voor de uitgebreide documentatie raadpleeg je het voorbeeld-document.
5.2. Decoderen als JSON voor wijziging
Voor de uitgebreide documentatie raadpleeg je het voorbeeld-document.
5.3. Decoderen als x-www-form-urlencoded voor wijziging
Voor de uitgebreide documentatie raadpleeg je het voorbeeld-document.
5.4. Decoderen als multipart/form-data voor wijziging
Voor de uitgebreide documentatie raadpleeg je het voorbeeld-document.
6. Body vervangen voor 'HTTP'
Vervang de bodysectie rechtstreeks voordat de app het verzoek naar de server stuurt en voordat de servergegevens terugkeren naar de app.
7. Code herschrijven voor 'HTTP'
Hodor kan HTTP-statuscodes wijzigen en kan ook omleiden via HTTP-responsecodes, met keuze uit 301, 302, 307, 308 en configureerbare omleidingsadressen.
8. Mocken voor 'HTTP'
Wordt vooral gebruikt om voor een bepaald verzoek specifieke inhoud terug te geven; je kunt het zien als een lokale HTTP-server die voor matchende verzoeken vooraf ingestelde inhoud teruggeeft.
9. Gegevens wijzigen voor 'TCP&WebSocket'
Converteer de upstream- en downstreamgegevensstroom van TCP of WebSocket naar strings of hex16 en gebruik vervolgens reguliere expressies om deze gegevens te wijzigen. Voor de uitgebreide documentatie raadpleeg je het voorbeeld-document.