Règles de réécriture
Les règles de réécriture se composent de deux parties : règles de correspondance (quelles requêtes réécrire) et règles de réécriture (comment réécrire).
Le débogage de réécriture prend en charge la réécriture HTTP(S), WebSocket, TCP et UDP. Vous pouvez rediriger des requêtes, réécrire path/query/headers/body ou simuler (mock) des réponses par protocole — voir modifier TCP ou WebSocket pour les spécificités des flux binaires.
1. Rediriger les requêtes pour « HTTP&WebSocket&TCP »
La redirection sert à changer l'adresse et le port cibles d'une requête, et détermine aussi si le chiffrement SSL/TLS est utilisé. Cette règle est particulièrement utile pour les bascules fréquentes entre les adresses du serveur de test et du serveur de production pendant les tests.
2. Réécrire le path pour « HTTP&WebSocket »
Le path HTTP est la partie de l'URL qui suit le nom d'hôte ; il identifie le chemin des ressources sur le serveur web.
https://example.com/api/user?name=john&age=25
Dans cet exemple, /api/user est le path, commençant généralement par /. Lors de la réécriture du path, le path entier doit être remplacé. Si vous voulez le remplacer par rien, remplissez simplement /.
3. Réécrire les query params pour « HTTP&WebSocket »
Le query HTTP est une technique pour passer des données via l'URL : avec le symbole « ? », des paramètres et des valeurs peuvent être passés dans l'URL. Les queries se composent d'une ou plusieurs paires clé-valeur séparées par « & ».
Par exemple, l'URL suivante contient une chaîne de query avec deux paramètres (name et age) :
https://example.com/api/user?name=john&age=25
Dans cet exemple, name=john&age=25 est la chaîne de query, composée de plusieurs paires clé-valeur reliées par « & ». Lors de la réécriture, Hodor analyse le query en paires clé-valeur (en gérant l'ordre et les cas de tableaux) et modifie la clé et la valeur correspondantes. De plus, ces noms et valeurs de paramètres doivent être URL-encodés : par exemple, « value 1 » sera encodé en « value%201 ». Hodor gère automatiquement ces conversions pour vous.
4. Réécrire les headers pour « HTTP&WebSocket »
Les headers HTTP sont un ensemble de paires clé-valeur. Vous pouvez ajouter ou retirer des valeurs du header HTTP. Quelques précautions spéciales concernent cependant les champs Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding, Transfer-Encoding : ils sont contrôlés par le système et seront sans effet s'ils sont remplis manuellement. Si Content-Type est spécifié, il remplacera le réglage mime-type du système.
5. Modifier le body pour « HTTP »
Le body HTTP peut transmettre des données dans divers formats d'encodage. Hodor prend en charge le décodage des données dans quatre formats (text, JSON, x-www-form-urlencoded, multipart/form-data) et leur modification sous forme de paires clé-valeur. Vous pouvez aussi remplacer dynamiquement la section entière du Body par des données préparées à l'avance.
5.1. Décoder comme texte et modifier avec des expressions régulières
Pour la documentation détaillée, reportez-vous au document d'exemple.
5.2. Décoder comme JSON pour modification
Pour la documentation détaillée, reportez-vous au document d'exemple.
5.3. Décoder comme x-www-form-urlencoded pour modification
Pour la documentation détaillée, reportez-vous au document d'exemple.
5.4. Décoder comme multipart/form-data pour modification
Pour la documentation détaillée, reportez-vous au document d'exemple.
6. Remplacer le body pour « HTTP »
Remplacez directement la section du Body avant que l'app n'envoie la requête au serveur et avant que les données du serveur ne reviennent à l'app.
7. Réécrire le code de statut pour « HTTP »
Hodor peut changer les codes de statut HTTP et peut aussi rediriger via les codes de réponse HTTP, en choisissant parmi 301, 302, 307, 308 avec des adresses de redirection configurables.
8. Simuler (mock) pour « HTTP »
Sert principalement à renvoyer un contenu précis pour une requête donnée : imaginez un serveur HTTP local qui renvoie un contenu prédéfini pour les requêtes correspondantes.
9. Modifier les données pour « TCP&WebSocket »
Convertissez le flux de données montant et descendant TCP ou WebSocket en chaîne ou en hex16, puis utilisez des expressions régulières pour modifier ces données. Pour la documentation détaillée, reportez-vous au document d'exemple.