メインコンテンツまでスキップ

書き換えルール

書き換えルールは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がこれらの変換を自動的に処理します。

4. 「HTTP&WebSocket」のヘッダーを書き換え​

HTTP Headersはキー・バリューペアの集合です。HTTPヘッダーへ値の追加や削除ができます。ただし、Range、Content-Range、Content-Length、Content-Encoding、Content-Transfer-Encoding、Transfer-Encodingなどのフィールドには特別な注意点があります。これらはシステムが制御するため、手動で入力しても無効になります。Content-Typeを指定すると、システムのmime-type設定を上書きします。

5. 「HTTP」のボディを変更​

HTTP Bodyは様々なエンコーディング形式でデータを伝送できます。Hodorはデータを4つのエンコーディング形式(text、JSON、x-www-form-urlencoded、multipart/form-data)にデコードしてキー・バリューペアとして変更することに対応しています。あるいは、事前に用意したデータでボディセクション全体を動的に置き換えることもできます。

5.1. テキストとしてデコードして正規表現で変更​

詳細なドキュメントはサンプルドキュメントを参照してください。

5.2. JSONとしてデコードして変更​

詳細なドキュメントはサンプルドキュメントを参照してください。

5.3. x-www-form-urlencodedとしてデコードして変更​

詳細なドキュメントはサンプルドキュメントを参照してください。

5.4. multipart/form-dataとしてデコードして変更​

詳細なドキュメントはサンプルドキュメントを参照してください。

6. 「HTTP」のボディを置換​

アプリがサーバーへリクエストを送る前、およびサーバーのデータがアプリへ返る前に、ボディセクションを直接置換します。

7. 「HTTP」のコードを書き換え​

HodorはHTTPステータスコードを変更でき、HTTPレスポンスコードによるリダイレクトも可能です。301、302、307、308から選択でき、リダイレクト先のアドレスを設定できます。

8. 「HTTP」のモック​

主に特定のリクエストに対して特定の内容を返すために使われます。マッチしたリクエストに対して事前設定した内容を返すローカルHTTPサーバーと考えることができます。

9. 「TCP&WebSocket」のデータを変更​

TCPまたはWebSocketの上り/下りのデータフローを文字列またはhex16に変換し、正規表現でこのデータを変更します。詳細なドキュメントはサンプルドキュメントを参照してください。