[Spring] IntelliJ에서 Spring + Maven 프로젝트 생성하기

[Spring] IntelliJ에서 Spring + Maven 프로젝트 생성하기

---

이번 포스팅의 목표는 IntelliJ를 이용하여 Spring + Maven 프로젝트를 생성하고, 실행 가능한 상태까지 만드는 것이 목표이다. 프로젝트 구조 구성이나 여러 추가적인 작업은 이 포스팅에서 다루지 않겠다.

개발환경 셋팅

• IntelliJ 설치 페이지
• JDK 설치 및 환경변수 셋팅방법
• Tomcat 설치방법

프로젝트 생성

① IntelliJ를 실행하면 뜨는 초기화면이다. 여기서 'Create New Project'를 클릭한다.

② 보통 JDK(여기선 Java8, JDK1.8을 사용)를 설치했다면, 아래와 같이 Project SDK가 자동으로 잡혀 있다. 설치를 하지 않았다면 JDK를 먼저 설치해주자.
(하지만 여기서 중요한 것이 자동으로 잡혀있다고 해서 그대로 진행하면 안된다. 자신의 OS가 64bit라면 JDK의 경로는 64bit 폴더에 있어야 한다. 반드시 한번 더 확인하자)

③ SDK까지 지정하였다면, 프로젝트를 생성하는 부분이다. 여기서 두 가지 방법이 있다.
1) Maven 프로젝트를 만들고, Spring을 곁들이는 방법
2) Spring 프로젝트를 만들고, Maven을 적용하는 방법

여기서는 1번 방법을 쓰도록 하겠다. 그 이유는 디렉터리 구조가 달라지기 때문에 1번이 더 편하다고 함..
(여기서 'Create from archetype'은 해제한다.)

④ GroupId와 ArtifactId를 입력해준다.
1) GroupId

• groupId는 당신의 프로젝트를 모든 프로젝트 사이에서 고유하게 식별하게 해 주는 것이다.
• 따라서, groupId에는 네이밍 스키마를 적용하도록 한다.
  • groupId는 package 명명 규칙을 따르도록 한다.
  • 즉, 최소한 당신이 컨트롤하는 도메인 네임이어야 한다.
  • 하위 그룹은 얼마든지 추가할 수 있다.
  • 예: org.apache.maven, org.apache.commons

2) ArtifactId

• artifactId는 버전 정보를 생략한 jar 파일의 이름이다.
  • 이름은 원하는 것으로 아무거나 정해도 괜찮다.
  • 단, 소문자로만 작성하도록 한다.
  • 단, 특수문자는 사용하지 않는다.
• 만약 써드 파티 jar 파일이라면, 할당된 이름을 사용해야 한다.
  • 예: maven, commons-math

⑤ Project name(프로젝트 이름)과 Project location(프로젝트 경로)를 지정해준다.
(기본적으로 Project name은 artifactId와 같게 지정되어 있다.)

⑥ Finish를 누르면 아래와 같은 프로젝트 구조가 생성된다. 여기서부터는 본인 스타일에 맞게 프로젝트 구조를 구성하면 된다.

Maven 프로젝트에 Spring 적용

이제 생성된 Maven 프로젝트 구조에 Spring을 적용해보자.

① 먼저 프로젝트 폴더를 우클릭하면 여러 메뉴가 뜨는데, 'Add Framework Support...'를 클릭한다.

② 아래와 같이 여러 Framework 리스트들이 뜰 것이다. 여기서 우리는 Spring을 적용할 것이므로 'Spring MVC'를 체크해주고, OK 버튼을 눌러서 다음으로 넘어간다.

③ Spring MVC를 적용하기 전 프로젝트 구조와 달리, 몇 개의 폴더가 생겼다. 각 폴더에 대해서는 이후에(언젠가..) 하게 될 포스팅에서 다루겠다. (당연히, spring 관련 설정이 포함된 폴더이다.)

④ 이제 Maven + Spring 프로젝트가 생성되었지만, 여기서 한가지를 더 해줘야하는 것이 있다. 그것은 바로 라이브러리를 추가해주는 일이다.

File → Project Structure → Artifacts에 가면, 아래와 같이 Spring 관련 라이브러리가 두 개 있을 것이다. WEB-INF 폴더 하위에 lib 폴더를 생성 후, 더블 클릭으로 라이브러리를 추가해주자.

(라이브러리 추가 후 모습)

Tomcat 설정

① IntelliJ 우측 상단에 보면 'Add Configuration...'이라는 버튼이 있을 것이다. 실행 버튼(삼각형 모양)은 Disable 되어있을 것이고... 왜냐하면 Server 설정을 해주지 않았기 때문이다. 그래서 우리는 'Add Configuration...' 버튼을 눌러서 Server를 지정해주자.

② 버튼을 누르면 아래와 같은 창이 뜰 것이다. 그리고 좌측 상단의 +버튼을 누르고 Tomcat Server - Local을 클릭해주자.

③ 그럼 또 아래와 같은 창이 뜰 것이다. 밑에 보면 Error가 떠 있다. Server가 지정되지 않았다는 뜻이다. 그래서 우리는 'Configure...' 버튼을 눌러서 서버를 지정해 줄 것이다.

④ 위의 개발환경 셋팅 부분에서 Tomcat 설치방법을 봤을지 모르겠지만, 이것을 보고 Tomcat을 설치했다면 본인이 설치한 경로가 있을 것이다.
Tomcat을 설치한 폴더 경로까지만 찾아서 지정해준다.

⑤ Tomcat 설치 폴더까지 지정해주면 거의 끝났다. 아래는 Server에 대한 이름과 Server를 실행할 Port를 지정해주는 모습이다. 기본적으로 Server Name은 'unnamed', HTTP port는 '8080'으로 되어 있을 것이다. 하지만, 나 같은 경우에는 기존에 Front end 개발(Vue.js)을 했었기 때문에 Vue에서 사용하는 Port가 '8080'이기 때문에, Tomcat Server Port는 '8081'로 수정했다.

이제 IntelliJ에서 초록색 삼각형 모양의 실행버튼을 눌러서 실행해보자.