00. 실습환경 구축

IntelliJ Community 에디션에서 Servlet/JSP 실습 환경을 구축하는 가이드입니다.


1. 프로젝트 생성

2. 폴더 구조 만들기 (중요)

직접 폴더를 우클릭해서 아래 구조를 만듭니다.

src/
  main/
    java/       ← 우클릭 → Mark Directory as > Sources Root (파란색)
    webapp/     ← 웹 리소스 루트
      index.jsp ← New > File 로 생성

3. 라이브러리 설정 (pom.xml)

서블릿 코딩을 위해 pom.xml<project> 태그 안에 아래 의존성을 추가합니다.

<dependencies>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.1</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

scope=provided : Tomcat이 이 라이브러리를 제공하므로, 빌드 시에만 사용하고 WAR에는 포함하지 않는다.

4. Smart Tomcat 설정 (서버 연결)

  1. Apache Tomcat 다운로드 후 적당한 폴더에 설치
  2. IntelliJ 상단 Add Configuration[+]Smart Tomcat 선택
  3. 설정:
    • Tomcat Server: 설치된 톰캣 폴더 선택
    • Deployment Directory: src/main/webapp 폴더 선택 (절대 프로젝트 루트가 아님!)
    • Context Path: / 입력

5. 실습용 첫 서블릿 만들기

src/main/java (파란 폴더)에 클래스를 만듭니다.

@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws IOException {
        resp.setContentType("text/html;charset=UTF-8");
        resp.getWriter().println("<h1>Hello Servlet!</h1>");
    }
}

6. 실행 및 확인

  1. 상단 Run(재생 버튼) 클릭
  2. 브라우저에서 http://localhost:8080/hello 접속
  3. “Hello Servlet!” 이 보이면 성공!

💡 실습 시 기억할 루틴

상황 조치
Java 코드(Servlet/Filter) 수정 시 서버 Stop 후 Restart (재컴파일 필요)
JSP/HTML 수정 시 서버 켜둔 채로 브라우저 새로고침만 하면 반영
404 에러 발생 시 Smart Tomcat 설정의 Deployment Directory가 webapp 폴더를 정확히 가리키는지 확인