Umschreibregeln
Umschreibregeln bestehen aus zwei Teilen: Übereinstimmungsregeln (welche Anfragen umgeschrieben werden) und Umschreibregeln (wie umgeschrieben wird).
Das Rewrite-Debugging unterstützt das Umschreiben von HTTP(S), WebSocket, TCP und UDP. Sie können Anfragen umleiten, Pfad/Query/Headers/Body umschreiben oder Antworten pro Protokoll mocken — binäre Streams siehe TCP- oder WebSocket-Änderung.
1. Umleiten von Anfragen für „HTTP&WebSocket&TCP“
Die Umleitung dient zum Ändern von Zieladresse und Port einer Anfrage und legt auch fest, ob SSL/TLS-Verschlüsselung verwendet wird. Diese Regel ist besonders nützlich, wenn während der Tests häufig zwischen Test- und Produktionsserver-Adressen gewechselt wird.
2. Umschreiben von Pfaden für „HTTP&WebSocket“
Der HTTP-Pfad ist der Teil der URL nach dem Hostnamen; er identifiziert den Pfad von Ressourcen auf dem Webserver.
https://example.com/api/user?name=john&age=25
In diesem Beispiel ist /api/user der Pfad, typischerweise beginnend mit /. Beim Umschreiben des Pfads wird der gesamte Pfad ersetzt. Soll der Pfad auf nichts gesetzt werden, tragen Sie einfach / ein.
3. Umschreiben von Query-Parametern für „HTTP&WebSocket“
Die HTTP-Query ist eine Technik zur Datenübergabe über die URL: Mit dem Zeichen „?“ können Parameter und Werte in der URL übergeben werden. Queries bestehen aus einem oder mehreren Schlüssel-Wert-Paaren, getrennt durch „&“.
Die folgende URL enthält z. B. einen Query-String mit zwei Parametern (name und age):
https://example.com/api/user?name=john&age=25
In diesem Beispiel ist name=john&age=25 der Query-String, zusammengesetzt aus mehreren Schlüssel-Wert-Paaren, verbunden mit „&“. Beim Umschreiben parst Hodor die Query in Schlüssel-Wert-Paare (Reihenfolge und Array-Fälle werden berücksichtigt) und ändert den jeweiligen Key bzw. Value. Zusätzlich müssen Parameternamen und -werte URL-kodiert werden — „value 1“ wird z. B. zu „value%201“. Hodor übernimmt diese Konvertierungen automatisch für Sie.
4. Umschreiben von Headers für „HTTP&WebSocket“
HTTP-Headers sind eine Menge von Schlüssel-Wert-Paaren. Sie können Werte im HTTP-Header ergänzen oder entfernen. Einige besondere Hinweise gelten für Felder wie Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding und Transfer-Encoding: Sie werden vom System gesteuert und sind wirkungslos, wenn sie manuell eingetragen werden. Wird Content-Type angegeben, überschreibt er die mime-type-Einstellung des Systems.
5. Ändern des Bodys für „HTTP“
Der HTTP-Body kann Daten in verschiedenen Kodierungsformaten übertragen. Hodor unterstützt das Dekodieren in vier Formate (text, JSON, x-www-form-urlencoded, multipart/form-data) und deren Änderung als Schlüssel-Wert-Paare. Alternativ können Sie den gesamten Body-Abschnitt dynamisch durch vorbereitete Daten ersetzen.
5.1. Als Text dekodieren und per regulärem Ausdruck ändern
Ausführliche Dokumentation: das Beispieldokument.
5.2. Als JSON dekodieren und ändern
Ausführliche Dokumentation: das Beispieldokument.
5.3. Als x-www-form-urlencoded dekodieren und ändern
Ausführliche Dokumentation: das Beispieldokument.
5.4. Als multipart/form-data dekodieren und ändern
Ausführliche Dokumentation: das Beispieldokument.
6. Ersetzen des Bodys für „HTTP“
Ersetzt den Body-Abschnitt direkt, bevor die App die Anfrage an den Server sendet und bevor die Serverdaten zur App zurückkehren.
7. Umschreiben des Statuscodes für „HTTP“
Hodor kann HTTP-Statuscodes ändern und auch per HTTP-Response-Code umleiten — aus 301, 302, 307, 308 wählbar, mit konfigurierbarer Umleitungsadresse.
8. Mocking für „HTTP“
Dient vor allem dazu, für eine bestimmte Anfrage einen festgelegten Inhalt zurückzugeben — vorstellbar als lokaler HTTP-Server, der für passende Anfragen vordefinierte Inhalte liefert.
9. Ändern von Daten für „TCP&WebSocket“
Der Auf- und Abwärtsdatenstrom von TCP oder WebSocket wird in Strings oder Hex16 konvertiert, dann per regulärem Ausdruck verändert. Ausführliche Dokumentation: das Beispieldokument.