IntelliJ에서 이클립스 Maven 프로젝트 사용 방법

2024-05-29

이클립스 프로젝트 Import

프로젝트 복사

기존 이클립스 프로젝트에 영향이 가지 않게, 이클립스 프로젝트를 통째로 복사하고 이름을 변경합니다.

IntelliJ에서 이클립스 프로젝트 열기

좌측 상단 File > New > Project from Existing Sources… > 복사한 이클립스 폴더의 workscase에서 프로젝트 폴더 선택 > OK > import project from external model : Eclipse 선택 > Next > Next > Git 프로젝트 폴더 선택 > Next > Next > 좌측 상단 + > Add JDK > 이클립스 Java Build Path에서 확인한 Java 버전에 맞는 JDK를 오라클 홈페이지에서 다운받아 설치 > JDK 경로 선택 (예시 : C:\Program Files\Java\jdk-1.8) > OK > JDK 버전 선택 > Create > Import from Eclipse 경고창 OK > New Window

Load Maven Project ★

우측 하단 Maven build scripts found 팝업에서 Load Maven Project 버튼 클릭
이 버튼을 누르지 않으면 모든 설정을 직접 수동으로 해야 합니다..

IntelliJ 최신 버전에서는 이클립스 프로젝트 Import 후 모듈명이 common으로 잡힐 수 있으나, 그대로 사용하는 것이 좋습니다.

프로젝트 정상 로드 확인
좌측 상단 File > Project Structure… > Modules > 프로젝트명 > Web > Deployment Descriptors 하단 Web Module Deployment Descriptor 경로가 프로젝트경로\src\main\webapp\WEB-INF\web.xml 이면 정상입니다.

이클립스 프로젝트 톰캣 설정

톰캣 추가

우측 상단 Add Configurations > 좌측 상단 + 버튼 > Tomcat Server : Local 선택 > Application server : Configuration 클릭 > 좌측 상단 + > Tomcat Home : 프로젝트 톰캣 폴더 선택 (예시 : apache-tomcat-9.0.82) > OK > Name : 톰캣명-버전 입력 > Store as project file 체크 > HTTP Port : 프로젝트 URL 포트 입력 > Before launch : + 버튼에서 Run Maven Goal 선택 후 Command line : clean 입력 > OK > Maven clean-Build artifact-Build 순서로 배치 > Apply > OK
Maven clean 후 톰캣 실행하도록 설정해서, 이전 Maven install 및 package 빌드 영향을 받지 않습니다.

톰캣에 프로젝트 추가
우측 상단 Edit Configurations > 추가한 Tomcat 선택 > Deployment 탭 > + 버튼 > Artifacts… > 프로젝트명:war exploded 선택 > OK > 하단 Application context: / 으로 수정 > Apply > OK

톰캣 XML 설정

프로젝트 톰캣 폴더\conf 아래 server.xml, context.xml에 기존 이클립스 톰캣 설정을 복사하고 저장합니다.
DB 관련하여 server.xml에 Resource, context.xml에 ResourceLink 설정이 되어있어야 합니다.

IntelliJ 톰캣 실행

톰캣 실행 방법

우측 상단 Tomcat 오른쪽 ▶ 버튼 클릭

Lombok 어노테이션 프로세싱 활성화

lombok requires enabled annotation processing

톰캣 실행 시 우측 하단에 위와 같은 에러가 나오면, Enable annotation processing 버튼을 클릭하면 됩니다.

브랜치 이동 후 톰캣 실행 에러 해결

우측 Maven View > 상단 Reload All Maven Projects 클릭 (메이븐 업데이트) > 톰캣 재실행

IntelliJ 관련 파일 Git 제외 방법

.gitignore 파일 수정

# IntelliJ 관련 파일
.idea/*
프로젝트명.iml
.run/*

IntelliJ 관련 파일들을 git commit 시 제외하기 위해 .gitignore 파일 하단에 위와 같이 추가합니다.

이미 push 된 Git 파일 캐시 제거

git rm -r --cached .
git add .
git commit -m "git 캐시 삭제 후 .gitignore 재반영"
git push

cmd에서 프로젝트 폴더 경로로 이동 후, 위 명령어를 순차적으로 입력하면 이전에 Push 했던 파일도 정상적으로 제외됩니다.