Reguły przepisywania
Reguły przepisywania składają się z dwóch części: Reguł dopasowania (które żądania przepisywać) i Reguł przepisywania (jak przepisywać).
Rewrite Debug obsługuje przepisywanie HTTP(S), WebSocket, TCP i UDP. Możesz przekierowywać żądania, przepisywać path/query/headers/body albo imitować odpowiedzi dla poszczególnych protokołów — szczegóły dotyczące strumieni binarnych znajdziesz w Modyfikacji TCP lub WebSocket.
1. Przekierowywanie żądań dla „HTTP&WebSocket&TCP”
Przekierowanie służy do zmiany adresu docelowego i portu żądania, może też decydować o użyciu szyfrowania SSL/TLS. Ta reguła jest szczególnie przydatna przy częstym przełączaniu między adresami serwera testowego a produkcyjnego podczas testów.
2. Przepisywanie ścieżek dla „HTTP&WebSocket”
HTTP Path to część URL po nazwie hosta, służąca do identyfikowania ścieżki zasobów na serwerze WWW.
https://example.com/api/user?name=john&age=25
W tym przykładzie /api/user to Path, zwykle zaczynający się od /. Przy przepisywaniu Path trzeba zastąpić całą ścieżkę. Jeśli chcesz zastąpić Path niczym, po prostu wpisz /.
3. Przepisywanie zapytań dla „HTTP&WebSocket”
HTTP Query to technika przekazywania danych przez URL, pozwalająca przekazywać parametry i wartości w URL za pomocą symbolu "?". Zapytania składają się z jednej lub wielu par klucz-wartość rozdzielonych znakiem "&".
Na przykład następujący URL zawiera ciąg zapytania z dwoma parametrami (name i age):
https://example.com/api/user?name=john&age=25
W tym przykładzie name=john&age=25 to ciąg zapytania, złożony z wielu par klucz-wartość połączonych znakiem "&". Podczas przepisywania Hodor parsuje Query na pary klucz-wartość (obsługując kolejność i sytuacje tablicowe) i modyfikuje odpowiednie Key, Value. Dodatkowo te nazwy i wartości parametrów muszą być zakodowane w URL — np. "value 1" zostanie zakodowane jako "value%201". Hodor automatycznie załatwia te konwersje za Ciebie.
4. Przepisywanie nagłówków dla „HTTP&WebSocket”
Nagłówki HTTP to zestaw par klucz-wartość. Możesz dodawać i usuwać wartości z nagłówka HTTP. Istnieją jednak specjalne uwagi dotyczące pól takich jak Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding, Transfer-Encoding — są kontrolowane przez system i ręcznie wpisane będą nieskuteczne. Jeśli określono Content-Type, nadpisze on systemowe ustawienie typu MIME.
5. Modyfikacja Body dla „HTTP”
HTTP Body może przesyłać dane w różnych formatach kodowania. Hodor obsługuje dekodowanie danych do czterech formatów (text, JSON, x-www-form-urlencoded, multipart/form-data) i modyfikowanie ich jako pary klucz-wartość. Alternatywnie możesz dynamicznie zastąpić całą sekcję Body wcześniej przygotowanymi danymi.
5.1. Dekodowanie jako tekst i modyfikacja wyrażeniami regularnymi
Szczegółowa dokumentacja: dokument przykładowy.
5.2. Dekodowanie jako JSON w celu modyfikacji
Szczegółowa dokumentacja: dokument przykładowy.
5.3. Dekodowanie jako x-www-form-urlencoded w celu modyfikacji
Szczegółowa dokumentacja: dokument przykładowy.
5.4. Dekodowanie jako multipart/form-data w celu modyfikacji
Szczegółowa dokumentacja: dokument przykładowy.
6. Podmiana Body dla „HTTP”
Bezpośrednio zastąp sekcję Body, zanim aplikacja wyśle żądanie do serwera i zanim dane z serwera wrócą do aplikacji.
7. Przepisywanie kodu dla „HTTP”
Hodor potrafi zmieniać kody statusu HTTP, a także przekierowywać za pomocą kodów odpowiedzi HTTP, wybierając spośród 301, 302, 307, 308 z konfigurowalnym adresem przekierowania.
8. Mockowanie dla „HTTP”
Służy głównie do zwracania określonej treści dla konkretnego żądania — można to traktować jak lokalny serwer HTTP zwracający z góry ustaloną treść dla pasujących żądań.
9. Modyfikacja danych dla „TCP&WebSocket”
Przekonwertuj strumień danych upstream i downstream TCP lub WebSocket na tekst albo hex16, a następnie modyfikuj te dane wyrażeniami regularnymi. Szczegółowa dokumentacja: dokument przykładowy.