Hello, jsp! 입문] 톰캣(Tomcat) 설치와 프로젝트 구조 완벽 이해하기

Java 웹 개발 입문] 톰캣(Tomcat) 설치와 프로젝트 구조 완벽 이해하기

안녕하세요! 오늘은 자바 백엔드 개발의 첫걸음인 웹 서버 환경 구축과 프로젝트 설정에 대해 정리해 보려고 합니다. 웹 애플리케이션 서버(WAS)의 대표 주자인 톰캣(Tomcat) 설치부터, 실무에서 중요한 web.xml 설정까지 핵심만 콕콕 집어 전달해 드릴게요!

1. 톰캣(Apache Tomcat) 설치하기

자바 웹 애플리케이션을 구동하기 위해서는 웹 컨테이너가 필요합니다. 톰캣은 데이터베이스와 같은 외부 기능과 연동하여 동작할 수 있게 해주는 가장 대중적인 오픈소스 WAS입니다.

• 다운로드: Apache Tomcat 공식 홈페이지에서 본인에게 맞는 버전(예: Tomcat 9)을 내려받습니다.
• 핵심 역할: 클라이언트의 요청을 받아 서블릿이나 JSP를 실행하고 그 결과를 응답해 주는 '주방장' 역할을 수행합니다

 

2. Eclipse에서 웹 프로젝트 만들기

개발 툴(IDE)인 이클립스에서 본격적인 웹 프로젝트를 생성하는 과정입니다.

1. Dynamic Web Project 생성: New Project 메뉴에서 'Web' 카테고리의 Dynamic Web Project를 선택합니다.
2. 프로젝트 이름 설정: 프로젝트 명(예: webEx)을 입력하고 Target Runtime에서 설치한 톰캣 버전을 연결합니다.
3. web.xml 생성: 설정 마지막 단계에서 'Generate web.xml deployment descriptor' 체크박스를 반드시 선택해야 환경 설정 파일이 자동으로 만들어집니다.

3. Java 웹 프로젝트의 구조 (Structure)

생성된 프로젝트는 다음과 같은 구조를 가집니다. 각 폴더의 역할을 아는 것이 중요합니다.

• src/main/java: 우리가 작성할 실제 자바 서블릿 소스 파일들이 위치하는 곳입니다.
• webapp: HTML, CSS, JavaScript 및 JSP 파일들이 담기는 폴더로, 실제 웹 브라우저에 보여질 자원들이 위치합니다.
• WEB-INF/lib: 프로젝트에서 사용할 **확장 라이브러리(.jar 파일)**를 넣어두는 곳입니다.
• WEB-INF/web.xml: **배포 서술자(Deployment Descriptor)**라고 불리며, 웹 애플리케이션의 전체적인 환경 설정 정보를 담고 있습니다.

---

4. web.xml을 활용한 주요 설정

web.xml은 WAS가 처음 구동될 때 가장 먼저 읽어 톰캣에 적용하는 매우 중요한 파일입니다.

 

① 예외 처리(Error Page) 설정

사용자가 잘못된 경로로 접근하거나 서버에 오류가 났을 때 보여줄 커스텀 페이지를 지정할 수 있습니다.

• 404 에러: 요청한 페이지가 없을 때
• 500 에러: 서버 내부 프로그램 실행 중 오류가 발생했을 때

② 웰컴 파일(Welcome File) 지정

 

브라우저에서 상세 주소 없이 도메인(컨텍스트 이름)만 입력했을 때 자동으로 보여줄 첫 페이지를 등록합니다. 보통 index.html이나 index.jsp 등이 지정됩니다.

---

5. 서버 설정의 핵심: Context

**컨텍스트(Context)**는 톰캣이 인지하는 하나의 독립된 웹 애플리케이션을 지칭합니다.

• 중복 불가: 컨텍스트 이름은 서버 내에서 중복될 수 없으며 대소문자를 엄격히 구분합니다.
• Path와 docBase: path는 브라우저에서 접근하는 가상 경로(컨텍스트 이름)를, docBase는 내 컴퓨터의 실제 위치 경로를 의미합니다.
• Reloadable: 실행 중에 소스 코드가 갱신되었을 때 서버를 자동으로 재시작할지 여부를 결정합니다.

---

마무리하며

자바 웹 개발의 기초 세팅이 완료되었습니다! 이제 이 환경 위에서 **서블릿(Servlet)**과 JSP를 작성하여 동적인 웹 사이트를 만들어갈 수 있습니다.