[스프링 핵심 원리와 활용] 섹션3. 웹 서버와 서블릿 컨테이너 #801

seyeop03 · 2025-07-11T16:47:16Z

seyeop03
Jul 11, 2025

0x01. 웹 서버와 스프링 부트 소개

${\textsf{\color{orange}1.1. 전통적인 방식}}$

서버에 톰캣 등의 WAS(웹 애플리케이션 서버)를 설치해야 했음.
WAS에서 동작하도록 서블릿 스펙에 맞춰 코드를 작성하고, WAR 형식으로 빌드해서 war 파일 생성하고, war 파일을 WAS에 전달해서 배포하는 방식
IDE 개발 환경에서도 WAS와 연동해서 실행되도록 복잡한 추가 설정이 필요

${\textsf{\color{orange}1.2. 최근 방식}}$

스프링 부트가 내장 톰캣 포함
- 애플리케이션 코드 안에 톰캣 같은 WAS가 라이브러리로 내장
코드를 작성하고 JAR로 빌드한 다음 JAR를 원하는 위치에 실행하기만 하면 WAS도 함께 실행됨
개발자는 main() 메서드만 실행하면 되고 WAS 설치나 IDE와 WAS를 연동하는 복잡한 일을 수행하지 않아도 된다.

옛날 개발자들은 WAS를 설치하고 war를 만들어서 배포하는 것이 익숙하겠지만, 최근 개발자들은 이런 것을 경험할 일이 없다. 그래도 한번은 알아둘 가치가 있다. 과거에 어떻게 했는지 알아야 현재의 방식이 왜 이렇게 사용되고 있는지 더 깊이있는 이해가 가능하다.

서블릿 컨테이너도 설정하고, 스프링 컨테이너도 만들어서 등록하고, 디스패처 서블릿을 만들어서 스프링 MVC와 연결하는 작업을 스프링 부트 없이 직접 경험해보자. 그러면 스프링 부트가 웹 서버와 어떻게 연동되는지 자연스럽게 이해할 수 있을 것이다.

참고로 여기서는 web.xml 대신에 자바 코드로 서블릿을 초기화 한다. 옛날 개발자라도 대부분 web.xml 을 사용했지 자바 코드로 서블릿 초기화를 해본 적은 없을 것이므로 꼭 한번 코드로 함께 따라해보자.

0x02. 스프링 부트 없이 직접 구성

${\textsf{\color{orange} 2.1. 톰캣 설치}}$

톰캣 다운로드
- https://tomcat.apache.org/download-10.cgi
- Download 메뉴에서 Apache Tomcat 10 버전의 톰캣 다운로드
  - Core에 있는 zip 을 선택
- 다운로드 후 압축 풀기
- 다운로드 링크: https://dlcdn.apache.org/tomcat/tomcat-10/v10.1.17/bin/apache-tomcat-10.1.17.zip
톰캣 실행 설정
- MAC, 리눅스 사용자
  - 톰캣폴더/bin 폴더로 이동
  - 권한 부여: chmod 755 *
  - 실행: ./startup.sh
  - 종료: ./shutdown.sh
  - MAC, 리눅스 사용자는 권한을 주지 않으면 permission denied 라는 오류가 발생할 수 있다.
- 윈도우 사용자
  - 톰캣폴더/bin 폴더로 이동
  - 실행: startup.bat
  - 종료: shutdown.bat
톰캣 실행 확인
- 톰캣을 실행한 상태로 다음 URL에 접근하면 톰캣 서버가 실행된 화면을 확인할 수 있다.
  http://localhost:8080/
참고 - 실행 로그 확인
톰캣의 실행 로그는 톰캣폴더 /logs/catalina.out 파일로 확인할 수 있다.
실행이 잘 되지 않을 때 해결 방안

톰캣을 실행했지만 http://localhost:8080/ 에 접근이 되지 않으면 우선 실행 로그를 확인해야 한다. ⇒ 실행 로그 톰캣폴더 ⇒ /logs/catalina.out

만약 다음과 같은 메시지가 보인다면 어떤 프로그램이 이미 8080 포트를 사용하고 있는 것이다.
java.net.BindException: Address already in use

해결방안1 - 해당 포트를 사용하는 프로그램을 종료한다.
8080 포트를 사용하는 프로그램을 찾아서 종료한다. 만약 종료가 어렵다면 컴퓨터를 재부팅 하는 것도 방법이다.

[MAC OS]
sudo lsof -i :8080 프로세스 ID(PID) 조회
sudo kill -9 PID : 프로세스 종료
[윈도우]
cmd를 열고 아래 명령어 순차적으로 실행
1. 현재 포트를 사용중인 프로세스 찾기: netstat -ano | findstr :포트번호
2. 프로세스 강제 종료하기: taskkill /f /pid 프로세스번호
해결방안2 - 톰캣 서버 포트를 변경한다
다음 톰캣 설정 파일을 수정한다. 여기에 보면 8080 이라는 부분이 있는데, 이 부분을 다른 포트로 변경한다. 그리고 톰캣 서버를 종료하고 다시 시작한 다음 다른 포트로 접근한다.
예) 9080 포트로 변경했으면 http://localhost:9080/ 으로 접근한다.

톰캣폴더/conf/server.xml
```
<Connector port="8080" protocol="HTTP/1.1"
 connectionTimeout="20000"
 redirectPort="8443" />
```

이제 이 톰캣 서버에 배포할 애플리케이션 코드를 작성해보자.

${\textsf{\color{orange}2.2. 프로젝트 설정}}$

사전 준비물

Java 17 이상 설치
IDE: IntelliJ 또는 Eclipse 설치

프로젝트 설정 순서

server-start 의 폴더 이름을 server 로 변경하자.
프로젝트 임포트

File ⇒ Open ⇒ 해당 프로젝트의 build.gradle 을 선택하자. 그 다음에 선택창이 뜨는데, Open as Project를 선택하자.

build.gradle
id 'war' : 톰캣 같은 WAS 위에서 동작하는 WAR 파일을 만들어주는 플러그인
jakarta.servlet-api : 서블릿을 사용할 때 필요한 라이브러리

plugins {
		id 'java'
		id 'war'
}

group = 'hello'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

repositories {
		mavenCentral()
}

dependencies {
		//서블릿
		implementation 'jakarta.servlet:jakarta.servlet-api:6.0.0'
}

tasks.named('test') {
		useJUnitPlatform()
}

먼저 간단한 HTML과 순수 서블릿으로 동작하는 웹 애플리케이션을 만들어보자.

(1) 간단한 HTML 등록

웹 서버가 정적 리소스를 잘 전달하는지 확인하기 위해 HTML을 하나 만들어보자.

/src/main 하위에 webapp 이라는 폴더를 만들자
/src/main/webapp/index.html HTML 파일을 생성하자.
```
<html>
		<body>index html</body>
</html>
```

(2) 서블릿 등록

전체 설정이 잘 동작하는지 확인하기 위해 간단한 서블릿을 하나 만들어보자.
웹 서버를 통해 이 서블릿이 실행되어야 한다.

package hello.servlet;

/**
 * http://localhost:8080/test
 */
@WebServlet(urlPatterns = "/test")
public class TestServlet extends HttpServlet {

		@Override
		protected void service(HttpServletRequest req, HttpServletResponse resp) throws IOException {
				System.out.println("TestServlet.service");
				resp.getWriter().println("test");
		}
}

/test 로 요청이 오면 이 서블릿이 실행된다.
“TestServlet.service” 를 로그에 출력한다.
“test” 를 응답한다. 웹 브라우저로 요청하면 이 서블릿이 실행되고 화면에 test 가 출력되어야 한다.

이 서블릿을 실행하려면 톰캣 같은 WAS 에 위 코드를 배포해야 한다. 그러려면 WAR 파일로 만들어야 한다.

${\textsf{\color{orange}2.3. WAR 빌드와 배포}}$

(1) WAR 빌드

WAS에 우리가 만든 코드를 빌드하고 배포해보자.

프로젝트 빌드

프로젝트 폴더로 이동
프로젝트 빌드
[MAC OS] ⇒ ./gradlew build
[윈도우 OS] ⇒ gradlew build
WAR 파일 생성 확인
build/libs/server-0.0.1-SNAPSHOT.war

build.gradle 에 보면 war 플러그인이 사용된 것을 확인할 수 있다. 이 플러그인이 war 파일을 만들어준다.

plugins {
		id 'java'
		**id 'war'**
}

WAR 압축 풀기

우리가 빌드한 war 파일의 압축을 풀어서 내용물을 확인해보자.

build/libs 폴더로 이동하자.
다음 명령어를 사용해서 압축을 풀자
jar -xvf server-0.0.1-SNAPSHOT.war

WAR를 푼 결과

WEB-INF
- classes
  - hello/servlet/TestServlet.class
- lib
  - jakarta.servlet-api-6.0.0.jar
index.html

WAR를 푼 결과를 보면 WEB-INF, classes, lib 같은 특별한 폴더들이 보인다. 이 부분을 알아보자.

(2) JAR, WAR 설명

JAR 소개

jar 실행: java -jar abc.jar
자바는 여러 클래스와 리소스를 묶어 **JAR(Java Archive)**라고 하는 압축파일을 만들 수 있다.
Jar는 쉽게 이야기해서 클래스와 관련 리소스를 압축한 단순한 파일이다.
이 파일을 JVM 위에서 직접 실행할 수도 있고 다른 곳에서 사용되는 라이브러리로 사용할 수 있다.
- 직접 실행하는 경우 main() 메서드가 필요하고 MANIFEST.MF 파일에 실행할 메인 메서드가 있는 클래스를 지정해두어야 한다.

WAR 소개

WAR(Web Application Archive)는 웹 애플리케이션 서버에 배포할 때 사용하는 파일이다.
JAR는 JVM 위에서 실행, WAR는 WAS 위에서 실행된다.
HTML 같은 정적 리소스와 클래스 파일을 모두 함께 포함하기 때문에 JAR와 비교해서 구조가 더 복잡하다.
또한 WAR 구조를 반드시 지켜야 한다.
- WAR 구조
  - WEB-INF
    - classes: 실행 클래스 모음
    - lib: 라이브러리 모음
    - web.xml 웹 서버 배치 설정 파일(생략 가능)
  - index.html: 정적 리소스
WEB-INF 폴더 하위는 자바 클래스와 라이브러리, 설정 정보가 들어가는 곳이다.
WEB-INF를 제외한 나머지 영역은 HTML, CSS 같은 정적 리소스가 사용되는 영역이다.

(3) WAR 배포

이렇게 생성된 WAR 파일을 톰캣 서버에 실제 배포해보자.

톰캣 서버를 종료한다. ⇒ ./shutdown.sh or shutdown.bat
톰캣폴더/webapps 하위를 모두 삭제한다.
- webapps ⇒ 웹애플리케이션이 들어가는 곳
빌드된 server-0.0.1-SNAPSHOT.war 를 복사한다.
톰캣폴더/webapps 하위에 붙여넣는다.
- 톰캣폴더/webapps/server-0.0.1-SNAPSHOT.war
이름을 변경한다.
- 톰캣폴더/webapps/ROOT.war
톰캣 서버를 실행한다. ⇒ ./startup.sh or startup.bat
실행 결과 확인: http://localhost:8080/index.html , http://localhost:8080/test
- 실행해보면 index.html 정적 파일과 /test 경로로 지정한 서블릿 TestServlet 모두 잘 동작하는 것을 확인할 수 있다.

실제 서버에서는 이렇게 사용하면 되지만, 개발 단계에서는 war 파일을 만들고, 이것을 서버에 복사해서 배포하는 과정이 너무 번잡하다.

인텔리 J나 이클립스 같은 IDE는 이 부분을 편리하게 자동화해준다.

${\textsf{\color{orange}2.4. 톰캣 설정 - 인텔리 J}}$

(1) 톰캣 설정 - 인텔리 J (유료 버전)

인텔리J 유료 버전과 무료 버전에 따라 IDE에서 톰캣을 설정하는 방법이 다르다. 여기서는 유료 버전을 설명한다.

인텔리J 유료 버전에는 톰캣 지원이 포함되어 있다.

메뉴 → Run → Edit Configurations... 로 이동
왼쪽 상단의 플러스 버튼을 클릭
Other 하위에 있는 Tomcat Server에 Local을 선택

주의! Tomcat Server 를 선택해야 한다. TomEE Server 를 선택하면 안된다.
Configure… 버튼 선택
Tomcat Home: 부분에 설치된 톰캣 폴더를 선택
Deployment 메뉴 선택 → + 버튼 선택 → 끝에 (exploded)로 끝나는 war 파일을 선택
Application context 박스 안에 있는 내용을 모두 지워준다.
설정한 톰캣을 선택하고 실행한다.
- 실행
  http://localhost:8080/
  http://localhost:8080/test

(2) 톰캣 설정 - 인텔리 J (무료 버전)

주의! 영상에서 설명하는 Tomcat runner 플러그인이 최신 인텔리J 에서 작동하지 않는다.
최신 인텔리J를 사용한다면 지금부터 설명하는 Smart Tomcat 플러그인 설치를 참고하자!

build.gradle 에 다음 내용을 추가

//war 풀기, 인텔리J 무료버전 필요
task explodedWar(type: Copy) {
    into "$buildDir/exploded"
    with war
 }

다음 명령어를 실행
- [Mac OS]: ./gradlew explodedWar
- [Windows OS]: gradlew explodedWar

build/exploded 폴더가 새로 생성되고, 여기에 WEB-INF를 포함한 war가 풀려 있는 모습을 확인할 수 있다.

Smart Tomcat 설정
- 인텔리J 무료 버전에서는 Smart Tomcat 이라는 플러그인을 설치해야 한다.
  - 인텔리J 유료 버전에서는 해당 플러그인을 사용하지 않아도 된다.
- 메뉴 → IntelliJ IDEA → Preferences(Windows는 File → Settings) → plugin → Smart Tomcat 검색 설치 실행 (재시작)
- Smart Tomcat 에서 사용할 톰캣 서버를 별도로 하나 만들어둔다.
  - 여기서는 다운로드 받은 톰캣 서버의 압축을 새로 풀어서 smart-tomcat 이라는 이름의 폴더로 만들어두겠다.
  - 주의! 이 플러그인은 기존 톰캣 서버의 설정을 변경하기 때문에, 이 톰캣 서버를 다른곳에서 함께 사용하면 문제가 발생할 수 있다. 꼭 별도의 톰캣 서버를 준비해두자.
메뉴 → Run → Edit Configurations... 로 이동
좌측 상단의 + 버튼 클릭
Smart Tomcat 선택
화면과 같이 설정
- Tomcat server: 설치한 톰캣의 위치를 지정한다. 오른쪽에 있는 Configure...를 누르면 된다. 아래 화면을 참고하자.
  - 이 화면에서 Tomcat Server의 + 버튼 선택
  - 그리고 설치한 톰캣의 위치를 지정
- Catalina base: 기본 값을 사용한다. (비워두면 된다. 자동으로 채워진다.)
- Deployment directory: 현재 프로젝트 폴더의 build/exploded 로 지정한다.
- User classpath of module: server를 선택한다.
- Context path: /를 입력한다.
- 완료되면 아래에 있는 OK 버튼을 선택하자.
설정한 톰캣을 선택하고 실행
- 실행
  http://localhost:8080/
  http://localhost:8080/test

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[스프링 핵심 원리와 활용] 섹션3. 웹 서버와 서블릿 컨테이너 #801

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Replies: 0 comments

Select a reply

Uh oh!

[스프링 핵심 원리와 활용] 섹션3. 웹 서버와 서블릿 컨테이너 #801

Uh oh!

Uh oh!

seyeop03 Jul 11, 2025

0x01. 웹 서버와 스프링 부트 소개

${\textsf{\color{orange}1.1. 전통적인 방식}}$

${\textsf{\color{orange}1.2. 최근 방식}}$

0x02. 스프링 부트 없이 직접 구성

${\textsf{\color{orange} 2.1. 톰캣 설치}}$

${\textsf{\color{orange}2.2. 프로젝트 설정}}$

(1) 간단한 HTML 등록

(2) 서블릿 등록

${\textsf{\color{orange}2.3. WAR 빌드와 배포}}$

(1) WAR 빌드

(2) JAR, WAR 설명

(3) WAR 배포

${\textsf{\color{orange}2.4. 톰캣 설정 - 인텔리 J}}$

(1) 톰캣 설정 - 인텔리 J (유료 버전)

(2) 톰캣 설정 - 인텔리 J (무료 버전)

Replies: 0 comments

seyeop03
Jul 11, 2025