書き換えルール
書き換えルールは2つの部分からなります:マッチングルール(どのリクエストを書き換えるか)と書き換えルール(どのように書き換えるか)。
書き換えデバッグはHTTP(S)、WebSocket、TCP、UDPの書き換えに対応しています。リクエストのリダイレクト、path/query/headers/bodyの書き換え、プロトコルごとのレスポンスのモックが可能です — バイナリストリームの詳細はTCPまたはWebSocketの変更を参照。
1. 「HTTP&WebSocket&TCP」のリクエストをリダイレクト
リダイレクトはリクエストのターゲットアドレスとポートを変更するために使われ、SSL/TLS暗号化を使うかどうかも決められます。このルールは、テスト中にテストサーバーと本番サーバーのアドレスを頻繁に切り替える場合に特に便利です。
2. 「HTTP&WebSocket」のパスを書き換え
HTTP PathとはURLのホスト名に続く部分で、Webサーバー上のリソースのパスを識別するために使われます。
https://example.com/api/user?name=john&age=25
この例では、/api/user がパスで、通常は / で始まります。パスを書き換えるときはパス全体を置き換えます。パスを空にしたい場合は / を入力するだけです。
3. 「HTTP&WebSocket」のクエリを書き換え
HTTP QueryはURLを通じてデータを渡す技術で、「?」記号を使ってURL内にパラメータと値を渡せます。クエリは「&」で区切られた1つ以上のキー・バリューペアで構成されます。
例えば、次のURLには2つのパラメータ(nameとage)を含むクエリ文字列があります:
https://example.com/api/user?name=john&age=25
この例では、name=john&age=25 がクエリ文字列で、「&」で連結された複数のキー・バリューペアで構成されます。書き換え時、Hodorはクエリをキー・バリューペアにパースし(順序や配列の状況も処理)、対応するKey、Valueを変更します。また、これらのパラメータ名と値はURLエンコードが必要です。例えば「value 1」は「value%201」にエンコードされます。Hodorがこれらの変換を自動的に処理します。