Chuyển tới nội dung chính

Quy tắc viết lại

Quy tắc viết lại gồm hai phần: Quy tắc khớp (những yêu cầu nào được viết lại) và Quy tắc viết lại (viết lại như thế nào).

Rewrite Debug hỗ trợ viết lại cho HTTP(S), WebSocket, TCP và UDP. Bạn có thể chuyển hướng yêu cầu, viết lại path/query/header/body, hoặc giả lập phản hồi theo từng giao thức — xem Sửa TCP hoặc WebSocket cho chi tiết về luồng nhị phân.

1. Chuyển hướng yêu cầu cho "HTTP&WebSocket&TCP"​

Chuyển hướng dùng để thay đổi địa chỉ đích và cổng của yêu cầu, đồng thời có thể quyết định có dùng mã hóa SSL/TLS hay không. Quy tắc này đặc biệt hữu ích cho việc chuyển đổi thường xuyên giữa địa chỉ máy chủ thử nghiệm và máy chủ sản xuất khi kiểm thử.

2. Viết lại Path cho "HTTP&WebSocket"​

HTTP Path là phần của URL sau tên máy chủ, dùng để xác định đường dẫn của tài nguyên trên máy chủ web.

https://example.com/api/user?name=john&age=25

Trong ví dụ này, /api/user là Path, thường bắt đầu bằng /. Khi viết lại Path, cần thay thế toàn bộ đường dẫn. Nếu muốn thay Path bằng không có gì, chỉ cần điền /.

3. Viết lại Query cho "HTTP&WebSocket"​

HTTP Query là kỹ thuật truyền dữ liệu qua URL, cho phép truyền tham số và giá trị trong URL bằng ký hiệu "?". Query gồm một hoặc nhiều cặp khóa-giá trị ngăn cách bằng "&".

Ví dụ, URL sau chứa một chuỗi truy vấn với hai tham số (name và age):

https://example.com/api/user?name=john&age=25

Trong ví dụ này, name=john&age=25 là chuỗi truy vấn, gồm nhiều cặp khóa-giá trị nối với nhau bằng "&". Khi viết lại, Hodor phân tích Query thành các cặp khóa-giá trị (xử lý cả thứ tự và tình huống mảng) và sửa Key, Value tương ứng. Ngoài ra, các tên và giá trị tham số này cần được mã hóa URL, ví dụ "value 1" sẽ được mã hóa thành "value%201". Hodor tự xử lý các chuyển đổi này giúp bạn.

4. Viết lại Header cho "HTTP&WebSocket"​

HTTP Headers là một tập các cặp khóa-giá trị. Bạn có thể thêm hoặc bớt giá trị trong HTTP Header. Tuy nhiên, có một số lưu ý đặc biệt với các trường như Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding, Transfer-Encoding — chúng do hệ thống điều khiển và sẽ vô hiệu nếu điền thủ công. Nếu chỉ định Content-Type, nó sẽ ghi đè cài đặt mime-type của hệ thống.

5. Sửa Body cho "HTTP"​

HTTP Body có thể truyền dữ liệu ở nhiều định dạng mã hóa. Hodor hỗ trợ giải mã dữ liệu thành bốn định dạng (text, JSON, x-www-form-urlencoded, multipart/form-data) và sửa chúng dưới dạng cặp khóa-giá trị. Ngoài ra, bạn có thể thay thế động toàn bộ phần Body bằng dữ liệu chuẩn bị sẵn.

5.1. Giải mã thành text và sửa bằng biểu thức chính quy​

Tài liệu chi tiết vui lòng xem tài liệu mẫu.

5.2. Giải mã thành JSON để sửa​

Tài liệu chi tiết vui lòng xem tài liệu mẫu.

5.3. Giải mã thành x-www-form-urlencoded để sửa​

Tài liệu chi tiết vui lòng xem tài liệu mẫu.

5.4. Giải mã thành multipart/form-data để sửa​

Tài liệu chi tiết vui lòng xem tài liệu mẫu.

6. Thay thế Body cho "HTTP"​

Thay thế trực tiếp phần Body trước khi ứng dụng gửi yêu cầu tới máy chủ và trước khi dữ liệu máy chủ trả về ứng dụng.

7. Viết lại mã cho "HTTP"​

Hodor có thể thay đổi mã trạng thái HTTP và cũng có thể chuyển hướng qua mã phản hồi HTTP, chọn từ 301, 302, 307, 308 với địa chỉ chuyển hướng cấu hình được.

8. Giả lập cho "HTTP"​

Chủ yếu dùng để trả về nội dung cụ thể cho một yêu cầu cụ thể; bạn có thể nghĩ nó như một máy chủ HTTP cục bộ trả về nội dung đặt trước cho các yêu cầu khớp.

9. Sửa dữ liệu cho "TCP&WebSocket"​

Chuyển đổi luồng dữ liệu lên/xuống của TCP hoặc WebSocket thành chuỗi hoặc hex16, rồi dùng biểu thức chính quy để sửa dữ liệu này. Tài liệu chi tiết vui lòng xem tài liệu mẫu.