00. 실습환경 구축
IntelliJ Community 에디션에서 Servlet/JSP 실습 환경을 구축하는 가이드입니다.
1. 프로젝트 생성
- New Project → Maven 선택 (Empty Project보다 Maven 추천)
- 프로젝트 이름 입력 (예:
web_basic)
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 설정 (서버 연결)
- Apache Tomcat 다운로드 후 적당한 폴더에 설치
- IntelliJ 상단 Add Configuration → [+] → Smart Tomcat 선택
- 설정:
- 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. 실행 및 확인
- 상단 Run(재생 버튼) 클릭
- 브라우저에서
http://localhost:8080/hello접속 - “Hello Servlet!” 이 보이면 성공!
💡 실습 시 기억할 루틴
| 상황 | 조치 |
|---|---|
| Java 코드(Servlet/Filter) 수정 시 | 서버 Stop 후 Restart (재컴파일 필요) |
| JSP/HTML 수정 시 | 서버 켜둔 채로 브라우저 새로고침만 하면 반영 |
| 404 에러 발생 시 | Smart Tomcat 설정의 Deployment Directory가 webapp 폴더를 정확히 가리키는지 확인 |