Omskrivingsregler
Omskrivingsregler består av to deler: Matchingsregler (hvilke forespørsler som skal omskrives) og Omskrivingsregler (hvordan de skal omskrives).
Rewrite Debug støtter omskriving for HTTP(S), WebSocket, TCP og UDP. Du kan omdirigere forespørsler, omskrive sti/query/headere/body eller fake (mocke) svar per protokoll — se TCP- eller WebSocket-modifikasjon for detaljer om binærstrømmer.
1. Omdirigere forespørsler for «HTTP&WebSocket&TCP»
Omdirigering brukes til å endre måladresse og port for en forespørsel, og kan også bestemme om SSL/TLS-kryptering skal brukes. Denne regelen er særlig nyttig for hyppig veksling mellom testserver- og produksjonsserveradresser under testing.
2. Omskrive stier for «HTTP&WebSocket»
HTTP Path er delen av URL-en etter vertsnavnet, og brukes til å identifisere stien til ressurser på webserveren.
https://example.com/api/user?name=john&age=25
I dette eksempelet er /api/user Path-en, som vanligvis begynner med /. Ved omskriving av stien må hele stien erstattes. Vil du erstatte stien med ingenting, fyller du bare inn /.
3. Omskrive queries for «HTTP&WebSocket»
HTTP Query er en teknikk for å sende data gjennom en URL, der parametere og verdier kan sendes med i URL-en ved hjelp av «?»-symbolet. Queries består av ett eller flere nøkkel-verdi-par skilt med «&».
For eksempel inneholder følgende URL en query-streng med to parametere (name og age):
https://example.com/api/user?name=john&age=25
I dette eksempelet er name=john&age=25 query-strengen, satt sammen av flere nøkkel-verdi-par som er lenket med «&». Ved omskriving parser Hodor Query-en til nøkkel-verdi-par (håndterer rekkefølge- og array-situasjoner) og endrer tilhørende Key, Value. I tillegg må disse parameternavnene og -verdiene URL-kodes; for eksempel kodes «value 1» som «value%201». Hodor håndterer disse konverteringene automatisk for deg.
4. Omskrive headere for «HTTP&WebSocket»
HTTP Headers er et sett med nøkkel-verdi-par. Du kan legge til eller fjerne verdier i HTTP-headeren. Men det er noen særlige hensyn for felt som Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding og Transfer-Encoding, som styres av systemet og blir virkningsløse hvis de fylles inn manuelt. Hvis Content-Type er oppgitt, overstyrer den systemets mime-type-innstilling.
5. Endre body for «HTTP»
HTTP Body kan sende data i ulike kodingsformater. Hodor støtter dekoding av data til fire kodingsformater (text, JSON, x-www-form-urlencoded, multipart/form-data) og endring av dem som nøkkel-verdi-par. Alternativt kan du dynamisk erstatte hele body-delen med på forhånd forberedte data.
5.1. Dekode som text og endre med regulære uttrykk
For detaljert dokumentasjon, se eksempeldokumentet.
5.2. Dekode som JSON for endring
For detaljert dokumentasjon, se eksempeldokumentet.
5.3. Dekode som x-www-form-urlencoded for endring
For detaljert dokumentasjon, se eksempeldokumentet.
5.4. Dekode som multipart/form-data for endring
For detaljert dokumentasjon, se eksempeldokumentet.
6. Erstatte body for «HTTP»
Erstatt body-delen direkte før appen sender forespørselen til serveren, og før serverdataene returneres til appen.
7. Omskrive kode for «HTTP»
Hodor kan endre HTTP-statuskoder og kan også omdirigere via HTTP-svarskoder, med valg mellom 301, 302, 307, 308 og konfigurerbar omdirigeringsadresse.
8. Mocke for «HTTP»
Brukes hovedsakelig til å returnere bestemt innhold for en bestemt forespørsel; du kan tenke på det som en lokal HTTP-server som returnerer forhåndsinnstilt innhold for matchende forespørsler.
9. Endre data for «TCP&WebSocket»
Konverter TCP- eller WebSocket opp- og nedstrømsdatastrøm til streng eller hex16, og bruk deretter regulære uttrykk for å endre dataene. For detaljert dokumentasjon, se eksempeldokumentet.