[스프링 핵심 원리와 활용] #4. 스프링 부트와 내장 톰캣

[724thomas]

스프링 부트와 내장 톰캣 정리 노트

---

1. WAR 배포 방식의 한계와 내장 톰캣의 필요성

1-1. WAR(Web Application Archive) 방식이란?

• 전통적으로 자바 웹 애플리케이션은 WAR 파일로 패키징하여 WAS(Web Application Server)인 톰캣, 제티, 언더토우 등에 배포함.
• WAR는 톰캣의 webapps/ 폴더에 위치해야 실행이 가능함.

1-2. WAR 방식의 단점

1. 별도의 톰캣 설치 필요: 서버마다 수동 설치 및 설정 필요.
2. 배포 복잡도 증가: WAR 파일을 빌드하고 배포하는 과정이 번거로움.
3. 톰캣 버전 업그레이드 번거로움: 서버의 톰캣을 다시 설치해야 함.
4. 개발 환경 설정 복잡: 개발자가 직접 로컬에 톰캣 설정을 맞추어야 함.

1-3. 내장 톰캣의 등장 배경

• 자바는 main() 메서드 하나로 실행이 가능함.
• "톰캣을 아예 애플리케이션 안에 포함시켜, main()만 실행하면 되지 않을까?" → 내장 톰캣(Embedded Tomcat) 방식 도입.

---

2. 내장 톰캣 프로젝트 설정

2-1. Gradle 설정 예시

dependencies {
    implementation 'org.springframework:spring-webmvc:6.0.4'
    implementation 'org.apache.tomcat.embed:tomcat-embed-core:10.1.5'
}

2-2. 빌드 설정 (Fat Jar 포함)

task buildFatJar(type: Jar) {
    manifest {
        attributes 'Main-Class': 'hello.embed.EmbedTomcatSpringMain'
    }
    from {
        configurations.runtimeClasspath.collect { it.isDirectory() ? it : zipTree(it) }
    }
    with jar
}

---

3. 내장 톰캣 실행 코드 (Servlet 기반)

3-1. 예제 코드

Tomcat tomcat = new Tomcat();
tomcat.setPort(8080);

Context context = tomcat.addContext("", "/");
tomcat.addServlet("", "helloServlet", new HelloServlet());
context.addServletMappingDecoded("/hello-servlet", "helloServlet");

tomcat.start();

---

4. 내장 톰캣 + 스프링 연동

4-1. DispatcherServlet 등록 예시

AnnotationConfigWebApplicationContext appContext = new AnnotationConfigWebApplicationContext();
appContext.register(HelloConfig.class);

DispatcherServlet dispatcher = new DispatcherServlet(appContext);

Context context = tomcat.addContext("", "/");
tomcat.addServlet("", "dispatcher", dispatcher);
context.addServletMappingDecoded("/", "dispatcher");

---

5. 일반 JAR vs Fat Jar

5-1. 일반 JAR의 한계

• 기본 jar는 클래스만 포함
• 종속 라이브러리는 포함되지 않음 → 실행 시 ClassNotFoundException 발생

5-2. Fat Jar란?

• 모든 라이브러리 .class를 하나로 묶은 뚱뚱한 JAR
• 단일 파일 배포 가능

---

6. MySpringApplication: 커스텀 부트 클래스

6-1. 역할

• 내장 톰캣 설정
• 스프링 컨테이너 등록
• DispatcherServlet 등록

---

7. 스프링 부트 도입 및 구조 분석

7-1. 프로젝트 구조

• @SpringBootApplication 애노테이션 포함
• SpringApplication.run() 호출

7-2. 내부 동작

1. AnnotationConfigServletWebServerApplicationContext 생성
2. 톰캣 인스턴스 생성 및 실행
3. DispatcherServlet 자동 등록

---

8. 스프링 부트 JAR 실행 구조

8-1. 실행 가능한 JAR 구조

• META-INF, BOOT-INF/lib, BOOT-INF/classes 등으로 구성
• JarLauncher → Start-Class 실행 구조

---

9. Fat Jar vs 스프링 부트 실행 가능 JAR 비교

항목	Fat Jar	실행 가능 JAR (Spring Boot)
구조	클래스 파일 직접 포함	JAR 안에 JAR 포함
라이브러리 충돌	있음	없음 (분리 관리 가능)
META-INF 충돌	발생 가능	별도 처리 구조 있음
실행 클래스	바로 실행	JarLauncher → Start-Class 실행

---

10. 정리 및 결론

• 스프링 부트는 내장 톰캣, 실행 가능한 JAR, 자동 설정 기능으로 배포/실행을 단순화함.
• WAR 기반 환경은 유지보수나 배포 측면에서 불편함이 큼.
• main()만 실행하면 전체 웹 서버가 구동되는 구조는 백엔드 개발자에게 매우 유용함.
• https://github.com/724thomas/boot_practice.git