Gå til hovedinnhold

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.