본문으로 건너뛰기

재작성 규칙

재작성 규칙은 두 부분으로 구성됩니다: 매칭 규칙(어떤 요청을 재작성할지)과 재작성 규칙(어떻게 재작성할지).

재작성 디버그는 HTTP(S), WebSocket, TCP, UDP 재작성을 지원합니다. 요청 리다이렉트, path/query/headers/body 재작성, 프로토콜별 응답 모킹이 가능합니다 — 바이너리 스트림 상세는 TCP 또는 WebSocket 수정을 참조하세요.

1. 'HTTP&WebSocket&TCP' 요청 리다이렉트​

리다이렉트는 요청의 대상 주소와 포트를 바꾸고 SSL/TLS 암호화 여부도 결정할 수 있습니다. 이 규칙은 테스트 중 테스트 서버와 프로덕션 서버 주소를 자주 전환할 때 특히 유용합니다.

2. 'HTTP&WebSocket' Path 재작성​

HTTP Path는 호스트명 뒤의 URL 부분으로, 웹 서버상 리소스의 경로를 식별합니다.

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

이 예에서 /api/user가 Path이며 보통 /로 시작합니다. Path를 재작성할 때는 전체 경로를 교체해야 합니다. Path를 아무것도 없애려면 /만 채우면 됩니다.

3. 'HTTP&WebSocket' Query 재작성​

HTTP Query는 URL로 데이터를 전달하는 기술로, "?" 기호로 URL에 파라미터와 값을 전달합니다. Query는 "&"로 구분된 하나 이상의 키-값 쌍입니다.

예를 들어 다음 URL은 두 파라미터(name과 age)를 가진 쿼리 문자열을 포함합니다:

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

이 예에서 name=john&age=25가 쿼리 문자열이며 "&"로 연결된 여러 키-값 쌍입니다. 재작성 시 Hodor는 Query를 키-값 쌍으로 파싱하고(순서와 배열 상황 처리) 대응하는 Key, Value를 수정합니다. 또한 이 파라미터 이름과 값은 URL 인코딩이 필요합니다. 예를 들어 "value 1"은 "value%201"로 인코딩됩니다. Hodor가 이런 변환을 자동 처리합니다.

4. 'HTTP&WebSocket' Headers 재작성​

HTTP Headers는 키-값 쌍의 집합입니다. HTTP 헤더에 값을 추가하거나 제거할 수 있습니다. 다만 Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding, Transfer-Encoding 같은 필드는 시스템이 제어하므로 수동으로 채워도 무효가 됩니다. Content-Type을 지정하면 시스템의 mime-type 설정을 덮어씁니다.

5. 'HTTP' Body 수정​

HTTP Body는 다양한 인코딩 형식으로 데이터를 전송할 수 있습니다. Hodor는 데이터를 4가지 인코딩 형식(text, JSON, x-www-form-urlencoded, multipart/form-data)으로 디코딩해 키-값 쌍으로 수정하는 것을 지원합니다. 또는 미리 준비한 데이터로 Body 전체를 동적으로 교체할 수 있습니다.

5.1. text로 디코딩하여 정규식으로 수정​

상세 문서는 샘플 문서를 참조하세요.

5.2. JSON으로 디코딩하여 수정​

상세 문서는 샘플 문서를 참조하세요.

5.3. x-www-form-urlencoded로 디코딩하여 수정​

상세 문서는 샘플 문서를 참조하세요.

5.4. multipart/form-data로 디코딩하여 수정​

상세 문서는 샘플 문서를 참조하세요.

6. 'HTTP' Body 교체​

앱이 서버에 요청을 보내기 전과 서버 데이터가 앱으로 돌아오기 전에 Body 부분을 직접 교체합니다.

7. 'HTTP' Code 재작성​

Hodor는 HTTP 상태 코드를 바꿀 수 있고, HTTP 응답 코드로 리다이렉트도 가능합니다. 301, 302, 307, 308 중 선택하며 리다이렉트 주소를 설정할 수 있습니다.

8. 'HTTP' 모킹​

주로 특정 요청에 대해 지정한 콘텐츠를 돌려주는 데 쓰입니다. 매칭되는 요청에 사전 설정 콘텐츠를 돌려주는 로컬 HTTP 서버라고 생각하면 됩니다.

9. 'TCP&WebSocket' 데이터 수정​

TCP 또는 WebSocket의 상·하행 데이터 흐름을 문자열이나 hex16으로 변환한 뒤 정규식으로 수정합니다. 상세 문서는 샘플 문서를 참조하세요.