[Spring Framework] HttpServletRequest - HTTP 메시지 값 담기는 과정 (요청)

• SpringBoot 내장 서버는 Tomcat이며, 해당 Tomcat은 WAS로 불리며, 요청과 응답을 주고 받는 미들웨어로 불린다.
• Tomcat은 HttpServletRequest 인터페이스를 구현한 클래스를 제공해준다.
• 즉, 요청이 들어오면 HttpServletRequest 인터페이스를 구현한 클래스에 요청의 대한 값이 담기게 된다.

✅ 1. HttpServletRequest [ interface ]

package jakarta.servlet.http;

public interface HttpServletRequest extends ServletRequest {
    // ... 여러 HTTP 관련 메서드들이 추상메서드로 정의되어 있음.
}

• 자바의 표준 API 인 Servlet API 의 일부이다. 즉, 자바 표준 API 인 것이다.
• 웹 브라우저로부터 HTTP 요청이 들어오면 값을 담아서 서버 쪽 코드로 전달해주는 역할을 한다.
• 핵심은 요청 메서드, 요청 URL, 쿼리스트링, 요청 헤더, 요청 본문(Body), 쿠키 등 HTTP 관련 데이터를 담는 것을 명세를 해둔 인터페이스이다. 즉, 구현을 통해 해당 구현 클래스에서 재정의를 통해 값을 담아주는 것이다.

---

✅ 2. ServletRequest [ interface ]

public interface ServletRequest {
    // 요청 본문을 담는 추상 메서드 등 HttpServletRequest에 상속 할 메서드를 가지고있음
    ServletInputStream getInputStream() throws IOException;
}

• 위의 HttpServletRequest 인터페이스가 상속을 받는 인터페이스이다.
• 해당 getInputStream() 메서드 부분을 통해 요청 본문의 데이터를 읽어 올 수 있음.
• HttpServletRequest 인터페이스에서 못본 추상메서드를 여기서 볼 수 있음. ( 여기도 확인을 해야 유용함 )
• 왜냐하면 HttpServletRequest 가 결국 이 인터페이스를 상속 받기 때문이다.

---

✅ 3. Request [ instance - org.apache.catalina.connector.Request ]

public class Request implements HttpServletRequest {
    //...
}

• 실제 클라이언트 요청 데이터를 보관하고 있는 클래스임.
• 요청 메서드, URI, 쿼리스트링, 프로토콜, 헤더, 바디, 쿠키, 세션, 인증 정보 등 다 가지고 있음.
• 즉, HTTP 요청 전체가 이 객체에 로우하게 저장이 되어있음.
• 모든 HTTP 요청 즉, 클라이언트의 민감한 정보를 가지고 있는 이슈가 있음.
• 해당 문제를 해결하기 위해 ReuqestFacade 클래스를 감싸서 해당 ReuqestFacade 클래스만 이용을 하게 됨.

---

✅ 4. RequestFacade [ instance - org.apache.catalina.connector ]

public class RequestFacade implements HttpServletRequest {
    protected Request request = null;

    public RequestFacade(Request request) {
        this.request = request;
    }
    
    // ...
}

• Request 클래스를 감싼 외부 노출용 클래스이다.
• Request 클래스는 클라이언트의 민감한 정보를 다 가지고 있어, 외부에서 접근을 하게 되면 보안상 이슈가 됨.
• 그래서 해당 RequestFacade 클래스로 감싸서 민감한 정보나 메서드에 직접 접근을 하지 못하게 제한된 메서드만 노출을함.
• 즉, 최종적으로 이용을 하게 되는 클래스는 HttpServletRequest의 구현체인 RequestFacade 클래스이다.

---

✅ 5. 실제 동작 원리

public class Request implements HttpServletRequest {
    // 내부적으로 RequestFacade 객체를 만들어서 반환해주는 메서드
    public HttpServletRequest getRequest() {
        if (this.facade == null) {
            this.facade = new RequestFacade(this);
        }

        if (this.applicationRequest == null) {
            this.applicationRequest = this.facade;
        }

        return this.applicationRequest;
    }
}

• 내부적으로 요청이 들어오면 해당 클래스를 통해 Request 객체의 값을 담는다.
• 이후, 해당 getRequest() 메서드를 호출하여 RequestFacade 에 Request 값을 담아 리턴을 해줌.
• 최종적으로 HttpServletRequest 타입으로 비즈니스 로직으로 넘어오게 됨.

---

✅ 6. Tomcat 그 외 서버들

• SpringBoot 에는 디폴트로 내장 된 WAS 가 Tomcat이지만, 다른 서버(미들웨어) 즉, 라이브러리를 넣을 수 있음.
• 종류는 대표적으로 Tomcat, Jetty, Undertow 이렇게 있음.
• 해당 서버들은 모두 HttpServletRequest 인터페이스를 구현한 클래스를 제공을 하고 있음.

(1) Tomcat 내장 서버 사용 시

• org.apache.catalina.connector.Request 클래스가 HttpServletRequest 를 구현하여 값을 담게 됨.
• 내부적으로 RequestFacade 가 감싸서 외부(사용자 코드)로 전달이 됨.

(2) Jetty 내장 서버 사용 시

• org.eclipse.jetty.server.Request 클래스가 HttpServletRequest 를 구현하여 값을 담게 됨.

(3) Undertow 내장 서버 사용 시

• io.undertow.servlet.spec.HttpServletRequestImpl 클래스가 HttpServletRequest 를 구현하여 값을 담게 됨.

---

✅ 7. 정리

• 요청이 들어오면 제일 처음 HttpServletRequest 인터페이스를 구현하고 있는 Request에 내부적으로 값이 담김.
• 이후 해당 Request 클래스에는 클라이언트의 민감한 정보나 메서드에 직접 접근을 하지 못하도록 막아둠
• 바로 RequestFacade 클래스로 감싸서 직접 접근을 하지 못하게 제한된 메서드만 노출을 해서 막아둠.