HttpContext

HttpContext (URL 경로와 핸들러의 매핑)

애플리케이션의 루트 URI 경로와, 그 경로로 향하는 요청을 처리하기 위해 호출되는 HttpHandler 사이의 매핑을 나타내는 추상 클래스입니다. 연결된 HttpServer나 HttpsServer에서 해당 경로의 요청을 처리해요.

출처: Java API Reference

본문

HttpContext 인스턴스는 HttpServer와 HttpsServer의 create 메서드들로 만들어집니다. 이 컨텍스트에는 Filter 객체의 체인을 추가할 수 있는데, 컨텍스트가 처리하는 모든 교환은 체인의 각 필터에 의해 전처리·후처리될 수 있어요.

메서드

  • getHandler() — 이 컨텍스트의 핸들러를 반환합니다.
  • setHandler(HttpHandler handler) — 아직 설정되지 않았다면 이 컨텍스트의 핸들러를 설정합니다. 핸들러가 이미 설정되어 있으면 IllegalArgumentException, handler가 null이면 NullPointerException이 발생해요.
  • getPath() — 이 컨텍스트가 생성될 때 사용한 경로를 반환합니다.
  • getServer() — 이 컨텍스트가 생성될 때 사용한 서버를 반환해요.
  • getAttributes() — 가변 Map을 반환하며, 필터 모듈과 컨텍스트의 교환 핸들러에 설정이나 기타 데이터를 전달하는 데 사용할 수 있습니다. 이 Map에 저장된 모든 속성은 이 컨텍스트가 처리하는 모든 HttpExchange에 보입니다.
  • getFilters() — 이 컨텍스트의 필터 목록을 반환합니다. 서버가 요청을 배포할 때 실제로 사용하는 목록이라, 이 목록을 수정하면 즉시 교환 처리에 반영돼요.
  • getAuthenticator() — 이 컨텍스트에 설정된 Authenticator가 있으면 반환합니다.
  • setAuthenticator(Authenticator auth) — 이 컨텍스트의 Authenticator를 설정합니다. 기존 인증기가 있으면 그 인증기를 반환해요.

더 알아보기

Java 공식 API