Regole di riscrittura
Le regole di riscrittura sono costituite da due parti: Regole di corrispondenza (quali richieste riscrivere) e Regole di riscrittura (come riscrivere).
Il Rewrite Debug supporta la riscrittura per HTTP(S), WebSocket, TCP e UDP. Puoi reindirizzare le richieste, riscrivere percorso/query/header/corpo, o simulare risposte per protocollo — vedi Modifica TCP o WebSocket per le specifiche dei flussi binari.
1. Reindirizzamento delle richieste per «HTTP&WebSocket&TCP»
Il reindirizzamento serve a cambiare l'indirizzo e la porta di destinazione di una richiesta e può anche decidere se usare la cifratura SSL/TLS. Questa regola è particolarmente utile per i frequenti passaggi tra indirizzi del server di test e del server di produzione durante il testing.
2. Riscrittura dei percorsi per «HTTP&WebSocket»
L'HTTP Path si riferisce alla parte dell'URL dopo il nome host, usata per identificare il percorso delle risorse sul server web.
https://example.com/api/user?name=john&age=25
In questo esempio, /api/user è il Path, che tipicamente inizia con /. Quando riscrivi il Path, l'intero percorso deve essere sostituito. Se vuoi sostituire il Path con niente, compila semplicemente /.
3. Riscrittura delle query per «HTTP&WebSocket»
L'HTTP Query è una tecnica per passare dati attraverso un URL, che consente di passare parametri e valori nell'URL usando il simbolo «?». Le query sono costituite da una o più coppie chiave-valore separate da «&».
Ad esempio, il seguente URL contiene una query string con due parametri (name e age):
https://example.com/api/user?name=john&age=25
In questo esempio, name=john&age=25 è la query string, composta da più coppie chiave-valore concatenate con «&». Durante la riscrittura, Hodor analizza la Query in coppie chiave-valore (gestendo ordine e situazioni di array) e modifica le coppie Chiave, Valore corrispondenti. Inoltre, questi nomi e valori di parametro devono essere URL-encoded, ad esempio «value 1» verrà codificato come «value%201». Hodor gestisce automaticamente queste conversioni per te.
4. Riscrittura degli header per «HTTP&WebSocket»
Gli HTTP Header sono un insieme di coppie chiave-valore. Puoi aggiungere o rimuovere valori dall'HTTP Header. Tuttavia, ci sono alcune considerazioni speciali per campi come Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding, Transfer-Encoding, che sono controllati dal sistema e risulterebbero inefficaci se compilati manualmente. Se viene specificato Content-Type, sovrascriverà l'impostazione mime-type del sistema.
5. Modifica del Body per «HTTP»
L'HTTP Body può trasmettere dati in vari formati di codifica. Hodor supporta la decodifica dei dati in quattro formati di codifica (testo, JSON, x-www-form-urlencoded, multipart/form-data) e la loro modifica come coppie chiave-valore. In alternativa, puoi sostituire dinamicamente l'intera sezione del Body con dati preparati in anticipo.
5.1. Decodifica come testo e modifica con espressioni regolari
Per la documentazione dettagliata, consulta il documento di esempio.
5.2. Decodifica come JSON per la modifica
Per la documentazione dettagliata, consulta il documento di esempio.
5.3. Decodifica come x-www-form-urlencoded per la modifica
Per la documentazione dettagliata, consulta il documento di esempio.
5.4. Decodifica come multipart/form-data per la modifica
Per la documentazione dettagliata, consulta il documento di esempio.
6. Sostituzione del Body per «HTTP»
Sostituisci direttamente la sezione del Body prima che l'App invii la richiesta al Server e prima che i dati del Server tornino all'App.
7. Riscrittura del codice per «HTTP»
Hodor può cambiare i codici di stato HTTP e può anche reindirizzare tramite codici di risposta HTTP, scegliendo tra 301, 302, 307, 308 con indirizzi di reindirizzamento configurabili.
8. Mocking per «HTTP»
Usato principalmente per restituire contenuti specifici per una particolare richiesta: puoi pensarlo come un server HTTP locale che restituisce contenuti preimpostati per le richieste corrispondenti.
9. Modifica dei dati per «TCP&WebSocket»
Converti il flusso di dati upstream e downstream di TCP o WebSocket in stringhe o hex16, poi usa espressioni regolari per modificare questi dati. Per la documentazione dettagliata, consulta il documento di esempio.