Java Web Application의 기본

E01. Java Web App은 어떻게 동작하는가 — Tomcat과 Servlet의 역할

브라우저가 보낸 요청을 Tomcat이 받아 Servlet으로 전달하고, Servlet과 JSP가 만든 응답이 다시 브라우저로 돌아오는 흐름을 이해합니다.

이번 편에서 알아볼 내용

Java Web 개발을 처음 시작하면 Tomcat, Servlet, JSP라는 이름을 거의 동시에 만나게 됩니다. 각각의 사용법을 익히기 전에, 이들이 하나의 요청을 처리할 때 어떤 역할을 맡는지 먼저 살펴보겠습니다.

이번 편의 목표는 다음 세 가지입니다.

  • 브라우저와 서버가 HTTP 요청과 응답을 주고받는 흐름을 설명할 수 있습니다.
  • Tomcat, Servlet, JSP의 역할을 구분할 수 있습니다.
  • Java Web Application이 실행되는 위치와 브라우저에 전달되는 결과를 이해합니다.

아직 Tomcat을 설치하거나 코드를 작성할 필요는 없습니다. 설치와 첫 애플리케이션 실행은 E02에서, 프로젝트 구조는 E03에서, Servlet과 JSP를 연결하는 실습은 E04에서 진행합니다.

1. 웹 페이지는 요청과 응답으로 만들어진다

브라우저의 주소창에 다음 주소를 입력했다고 생각해봅시다.

http://localhost:8080/hello-app/hello

이 주소에서는 내 컴퓨터의 8080번 포트에서 실행 중인 서버에 /hello-app/hello 경로를 요청합니다. localhost는 브라우저가 실행되는 내 컴퓨터를 가리킵니다.

브라우저는 서버에 HTTP 요청을 보내고, 서버는 요청을 처리한 뒤 HTTP 응답을 돌려줍니다.

브라우저 ── HTTP 요청 ──▶ 서버
브라우저 ◀─ HTTP 응답 ── 서버

요청에는 경로뿐 아니라 GET이나 POST 같은 HTTP 메서드, 헤더, 경우에 따라 본문도 포함됩니다. 응답에는 처리 결과를 나타내는 상태 코드와 헤더, 그리고 HTML 같은 본문이 포함될 수 있습니다.

예를 들어 서버가 HTML을 응답하면 브라우저는 그 내용을 해석해 화면을 그립니다. HTML에서 CSS나 JavaScript, 이미지를 참조하면 브라우저가 해당 자원을 추가로 요청할 수도 있습니다. 따라서 화면 하나를 여는 일이 반드시 요청 한 번으로 끝나는 것은 아닙니다.

여기서 Java Web Application이 맡는 핵심 작업은 요청을 받아 필요한 처리를 수행하고, 그 결과를 응답으로 만드는 것입니다.

2. 정적 파일과 동적으로 만드는 응답

서버가 항상 Java 코드를 실행해 HTML을 만들어야 하는 것은 아닙니다. 이미 저장된 HTML 파일을 그대로 전달할 수도 있습니다.

반면 같은 경로를 요청하더라도 입력값이나 로그인 상태에 따라 다른 내용을 보여줘야 할 때가 있습니다. 다음처럼 이름을 전달하는 경우를 생각해봅시다.

/hello-app/hello?name=Java

서버가 name 값을 읽고 인사말을 만들면 다음과 같은 HTML을 응답할 수 있습니다.

<h1>안녕하세요, Java!</h1>

이처럼 요청에 따라 결과를 만드는 역할을 Java 코드로 구현하는 것이 이번 가이드에서 다룰 출발점입니다. 이후에는 데이터베이스에서 읽어온 정보도 응답에 포함하게 됩니다.

3. Tomcat: 요청을 받고 애플리케이션을 실행하는 기반

Java로 요청 처리 코드를 작성했다고 해서 브라우저가 그 코드를 직접 호출할 수 있는 것은 아닙니다. 네트워크로 들어오는 HTTP 요청을 받고, 적절한 애플리케이션과 처리 코드로 연결해줄 실행 환경이 필요합니다.

이 가이드에서는 그 역할을 Tomcat이 맡습니다. Tomcat은 HTTP 요청을 직접 받을 수 있으며, Servlet을 실행하고 관리하는 Servlet 컨테이너를 제공합니다.

컨테이너라는 용어가 낯설다면, 여기서는 “Servlet이 요청을 처리할 수 있도록 실행 환경과 생명주기를 관리하는 장치”로 이해하면 됩니다. 이때의 컨테이너는 Docker 컨테이너를 뜻하는 말이 아닙니다.

Tomcat은 요청 처리 과정에서 다음과 같은 일을 맡습니다.

  • HTTP 요청을 받아 요청과 응답을 다룰 객체를 제공합니다.
  • 요청 경로와 설정을 바탕으로 실행할 Servlet을 찾습니다.
  • Servlet의 생성, 초기화, 요청 처리 호출, 종료를 관리합니다.
  • 애플리케이션이 작성한 응답을 클라이언트로 전달합니다.

일반적으로 요청마다 Servlet 객체를 새로 만드는 것은 아닙니다. 컨테이너가 관리하는 Servlet 인스턴스가 여러 요청을 처리할 수 있고, 동시에 호출될 수도 있습니다. 따라서 요청별 데이터를 Servlet의 인스턴스 필드에 보관하면 다른 요청과 섞일 위험이 있습니다. 구체적인 작성 방법은 Servlet 실습에서 살펴보겠습니다.

Tomcat은 정적 파일도 제공할 수 있습니다. 학습 단계에서는 별도의 웹 서버 없이 브라우저가 Tomcat으로 직접 요청을 보내는 구성을 사용합니다.

4. Servlet: 요청을 해석하고 처리 방향을 정하는 Java 코드

Servlet은 컨테이너 안에서 요청을 처리하는 Java 구성 요소입니다. HTTP 요청을 다룰 때는 보통 HttpServlet을 상속한 클래스를 작성하고, GET 요청은 doGet, POST 요청은 doPost 같은 메서드에서 처리합니다.

인사말 화면을 만드는 Servlet이라면 다음과 같은 일을 할 수 있습니다.

  1. 요청에서 name 값을 읽습니다.
  2. 값이 비어 있으면 사용할 기본 이름을 정합니다.
  3. 화면에 보여줄 인사말을 만듭니다.
  4. 인사말을 JSP에 전달하고 화면 생성을 맡깁니다.

이때 자주 만나는 두 객체가 Request와 Response입니다.

객체 역할 사용 예
Request 클라이언트의 요청 정보에 접근하고, 같은 요청을 처리하는 서버 구성 요소 사이에 데이터를 전달합니다. 요청 파라미터 읽기, JSP에 전달할 속성 저장
Response 클라이언트로 보낼 응답을 구성합니다. 상태 코드와 콘텐츠 타입 설정, 응답 본문 작성

Request에서 읽은 파라미터와 Servlet이 Request에 저장한 속성은 구분해야 합니다. 파라미터는 이 예제에서 브라우저가 보낸 name=Java 같은 입력이고, 속성은 Servlet이 처리한 결과를 JSP에 전달하기 위해 서버 내부에서 저장하는 값입니다.

Servlet이 HTML을 직접 작성해 응답하는 것도 가능합니다. 다만 화면이 복잡해질수록 Java 코드 안에 HTML을 작성하고 수정하기가 불편해집니다. 이 가이드에서는 Servlet이 요청 처리와 화면에 필요한 데이터 준비를 맡고, JSP가 HTML 생성을 맡도록 구성합니다.

5. JSP: 서버에서 HTML을 만드는 화면 템플릿

JSP는 HTML 중심의 문서 안에서 서버의 데이터를 사용해 응답 내용을 만들 수 있는 기술입니다. Servlet이 준비한 인사말을 JSP가 화면의 적절한 위치에 넣는 식으로 사용합니다.

여기서 기억할 점은 JSP가 서버에서 실행된다는 것입니다. 브라우저는 JSP 원본이나 Java 코드를 실행하지 않습니다. 서버가 JSP를 처리한 결과인 HTML을 받아 화면에 표시합니다.

또한 JSP는 Servlet과 완전히 별개인 실행 체계가 아닙니다. Tomcat의 JSP 엔진은 JSP를 Servlet 코드로 변환하고 컴파일해 실행합니다. 이 작업은 보통 처음 접근할 때 필요에 따라 이루어지며, 미리 컴파일하는 구성도 가능합니다. 매 요청마다 JSP를 처음부터 다시 컴파일하는 것은 아닙니다.

역할을 기준으로 보면 다음과 같이 정리할 수 있습니다.

구성 요소 이번 예제에서 맡는 역할
Tomcat 요청을 받고 Servlet과 JSP가 실행될 환경을 제공합니다.
Servlet 요청값을 읽고 처리한 뒤 화면에 필요한 데이터를 준비합니다.
JSP 전달받은 데이터를 사용해 HTML을 만듭니다.
브라우저 서버가 보낸 HTML을 해석하고 화면을 표시합니다.

6. 요청 하나가 처리되는 전체 흐름

지금까지의 역할을 하나로 연결해보겠습니다. 아래는 앞으로 만들 인사말 애플리케이션의 개념적인 흐름입니다. 아직 실행 가능한 파일이나 설정을 만든 상태는 아닙니다.

브라우저
  │
  │ GET /hello-app/hello?name=Java
  ▼
Tomcat
  │ 애플리케이션과 Servlet 매핑 확인
  ▼
HelloServlet
  │ name 파라미터 읽기
  │ 인사말을 만들어 Request 속성에 저장
  │ JSP로 forward
  ▼
JSP 실행
  │ 전달받은 인사말을 포함한 HTML 생성
  ▼
Tomcat을 통해 HTTP 응답 전송
  │
  ▼
브라우저가 HTML을 화면에 표시

① 브라우저가 요청을 보낸다

브라우저가 /hello-app/hello?name=Java를 요청합니다. 이 예제에서는 /hello-app이 애플리케이션을 구분하는 컨텍스트 경로이고, /hello가 그 애플리케이션 안에서 Servlet에 매핑할 경로입니다. ? 뒤의 name=Java는 쿼리 문자열입니다.

② Tomcat이 실행할 Servlet을 찾는다

Tomcat은 /hello-app에 해당하는 애플리케이션을 찾고, 그 안에서 /hello에 매핑된 Servlet으로 요청을 전달합니다.

URL이 반드시 실제 파일의 위치를 가리키는 것은 아닙니다. /hello라는 파일이 없어도 해당 경로를 Servlet에 연결할 수 있습니다. 이 연결을 URL 매핑이라고 하며, 구체적인 설정은 이후 실습에서 다룹니다.

③ Servlet이 데이터를 준비한다

Servlet은 name 파라미터를 읽고 인사말을 만듭니다. 그리고 JSP가 사용할 수 있도록 Request에 속성으로 저장합니다.

사용자 입력은 신뢰할 수 있는 값으로 가정해서는 안 됩니다. 실제 화면에 출력할 때는 HTML 문맥에 맞는 이스케이프가 필요하며, 출력 방법은 E04에서 함께 다룹니다.

④ JSP로 처리를 넘긴다

Servlet은 준비한 데이터를 사용해 화면을 만들도록 JSP로 forward합니다. Forward는 서버 내부에서 같은 요청의 처리를 다른 자원으로 넘기는 동작입니다.

브라우저가 JSP 주소로 새 요청을 보내는 것이 아니므로, 주소창에는 기존 요청 주소가 유지됩니다. 또한 같은 요청 안에서 이동하므로 Servlet이 Request에 저장한 속성을 JSP에서 사용할 수 있습니다.

서버가 브라우저에 다른 주소로 다시 요청하도록 응답하는 redirect와는 동작이 다릅니다. 두 방식의 구체적인 사용법은 E04에서 비교합니다.

⑤ HTML 응답이 브라우저로 돌아간다

JSP가 인사말을 포함한 HTML을 생성하면, 그 결과가 HTTP 응답으로 브라우저에 전달됩니다. 브라우저는 전달받은 HTML을 해석해 화면에 표시합니다.

이 흐름에서 Servlet과 JSP는 모두 Tomcat이 제공하는 서버 실행 환경 안에서 동작합니다. 위 그림의 화살표는 Tomcat 밖의 별도 프로그램으로 요청이 이동한다는 의미가 아니라, 서버 내부의 처리 순서를 나타냅니다.

7. 모든 요청이 JSP를 거치는 것은 아니다

이번 가이드에서는 Servlet과 JSP를 연결해 HTML 화면을 만드는 방식으로 시작합니다. 하지만 모든 Java Web 요청이 이 경로를 따라야 하는 것은 아닙니다.

  • CSS나 이미지 같은 정적 자원은 사용자 작성 Servlet이나 JSP를 거치지 않고 제공될 수 있습니다.
  • Servlet이 직접 HTML이나 JSON을 응답할 수 있습니다.
  • 다른 주소로 redirect하거나 파일을 다운로드하는 응답도 가능합니다.

따라서 브라우저 → Tomcat → Servlet → JSP는 이번에 학습할 화면 생성 흐름입니다. 더 넓게 보면 공통 구조는 “요청을 받아 처리하고, 목적에 맞는 응답을 만든다”입니다.

8. 이해했는지 확인하기

다음 질문에 자신의 말로 답해보세요.

  1. Tomcat과 Servlet은 각각 어떤 일을 하나요?
  2. /hello라는 파일이 없어도 해당 주소로 요청을 처리할 수 있는 이유는 무엇인가요?
  3. Servlet이 JSP로 forward할 때 브라우저가 새 요청을 보내나요?
  4. 브라우저가 받는 것은 JSP 원본인가요, JSP가 생성한 HTML인가요?
  5. JSON을 응답하는 경우에도 JSP가 반드시 필요한가요?

답을 확인하면, Tomcat은 요청 수신과 Servlet 실행 환경을 담당하고 Servlet은 애플리케이션의 요청 처리 코드를 담당합니다. URL 매핑이 경로와 Servlet을 연결하므로 같은 이름의 파일은 필요하지 않습니다. Forward는 서버 내부에서 이루어지고, 브라우저는 JSP 실행 결과인 HTML을 받습니다. JSON 응답에는 JSP가 필요하지 않습니다.

다음 편 예고

이번 편에서는 브라우저의 요청이 Tomcat에 도착해 Servlet과 JSP에서 처리되고, HTML 응답으로 돌아오는 흐름을 살펴봤습니다.

다음 편 Tomcat 설치부터 첫 Web Application 실행까지에서는 Tomcat을 직접 실행하고, webapps에 첫 애플리케이션을 배포해 브라우저로 접근해보겠습니다.

최종 업데이트: 2026년 10월 6일

E02부터는 로그인하고 이어서 보세요. 지금은 모든 에피소드를 무료로 이용할 수 있고, 시작해 두면 계속 볼 수 있습니다.

다음 편 · E02. Tomcat 설치부터 첫 Web Application 실행까지

댓글 0

이용을 시작하면 댓글을 보고 남길 수 있습니다.