IntelliJ JAVA 웹 개발 환경 구축 방법 (+ Maven, Tomcat)

IntelliJ JAVA 웹 개발 환경 구축 방법 (+ Maven, Tomcat)

이전에 작성했던 [JAVA 웹 개발환경] IntelliJ + Tomcat 연동 방법 글을 생각보다 많은 분들이 봐주셔서 이번 글에서 내용을 보강하려고 합니다. IntelliJ로 JAVA 웹 개발 환경을 구축해서 Maven 기반의 웹 프로젝트를 생성하고 실행하는 방법까지 다루어보도록 하겠습니다.

 

준비해야 할 것들

JAVA로 웹 애플리케이션을 개발하기 위해 필요한 것들은 일반적으로 다음과 같습니다.

참고 삼아 항목 별로 다운로드 받을 수 있는 페이지의 링크를 달아두었습니다. 새 창으로 열립니다.

 

• IntelliJ IDEA 🔗
• JDK 🔗
• Maven 🔗  (또는 다른 빌드 툴)
• Tomcat 🔗 (또는 다른 서블릿 컨테이너)

본 글에서는 IntelliJ IDEA를 기반으로 한 개발 환경 구축 방법을 다룰 것입니다. (참고로 JAVA IDE로는 Eclipse, IntelliJ IDEA, Net Beans와 같은 것들이 있습니다.)

따라서 IDE는 IntelliJ를 준비하시면 되는데요, IntelliJ는 무료로 제공되는 Community 버전과 유료인 Ultimate 버전이 있습니다.

웹 애플리케이션을 개발하기 위해서는 관련 기능을 제공하는 Ultimate 버전을 사용하는게 좋습니다.

교육 라이센스로 Ultimate 버전을 대략 1년정도 무료로 사용할 수 있으니 당장 구매할 생각이 없거나 구매가 불가능한 분들은 이 방법으로 준비해주시면 되겠습니다. 교육 라이센스를 받는 방법은 이 글(IntelliJ IDEA - 무료로 사용할 수 있는 교육 라이센스 받는 방법)을 참고해주세요.

 

이 글에서 다운로드 방법, 설치 방법을 자세히 다루지는 않겠습니다. IntelliJ에 세팅하는 방법을 중점적으로 다룰것입니다.

혹시나 향후 작성한다면 추가로 링크 걸어두겠습니다.

간단히 말씀드리자면 윈도우 사용자 분들은 위에 걸어둔 다운로드 링크에서 받아서 설치하시면 되고 맥OS 사용자 분들은 homebrew 패키지 관리자를 통해 설치하시면 되겠습니다.

 

IntelliJ, JDK, Maven, Tomcat을 다운로드 받고 설치를 마치셨으면 이제 하나씩 개발 환경을 구축해 봅시다.

참고로 제가 사용하는 버전은 IntelliJ Ultimate 2019, JDK11, Maven 3.6.3, Tomcat 9 입니다.

 

IntelliJ JDK 설정

먼저 IntelliJ를 실행합니다.

IntelliJ Weblcom Page

 

우측 하단의 Configure를 클릭하고 Structure for New Projects를 클릭합니다.

 

상단의 [+] 버튼을 클릭하면 우측에 JDK의 이름과 home path를 설정하는 창이 보여집니다.

Name에 JDK 이름을 입력하고 JDK home path에 설치한 JDK의 디렉토리를 설정합니다.

JDK 이름은 자신이 알아보기 편한 걸로 입력하면 됩니다.

 

다 입력했으면 [OK]를 클릭해서 JDK 설정을 마칩니다.

 

 

IntelliJ Maven 설정

IntelliJ에는 Maven이 내장되어있기 때문에 따로 설정하지 않아도 Maven 기반의 프로젝트를 생성하고 빌드할 수 있습니다.

내장된 버전과 다른 버전을 사용해야 할 경우 다음과 같이 설정하면 됩니다.

 

IntelliJ 초기 화면(Welcom Page)에서 이번에는 Preferences(윈도우의 경우 Settings)를 클릭합니다.

 

좌측 메뉴에서 Build, Execution, Deployment - Build Tools - Maven을 클릭합니다.

Maven home directory에 보시면 이미 IntelliJ 내장 Maven이 설정돼있는게 보이시죠?

IntelliJ IDEA 2019.3.4 버전에는 Maven 3.6.1 버전이 내장되어 있습니다.

 

이를 OS에 설치한 버전으로 바꾸려면 Bundled (Maven 3) 우측의 드롭다운 버튼을 클릭합니다.

 

그러면 이와 같이 IntelliJ에서 자동으로 Maven 디렉토리를 인식해서 선택 항목에 뜹니다.

해당 버전을 선택합니다.

OS 환경 변수 기반으로 인식되는 것이기 때문에 자동으로 뜨지 않는다면 우측 [...] 버튼을 클릭해서 path를 직접 지정해주면 됩니다.

 

직접 설치한 Maven 3.6.3 디렉토리로 변경하자 아래에 Version이 3.6.3으로 바뀌었습니다.

이렇게 Maven 설정이 완료되었습니다.

[Apply]를 클릭하여 저장합니다.

Preferences(Settings)에서 톰캣 설정도 해줄 것이기 때문에 창을 닫지 말고 다음 스텝으로 이동합시다.

 

 

IntelliJ Tomcat 설정

이번엔 좌측 메뉴에서 Build, Execution, Deployment - Application Servers 클릭하고 [+] 버튼을 클릭합니다.

 

Tomcat Server를 선택합니다.

 

Tomcat Home에 설치한 톰캣 디렉토리를 지정합니다.

정상적으로 지정하고 나면 아래에 Tomcat Version: 9.0.33과 같이 버전이 감지되서 출력됩니다.

[OK]를 클릭합니다.

 

톰캣 설정이 완료되었습니다.

이제 Preferences(Settings)에서 할 세팅은 모두 끝났으니 [OK]를 클릭해서 저장하고 닫습니다.

 

 

첫 번째 웹 프로젝트 만들기

Maven 기반의 프로젝트로 웹 프로젝트를 만들도록 하겠습니다.

혹시 빌드 툴 없이 웹 프로젝트를 세팅하는 방법을 보시려면 이전 글을 참고해주시면 되겠습니다.

 

IntelliJ 첫 화면에서 Create New Project를 클릭합니다.

 

좌측에서 Maven을 선택하고 상단에 Create from archetype에 체크합니다.

Apache(Maven)에서 제공하는 프로젝트 템플릿을 이용해서 프로젝트를 만드는 옵션입니다.

목록에서 org.apache.maven.archetypes:maven-archetype-webapp을 선택하고 Next를 클릭합니다.

 

Name, ArtifactId에는 프로젝트 이름을 입력합니다.

Location에는 프로젝트 위치를 지정합니다.

GroupId에는 패키지 이름과 비슷하게 개인, 단체, 기업의 도메인을 거꾸로 입력하시면 됩니다.

다 입력하셨으면 Next를 클릭합니다.

 

사용할 Maven을 선택하고 Finish를 클릭합니다.

 

Maven webapp 프로젝트 초기 화면

Maven 기반의 프로젝트를 생성하면 프로젝트 초기화 작업이 진행됩니다.

완료되면 콘솔에 BUILD SUCCESS가 출력됩니다.

archetype을 사용해서 만들었으므로 pom.xml 파일이 변경되는데 그에 따라 우측 하단에 Maven projects need to be imported 메시지가 뜹니다.

선택할 수 있는 옵션으로 Import Changes와 Enable Auto-Import가 주어지는데 보통 Enable Auto-Import를 선택해서 사용합니다.

pom.xml이 변경되면 자동으로 감지해서 적용하도록 하는 옵션입니다.

Import Changes를 선택하면 pom.xml을 변경할 때마다 수동으로 불러오도록 해야합니다. (굉장히 귀찮습니다. 😵)

 

Enable Auto-Import를 선택하고 나면 잠시 후 이전에 pom.xml에 설정돼있던 의존성이 없어서 발생했던 오류 표시가 사라지는 것을 볼 수 있습니다.

 

JAVA 웹 애플리케이션을 개발한다는 것은 Servlet/JSP 프로그래밍을 하는 것입니다.

따라서 Servlet API 의존성을 추가해야 합니다.

pom.xml의 <dependencies> 안에 다음 항목을 추가합니다.

 

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

여기서 <version> 항목은 톰캣 버전 별 서블릿 스펙이 다르므로 사용하는 톰캣 버전에 맞춰서 설정해야 합니다.

저는 톰캣 9를 사용하고 톰캣 9는 서블릿 4.0을 지원하기 때문에 위와 같이 설정했습니다.

다른 버전은 다음 표의 Servlet Spec 항목과 Apache Tomcat Version 항목을 참고하시면 됩니다.

 

표 - Tomcat Spec

 

웹 프로젝트에 톰캣 연동하고 실행하기

간단히 Servlet과 JSP를 하나씩 만들어서 실행해보도록 하겠습니다.

 

프로젝트를 만들때 기본적으로 생성된 index.jsp 파일이 있습니다.

우측과 같이 Hello JSP! 를 출력하도록 편집해주었습니다.

 

이 프로젝트에 톰캣 실행 환경을 설정해주기 위해 우측 상단의 Add Configuration...을 클릭합니다.

 

좌측 상단에 [+] 버튼을 클릭하고 Tomcat Server - Local을 클릭합니다.

 

그러면 이렇게, 아까 Preferences에 설정한 톰캣을 기반으로 자동으로 입력됩니다.

그림을 보시면 Application Server에 Tomcat 9.0.33이 자동으로 설정되어 있는게 보이시죠?

IntelliJ에 설정되어 있는 톰캣이 여러 개일 경우 이 곳의 드롭다운 버튼을 클릭해서 변경할 수 있습니다.

그 아래 크롬 아이콘은 애플리케이션 실행 시 기본으로 사용할 브라우저입니다.

원하는 브라우저로 변경할 수 있습니다.

URL, VM options, HTTP port 등을 변경하거나 설정할 수 있습니다.

지금은 따로 변경할 것은 없고, 하단에 보면 🚨Warning: No artifacts marked for deployment 메시지가 보입니다.

이 톰캣에 deploy할 웹 애플리케이션이 설정돼있지 않다는 뜻입니다.

우측의 Fix 버튼을 클릭합니다.

 

 

그러면 위와 같이 :war와 :war exploded 두 가지 선택 메뉴가 뜹니다.

:war는 first-web-app을 war로 말아서 이 톰캣에 배포하는 것이고 :war exploded는 풀어서 배포하는 것입니다.

:war exploded를 선택합니다.

 

선택한 옵션으로 artifact가 배포 설정 되었습니다.

하단 Application context에 자동으로 /first_web_app_war_exploded라고 입력됩니다.

이러면 http://localhost:8080/first_web_app_war_exploded로 접근해야 하는데 너무 길어서 귀찮으므로 /first_web_app으로 변경하도록 하겠습니다.

 

Application context에 /first_web_app 또는 원하는 context 명을 입력하고 [OK]를 클릭합니다.

 

하단에 Services 창에 새로 생겼습니다.

이제 Tomcat 연동이 완료됐습니다.

우측 상단의 Run 아이콘을 클릭해서 프로젝트를 실행합니다.

Run을 실행하면 자동으로 build가 진행됩니다.

 

실행 결과

톰캣 실행 환경 설정 시 Open browser - After launch에 체크하면 실행 시 브라우저가 자동으로 실행됩니다.

해당 옵션을 사용하지 않았을 경우 브라우저에 http://localhost:8080/first-web-app과 같이 입력해서 결과를 확인해봅시다.

 

[참고] 톰캣 서버 로그의 한글이 깨질 경우

아마 OS의 언어 설정이 한국어이면 톰캣 실행 시 출력되는 로그의 한글이 깨질것입니다.

톰캣 로그가 영어로 출력되도록 설정하던지, 인코딩을 UTF-8로 설정하는 방법으로 해결할 수 있습니다.

글이 너무 길어져서 이곳에 따로 써두었습니다.