[Servlet] 환경세팅

📍 프로그램 다운로드

• WAS(웹 서버 + 서블릿 컨테이너) 역할을 할 1️⃣ Apache Tomcat과
• 서블릿을 생성하기 위한 2️⃣ Eclipse, 3️⃣ JDK를 설치해야 한다.

• Apache Tomcat

  • Tomcat 9을 다운로드(Core > zip)한다.

• Eclipse

  • Eclipse IDE for Enterprise Java and Web Developers를 다운로드한다. Download 버튼 아래 있는 Select Another Mirror에서 Korea, Republic Of - Kakao Corp.을 선택하면 더 빠르게 다운로드 받을 수 있다.

• JDK

  • JDK 17을 다운로드한다. 윈도우 환경변수 설정은 해당 포스팅을 참고한다.

📍 Tomcat - Eclipse - Wep Application 연결

• 1) 글자 인코딩 설정
• 2) Eclipse와 Tomcat 연결
• 3) 프로젝트(Web Application) 생성(🚩 반드시 위의 두 단계를 완료한 후 생성해야 한다.)
• 4) Tomcat 서버 생성 + 프로젝트(Web Application)와 연결

1) 글자 인코딩 설정

• 한글 깨짐을 방지하기 위해 Encoding을 UTF-8로 설정하는 작업이다.

• Window는 Window > Preferences, macOS는 Eclipse > Settings 클릭
• General > Workspace > 좌측 하단 Text file encoding 중 Other 선택 > UTF-8 선택
• Web > CSS Files > Encoding ISO 10646/Unicode(UTF-8) 선택
• Web > HTML Files > ISO 10646/Unicode(UTF-8) 선택
• Web > JSP Files > ISO 10646/Unicode(UTF-8) 선택

2) Eclipse와 Tomcat 연결

• Eclipse에서 Tomcat을 사용하여 Web Application을 개발 및 실행할 수 있도록 하는 작업이다. Eclipse에게 Tomcat의 버전과 설치된 디렉터리 위치를 알려줌으로써, Eclipse는 특정 버전의 Tomcat을 인식하고 해당 디렉터리에서 필요한 파일 및 라이브러리를 찾아 사용할 수 있다.

• Window는 Window > Preferences, macOS는 Eclipse > Settings 클릭
• Server 메뉴 > Runtime Environments > Add 버튼 > Tomcat 9 버전 선택 > Browse 버튼 > Tomcat 설치 경로 선택

3) 프로젝트(Web Application) 생성

• 🚩 반드시 글자 인코딩 설정과 Eclipse와 Tomcat 연결을 완료한 후 프로젝트를 생성해야 한다.
• 🚩 반드시 웹 애플리케이션을 배포할 때 사용되는 설정 파일인 web.xml을 자동으로 생성하도록 설정해야 한다.

• File > New > Dynamic Web Project 창: Project name 설정 > Target runtime이 Apache Tomcat v9.0으로 설정되었는지 확인(톰캣 서버 연동 확인) > Next 버튼 클릭
• Java 창: Next 버튼 클릭
• Web Module 창: Generate web.xml deployment descriptor 체크 > Finish 버튼 클릭

Eclipse와 Tomcat이 연결되었는지 확인하려면 프로젝트 이름 > Java Resources > Libraries > Server Runtime [Apache Tomcat v9.0] 폴더에 Tomcat 관련 라이브러리들이 있는지 확인한다.

web.xml 파일이 자동으로 생성되었는지 확인하려면 프로젝트 이름 > src > main > webapp > WEB-INF 폴더에 web.xml 파일이 존재하는 확인한다.

👉 주요 폴더

• src > main > java: Java 소스 코드 파일(Java 클래스)을 저장하는 곳이다. 주로 서버 측 로직이나 비즈니스 로직을 구현한다.
• src > main > webapp: HTML, JSP, 이미지 및 기타 웹 리소스 파일을 저장하는 곳이다. 뷰(View) 관련 파일이 위치하며, 클라이언트에게 표시되는 웹 페이지를 구현한다.

4) Tomcat 서버 생성 + 프로젝트(Web Application)와 연결

• Tomcat 서버를 생성하고, 해당 서버와 연동할 프로젝트(Web Application)를 선택하는 작업이다.

• Server 탭에서 우측 마우스 > New > Server 클릭
• Define a New Server 창: Select the server type에서 Apache의 Tomcat v9.0 Server를 선택 > Next 버튼 클릭
• Add and Remove 창: Tomcat 서버와 연동할 프로젝트(Web Application)를 Configured로 Add > Finish 버튼 클릭

Project Explorer 탭에 Servers 폴더가 생성된다.

📍 프로젝트(Web Application) 실행

• 프로젝트(Web Application)를 브라우저에서 실행하는 작업이다.

• Servers 탭의 Tomcat v9.0 Server at localhost 클릭
• 우측의 벌레 모양 아이콘(Start the server in debug mode)을 클릭하여 서버 실행
• 웹 브라우저를 열고 http://localhost:포트번호/프로젝트명/매핑된주소로 접속

👉 포트번호 생략하기(http://localhost/프로젝트명/매핑된주소)

HTTP의 기본 포트인 80번으로 포트 번호를 변경한다. 설정 변경 시 서버를 종료하는 것이 좋다.

• Servers 탭의 Tomcat v9.0 Server at localhost 더블 클릭
• Overview 탭 클릭
• Ports > HTTP/1.1의 Port Number를 80으로 변경
• Ctrl + S로 저장

👉 프로젝트명 생략하기(http://localhost:포트번호/매핑된주소)

웹 모듈의 경로를 공백으로 설정한다. 설정 변경 시 서버를 종료하는 것이 좋다.

• Servers 탭의 Tomcat v9.0 Server at localhost 더블 클릭
• Modules 탭 클릭
• Web Modules에서 프로젝트(Web Application) 선택 > Edit 버튼 클릭
• Edit Web Modules 창: Path를 공백으로 설정 > OK 버튼 클릭
• Ctrl + S로 저장