Maven과 Tomcat으로 웹 개발 환경 구축하기(+ IntelliJ)

목차

배경

인텔리제이 환경에서 Spring Boot를 사용하지 않고, Maven 기반의 웹 프로젝트를 Tomcat을 통해서 웹 개발환경을 구축해보았다.

(해당 코드는 git hub repository 에 올려두었습니다 : https://github.com/nooblette/mvn-tomcat-webapp)

Maven과 Tomcat으로 웹 개발 환경 구축하기(+ IntelliJ)

Spring + Maven + Tomcat으로 WAS 환경 구축을 위해 내가 준비한 툴과 버전은 다음과 같다.

- IntelliJ : https://www.jetbrains.com/ko-kr/idea/download/#section=mac

- Maven (3.8.5) : https://maven.apache.org/download.cgi

- Tomcat (9.0.62) : https://tomcat.apache.org/download-90.cgi

- JDK (openjdk 11.0.14.1) : https://www.azul.com/downloads/?package=jdk

프로젝트 설정



오른쪽 상단에 New Project를 눌러준다.

Maven 기반으로 빌드할 것이므로 좌측에서 Maven을 선택해준다.

Create from archetype 체크박스를 눌러 org.apache.maven.archetypes:maven-archetype-webapp 을 선택해준뒤, Next로 다음 페이지로 넘어간다.

다음 페이지로 넘어가서 프로젝트 이름(Name)과 프로젝트 저장 경로(Location)를 설정해준다.

각자 선호에 맞게 설정하면된다. 마찬가지로 Next를 눌러서 다음 페이지로 넘어간다.

다음으로 Maven이 저장되어 있는 경로에 맞게 Maven home path를 설정해준다.

아마 인텔리제이에 기본적으로 깔려있는 버전의 Maven(아마도 3.6.1)이 설정되어있을텐데 ⬇️ 표시를 눌러서 따로 설치해둔 버전의 Maven으로 변경해준다. (인텔리제이에 기본적으로 깔린 Maven을 사용해도 무방)

만약 설치해둔 버전의 Maven이 나오지 않는다면 오른쪽 점 3개 버튼을 눌러서 저장해둔 경로를 찾아주면 된다.

(올바르게 경로를 찾았다면 위 스크린샷 처럼 하단에 (Version: 3.x.x) 라고 나올 것이다.)



Finish를 누르면 Maven 기반의 기본적인 프로젝트가 실행되면서 초기화 작업이 진행된다.

위와같이 BUILD SUCCESS 라는 메시지가 콘솔에 뜨면 정상적으로 설정이 완료된 것이다.

기본적인 프로젝트 설정은 이로써 끝이 났다.

Tomcat 연동 후 프로젝트 실행

이제 tomcat을 통해 index.jsp 파일을 통해

Hello Mavne + Tomcat Wepabb! 이라는 메시지를 출력하는 프로젝트를 실행할 것이다.

프로젝트 상단탭을 보면 Run 탭이 보일 것이다.

해당 탭을 선택한뒤, Edit Configurations을 선택한다.

그러면 위와 같은 창이 뜰텐데 여기서 + 를 눌러준다.

그 뒤 Tomcat Server -> Local 을 차례대로 선택해준다.

자동대로 설치해둔 버전에 맞는 Tomcat으로 설정되어 있을 것이다.

여기서 하단의 빨간 네모에서처럼 Warning: No artifacts marked for deployment 라는 에러가 뜬다면

우측 하단 노란 네모로 체크된 Fix 를 눌러준다.

그러면 위와같은 창으로 넘어가서 Deployment를 설정해줄 수 있는데,

둘 중에서 mvn-tomcat-webapp:war exploded 를 선택해준다.

위와 같은 창이 나온다면 제대로 설정해준 것이다.

여기서 이제 Application context 를 수정해준다.

프로젝트 실행 동작에 직접적인 영향을 주는 부분은 아니지만 위와 같이 기본 war exploded로 설정됐을 경우에는 프로젝트가 실행될때

http://localhost:8080/mvm_tomcat_webapp_war_exploded 로 들어가야 의도했던 대로 index.jsp를 볼 수 있다.

나는 간단하게 localhost:8080 으로 접속할 수 있도록 / 으로 수정해주었다.

그 뒤 Apply -> OK 를 차레대로 눌러서 Edit Configuration 창을 종료시켜준다.

하단에 Services 라는 탭이 생기고 Tomcat Server 설정이 된 것을 볼 수 있다.

이제 프로젝트를 실행 시켜보면

앞서 설정해둔 localhost:8080으로 프로젝트가 정상적으로 실행됨을 볼 수 있다.

 

참고한 곳

• https://atoz-develop.tistory.com/entry/IntelliJ-JAVA-%EC%9B%B9-%EA%B0%9C%EB%B0%9C-%ED%99%98%EA%B2%BD-%EA%B5%AC%EC%B6%95-%EB%B0%A9%EB%B2%95-Maven-Tomcat