Request

Request (불변 요청 상태 뷰)

HTTP 교환의 불변(immutable) 요청 상태에 대한 뷰를 제공하는 인터페이스입니다. HttpExchange와 HttpsExchange가 이 인터페이스를 구현합니다.

출처: Java API Reference

Request는 HTTP 교환의 요청 측 상태를 읽기 전용으로 바라보는 인터페이스입니다. 요청 메서드, URI, 헤더, 본문 등의 정보를 안전하게 읽을 수 있게 해 줍니다.

요청 상태를 불변으로 노출하므로 읽는 도중 상태가 변경되어 일관성이 깨지는 문제를 방지합니다. HttpExchange와 HttpsExchange가 모두 이 인터페이스를 구현하며, 공통된 요청 정보는 이 인터페이스 타입으로 다루는 것이 가능합니다.

이 인터페이스를 통해 얻는 정보는 요청이 결정된 시점의 스냅숏으로 간주할 수 있어, 핸들러에서 요청을 분석하거나 필터링할 때 안전하게 참조할 수 있습니다. getRequestMethod()나 URI·헤더 조회 같은 기본 요청 정보 접근을 제공합니다.