Spring MVC 상품 관리 시스템 (교육용)

Spring Boot 없이 순수 Spring MVC 7.x 로 구축한 교육용 웹 애플리케이션입니다.

---

아키텍처 개요

Browser
│
│ HTTP Request (예: GET /products)
▼
┌─────────────────────────────────────────────────────────────────┐
│ Apache Tomcat 11.x │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ DispatcherServlet (프론트 컨트롤러) │ │
│ │ - 모든 요청의 단일 진입점 │ │
│ │ - HandlerMapping으로 적절한 Controller 탐색 │ │
│ │ - ViewResolver로 최종 HTML 렌더링 │ │
│ └──────────────┬───────────────────────────────────────────┘ │
│ │ 요청 위임 │
│ ┌──────────────▼───────────────────────────────────────────┐ │
│ │ Controller (웹 계층) │ │
│ │ - @RequestMapping 으로 URL과 메서드 연결 │ │
│ │ - Service 호출 후 Model에 데이터 담기 │ │
│ │ - 반환할 View 이름 결정 │ │
│ └──────────────┬───────────────────────────────────────────┘ │
│ │ 비즈니스 로직 위임 │
│ ┌──────────────▼───────────────────────────────────────────┐ │
│ │ Service (비즈니스 계층) │ │
│ │ - @Transactional 로 트랜잭션 경계 정의 │ │
│ │ - 비즈니스 규칙 검증 (가격 > 0 등) │ │
│ │ - Repository 호출 조합 │ │
│ └──────────────┬───────────────────────────────────────────┘ │
│ │ 데이터 접근 위임 │
│ ┌──────────────▼───────────────────────────────────────────┐ │
│ │ Repository (데이터 접근 계층) │ │
│ │ - @PersistenceContext EntityManager 주입 │ │
│ │ - JPQL 쿼리 실행 (find, createQuery 등) │ │
│ └──────────────┬───────────────────────────────────────────┘ │
│ │ SQL 실행 │
│ ┌──────────────▼───────────────────────────────────────────┐ │
│ │ EntityManager (JPA / Hibernate) │ │
│ │ - 영속성 컨텍스트(1차 캐시) 관리 │ │
│ │ - JPQL → SQL 변환 │ │
│ │ - 더티 체킹(Dirty Checking) 으로 자동 UPDATE │ │
│ └──────────────┬───────────────────────────────────────────┘ │
└─────────────────┼───────────────────────────────────────────────┘
│ JDBC
▼
MySQL 9.x (Docker)

---

프로젝트 구조

helloSpringMVC/
├── pom.xml # Maven 빌드 설정 및 의존성
├── docker-compose.yml # MySQL + Tomcat 컨테이너 설정
├── init.sql # DB 초기화 스크립트 (테이블 생성 + 샘플 데이터)
├── mysql-data/ # MySQL 데이터 파일 저장 폴더 (자동 생성, git 제외)
├── .gitignore
├── README.md
└── src/
└── main/
├── java/kr/ac/hansung/cse/
│ ├── config/
│ │ ├── WebAppInitializer.java # web.xml 대체 (Servlet 컨테이너 설정)
│ │ ├── WebConfig.java # MVC 설정 (ViewResolver, 정적 리소스)
│ │ └── DbConfig.java # JPA/DB 설정 (DataSource, EntityManagerFactory)
│ ├── model/
│ │ └── Product.java # JPA 엔티티 (@Entity, @Table)
│ ├── repository/
│ │ └── ProductRepository.java # 데이터 접근 (@PersistenceContext EntityManager)
│ ├── service/
│ │ └── ProductService.java # 비즈니스 로직 (@Transactional)
│ └── controller/
│ └── ProductController.java # 웹 요청 처리 (@Controller)
└── webapp/
└── WEB-INF/
└── views/
├── productList.html # 상품 목록 (Thymeleaf)
├── productDetail.html # 상품 상세
└── productForm.html # 상품 등록 폼

---

기술 스택

분류	기술	버전
언어	Java	21 (LTS)
웹 프레임워크	Spring MVC	7.0.x
뷰 엔진	Thymeleaf	3.1.x
ORM	Hibernate (JPA)	7.0.x
데이터베이스	MySQL	9.1
서블릿 컨테이너	Apache Tomcat	11.0
빌드 도구	Maven	3.x
인프라	Docker Compose	-

---

실행 방법

사전 요구사항

• Java 21+
• Maven 3.6+
• Docker Desktop

1단계: WAR 파일 빌드

mvn clean package -DskipTests

빌드 성공 시 target/ROOT.war 파일이 생성됩니다.

2단계: Docker Compose로 실행

# 컨테이너 시작 (백그라운드)
docker compose up -d
# 로그 확인 (Ctrl+C로 종료)
docker compose logs -f

컨테이너가 시작되면 프로젝트 폴더 안에 mysql-data/ 디렉터리가 자동으로 생성되고, MySQL 데이터 파일이 그 안에 저장됩니다. 탐색기(또는 ls)로 직접 확인할 수 있습니다.

3단계: 브라우저 접속

http://localhost:8080/products

컨테이너 중지

# 컨테이너 중지 (mysql-data/ 폴더가 남아있으므로 데이터 보존)
docker compose down
# DB 데이터까지 초기화하려면 폴더를 직접 삭제
rm -rf ./mysql-data

---

Spring Context 구조

Root ApplicationContext (DbConfig)
├── DataSource (MySQL 연결)
├── EntityManagerFactory (JPA 설정)
├── TransactionManager (@Transactional 처리)
├── ProductRepository (@Repository)
└── ProductService (@Service)
│ (부모-자식 관계)
▼
Servlet ApplicationContext (WebConfig) - DispatcherServlet 소유
├── ThymeleafViewResolver
├── SpringTemplateEngine
└── ProductController (@Controller)
│ 부모 컨텍스트의 ProductService를 참조 가능

---

의존성 주입(DI) 흐름

Spring IoC 컨테이너
│
├── ProductRepository 빈 생성
│ └── @PersistenceContext EntityManager 주입
│
├── ProductService 빈 생성
│ └── 생성자 주입: ProductRepository 주입
│
└── ProductController 빈 생성
└── 생성자 주입: ProductService 주입

---

주요 URL

HTTP Method	URL	설명	Controller 메서드
GET	/products	상품 목록	listProducts()
GET	/products/{id}	상품 상세	productDetail()
GET	/products/create	등록 폼 표시	showCreateForm()
POST	/products/create	상품 등록 처리	createProduct()

---

학습 포인트

1. web.xml 없는 서블릿 설정: WebAppInitializer가 AbstractAnnotationConfigDispatcherServletInitializer를 상속하여 Java 코드로 서블릿 등록
2. 두 개의 ApplicationContext: Root(DB/Service)와 Servlet(Web/Controller) 컨텍스트의 부모-자식 관계
3. @PersistenceContext: 스레드 안전한 EntityManager 프록시 주입 방식
4. @Transactional AOP: 트랜잭션 경계를 비침투적으로 적용하는 AOP 기반 처리
5. PRG 패턴: POST 후 리다이렉트로 중복 제출 방지
6. Thymeleaf 폼 바인딩: th:object, th:field를 활용한 양방향 데이터 바인딩