정리에 참고한 블로그

🔗 javax.servlet 패키지

공식 문서

🔗 docs.oracle.com의 javax.servlet

---

javax.servlet 패키지

서블릿 관련 클래스와 인터페이스들을 포함한다.

Servlet
ServletConfig
ServletContext
ServletRequest
ServletResponse
RequestDispatcher

---

1. Interface Servlet

모든 서블릿이 구현해야 하는 메서드를 정의한다.
웹 서버 안에서 돌아가는 작은 자바 프로그램. 웹 클라이언트로부터 요청을 받고 응답한다 - 보통 HTTP를 통해서.

이 인터페이스를 구현하려면 javax.servlet.GenericServlet 클래스를 상속받는 서블릿 혹은 javax.servlet.http.HttpServlet 클래스를 상속받는 서블릿을 작성한다.

이 인터페이스는 서블릿을 초기화하고, 요청을 수행하고, 서블릿을 서버로부터 제거하는 서블릿 생명주기 메서드를 정의한다.
이 메서드들은 모두 서블릿 컨테이너가 호출함으로써 실행된다.

void init(ServletConfig config)

초기화. 서비스할 수 있도록 배치된다는 것을 의미.
서블릿 인스턴스를 만든 후 서블릿 컨테이너가 딱 한 번 호출한다. 서블릿이 요청을 받기 전에 반드시 init()이 성공적으로 완료되어야 한다.
ServletConfig 객체를 파라미터로 전달받는다.

void service(ServletRequest req, ServletResponse res)

서블릿이 요청에 응답할 수 있도록 한다.
init() 메서드가 완벽히 끝난 후에만 호출된다.

void destroy()

서블릿이 더 이상 사용되지 않을 때 호출된다.

---

2. Interface ServletConfig

서블릿이 초기화될 때 서블릿에 정보를 전달하기 위해 서블릿 컨테이너에서 사용하는 객체.

ServletContext getServletContext()

호출자가 서블릿 컨테이너와 interact하는 데 사용할 ServletContext 객체 반환.

---

3. Interface ServletContext

서블릿 컨테이너와 통신하기 위해 사용할 일련의 메서드들을 정의한다 - 파일의 MIME타입 얻기, 요청 전달하기, 로그 파일에 쓰기 등...
즉 서블릿 컨테이너와 서블릿 사이에서 둘을 연결하는 데 필요한 각종 메서드를 제공한다.
ServletContext객체는 ServletConfig객체 - 서블릿이 초기화될 때 웹 서버가 제공하는 객체 - 안에 포함된다.

Object getAttribute(String name)

해당 이름의 서블릿 컨테이너 속성을 반환하거나, 해당 이름의 속성이 없으면 null을 반환한다.

void SetAttribute(String name, Object object)

해당 이름에 객체를 바인딩한다.

---

4. Interface ServletRequest

서블릿에 클라이언트의 요청에 대한 정보를 제공하는 객체를 정의한다. 서블릿 컨테이너가 ServletRequest 객체를 만들고, 서블릿의 service 메서드의 인자로 전달한다.
ServletRequest 객체는 매개변수parameter의 이름과 값, 속성attribute, 입력 스트림을 포함하는 데이터를 제공한다.
ServletRequest를 상속받는 인터페이스는 추가적인 프로토콜별 데이터를 제공할 수 있다(예를 들어 HttpServletRequest는 HTTP데이터를 제공한다).

Object getAttribute(String name)

해당 이름의 속성 값을 객체로 반환한다 - 없으면 null 반환.

void SetAttribute(String name, Object o)

이 요청에 속성을 저장한다.

---

5. Interface ServletResponse

서블릿이 클라이언트에 응답을 보낼 수 있게 돕는 객체를 정의한다. 서블릿 컨테이너가 이 객체를 만들어 서블릿의 service 메서드의 인자로 전달한다.

---

6. Interface RequestDispatcher

요청Request을 파일에서 파일로 전달하는 역할. 말 그대로 dispatcher.

클라이언트로부터 요청을 받고 그 요청을 서버의 여러 리소스(resource - 서블릿, html파일, jsp파일 등)으로 보내는 객체를 정의한다. 서블릿 컨테이너가 RequestDispatcher 객체를 만들면 서버 리소스를 감싸는 wrapper로 사용된다. 서블릿의 wrapper로 의도된 인터페이스지만 서블릿 컨테이너는 RequestDispatcher 객체를 만들어 어떤 리소스든 wrap할 수 있다.

void forward(ServletRequest request, ServletResponse response)

서블릿으로부터 서버의 다른 리소스(서블릿, jsp파일, html파일)로 요청을 전달한다.
이때 요청과 함께 response응답에 대한 책임도 함께 다른 서블릿으로 아예 넘긴다.

void include(ServletRequest request, ServletResponse response)

응답에 리소스의 내용(서블릿, jsp파일, html파일)을 포함한다.
이때는 요청을 다른 서블릿으로 넘겼다가 다시 돌려받는다. 따라서 response에 대한 책임(제어권)은 처음 고객이 요청한 서블릿이 다시 가져오게 된다.

RequestDispatcher 객체는 ServletContext나 ServletRequest의 getRequestDispatcher()메서드를 통해 얻을 수 있다.

참고: https://dololak.tistory.com/502

ServletRequest를 통해 얻을 경우

JSP페이지에는 ServletRequest의 instance인 request 내장 객체가 있으므로 request로 쉽게 얻을 수 있다.
HttpServletRequest에서는 URL경로를 통해서만 대상을 지정할 수 있다. 하지만 ServletContext와는 다르게 절대경로 및 상대경로 모두 지정 가능하다.

RequestDispatcher dispatcher = request.getRequestDispatcher("/login.do");

ServletContext를 통해 얻을 경우

web.xml에 지정한 서블릿 이름 또는 URL경로(절대 경로로만 가능)로 얻을 수 있다.

대상을 지정한 RequestDispatcher 객체로 forward, include 메서드를 실행하면 해당 자원(resource)으로 요청을 넘기게 된다.