[Java] WebContent 와 /src/main/webapp의 차이점

1. 서론

그동안 내가 알던 이클립스에서 jsp 파일이 들어가는 폴더는 /src/main/webapp 인데 다른 블로그를 보다가 webContent로 되어 있는 걸 발견해서 차이점이 궁금해 찾아보게 됐다.
 

2.  공통점 

WebContent와 /src/main/webapp는 두 가지 다른 구조에서 같은 역할을 하는 폴더이다.

3. 차이점

기존 Eclipse 방식에서는 WebContent 폴더가 웹 리소스를 포함하는 폴더였고,
최신 Maven/Gradle 방식에서는 /src/main/webapp가 해당 역할을 대신한다. 
 
Why?

Maven, Gradle 구조에서는 소스 코드(src)와 웹 리소스(webapp)가 나뉘어서 /src/main 아래에 따로 들어가기 때문이다.

 
 

▶ WebContent

예전 방식의 Dynamic Web Project에서 사용되던 디렉터리이다.
현재에도 이클립스의 상단 메뉴에서 파일 > 새로만들기 > Dynamic Web Project를 선택하여 만든 경우에 WebContent 가 생성이 된다. 
 
예전 방식의 WebContent 구조

ProjectName/
├── WebContent/
│   ├── META-INF/                # 메타 정보
│   ├── WEB-INF/                 # 서블릿 설정 등
│   │   ├── web.xml              # 서블릿 설정 파일
│   ├── index.jsp                # JSP 파일
│   └── static/                  # 정적 파일 (CSS, JS 등)
└── src/                          # 자바 소스 코드

 

▶ /src/main/webapp

Project를 Maven 이나 Gradle 로 만드는 경우 `/src/main/webapp`가 표준 디렉터리로  생성된다.

즉 webapp 폴더는 Maven, Gradle 등 모던 빌드 시스템에서 표준화된 웹 애플리케이션 리소스 폴더이다.

---

webapp 폴더의 도입 배경

기존의 Dynamic Web Project에서는 WebContent 폴더 아래에 웹 리소스 (JSP 파일, HTML 파일, 이미지, CSS 등)와 WEB-INF 폴더, web.xml 등을 배치했다.

반면, 2004년 빌드 관리와 의존성 관리를 간소화하려는 목적으로 `Maven Project`가 야심차게 출시되었고, 이후  Maven에서는 모든 리소스를 src/main/webapp/ 폴더에 배치하는 구조를 채택하면서 프로젝트 구조의 표준화를 유도하는데 크게 기여했다. 아래에서 자세히 살펴 보겠지만 결국 웹 리소스들, 자바코드, 자바 테스트 코드를 각각 다른 폴더로 분류하여 관리하려는 목적이다.

---

Maven/Gradle 기준 구조 (현대적 구조)

ProjectName/
├── src/
│   ├── main/
│   │   ├── java/                # 자바 소스 코드
│   │   ├── resources/           # 설정 파일 등
│   │   └── webapp/              # 웹 리소스들 (JSP, HTML, 이미지, CSS)
│   │       ├── WEB-INF/         # 서블릿 설정 등
│   │       │   ├── web.xml      # 서블릿 설정 파일
│   │       ├── index.jsp        # JSP 파일
│   │       └── static/           # 정적 파일 (CSS, JS 등)
└── pom.xml                      # Maven 프로젝트 설정 파일

 
Main 폴더 안쪽 ▼
⚡src/main/webapp
 - 웹 애플리케이션의 웹 리소스들을 저장하는 폴더. WEB-INF 폴더, index.jsp, 정적 파일들이 들어감
⚡ src/main/java
 - 자바 소스 파일들이 위치하는 폴더
⚡ src/test/java
 - 테스트 코드가 위치하는 폴더

---

J2EE(Java 2 Platform, Enterprise Edition)와 이후 Java EE 표준에서는 웹 애플리케이션 구조를 정의하면서, 웹 리소스를 관리하기 위한 webapp 폴더 개념이 도입되었다. J2EE는 1999년에 등장해서 서블릿과 JSP 파일을 포함한 웹 애플리케이션 구조를 표준화했다. 이후 Java EE로 발전하면서 지금은 엔터프라이즈급 웹 애플리케이션의 표준으로 자리 잡았다.

2004년 Maven이 자동화된 빌드 시스템을 도입하면서 src/main/webapp 폴더를 기본 경로로 설정하고, 이를 통해 웹 리소스(HTML, JSP, 이미지, JavaScript, CSS 등)를 관리하게 되었다. Maven은 웹 애플리케이션의 디렉토리 구조를 표준화하고, 빌드 및 배포의 효율성을 높였다.
 
이후 2007년에 출시된 Gradle 등 다른 빌드 도구도 Maven의 영향을 받아 webapp 폴더를 채택했으며, 이후 대부분의 웹 애플리케이션에서 이 구조가 표준으로 자리 잡았다. 현재 이 구조는 프로젝트 파일과 리소스를 효율적으로 관리하고, 협업 시 일관성을 제공하는 중요한 기준이다. 
 
결론

WebContent는 과거에 많이 사용되던 방식이며 현재 최신 기술로는 대부분 /src/main/webapp 아래 리소스를 둔다. 왜? Maven 빌드 시스템과 호환되는 구조이니까

 

---

참고 자료

1. Maven 공식 문서: Maven의 프로젝트 구조 및 표준에 관한 설명은 Maven Documentation 에서 확인할 수 있다.
2. Java EE (Jakarta EE): Java EE의 웹 애플리케이션 구조에 대한 설명은 Jakarta EE official site에서 확인할 수 있다.

---

 더 심도있게 알아보고 싶은 분들은 ▼

[Web] web.xml 설정 내용, 역할 및 간단한 예시 이해하기 - Heee's Development Blog

웹 어플리케이션 폴더 구성과 URL 매핑