처음 하는 스프링(Spring), 프로젝트 생성하기

처음 하는 스프링(Spring), Tomcat 연동하기에 이어서.

처음 만드는 프로젝트

이제 본격적으로 프로젝트를 시작해보도록 하겠다.

1. Spring 추가하기
지난번에 Eclipse 환경 설정을 하면서 설치했던 sts plugin을 통해 스프링 프로젝트를 손쉽게 추가할 수 있다.
Eclipse의 Perspective(쉽게 말해 View 모드)가 Spring으로 지정되어있지 않다면, 아래처럼 추가해주도록 하자.

먼저, Eclipse의 우측 상단에서 Open Perspective를 클릭하면 다음과 같이 나온다.

그중 Spring을 선택하고 OK를 눌러서 추가해주자.

Perspective 목록에 Spring이 추가되었다.

참고로 Perspective 목록 부분을 우클릭하면 Show Text 메뉴가 나오는데, 체크 해제를 해주면 깔끔하게 아이콘만 남아있게 된다.

2. 프로젝트 생성하기
이제 프로젝트를 생성하기 위해 File > New 메뉴로 가보면 Spring에 관련된 것들이 추가된 것을 확인할 수 있다.
Spring 프로젝트를 생성하는 것은 두 가지 방법이 있는데, Spring Starter Project를 통해 Spring Boot를, Spring Legacy Project를 통해 일반적인 Spring 프로젝트를 만들 수 있다.
이 중 일반적인 Spring 프로젝트를 생성할 것이다.

File > New > Spring Legacy Project를 선택하자.

다음은 프로젝트 이름과 템플릿을 선택하는 부분인데, 원하는 프로젝트 이름을 정하고 Spring MVC Project 템플릿을 선택하도록 하자.

마지막으로 프로젝트에서 사용할 패키지의 경로명을 지정해주는 부분인데, com.first.begin나 a.b.c같이 원하는 이름을 자유롭게 지정할 수 있다.
지정했다면 Finish 버튼을 눌러서 프로젝트 생성을 완료하도록 하자.

3. Tomcat에 프로젝트 추가하기
Spring 프로젝트는 바로 실행할 수 있도록 최소한의 구성이 된 채로 생성된다.
즉, 만들어진 그대로 서버에 추가하더라도 무언가 결과물이 나온다는 말이다.
그렇다면 이제 만들어진 프로젝트가 서버에서 잘 작동되는지 테스트해보도록 하자.

지난번에 만들었던 Tomcat을 우 클릭하면 다음과 같이 Add and Remove 메뉴가 나오는데, Tomcat에 프로젝트를 추가/제거할 수 있는 메뉴다.
Add and Remove를 클릭하도록 하자.

Available과 Configured 두 가지 탭이 보일 텐데, 말 그대로 추가할 수 있는 프로젝트와 이미 구성된 프로젝트 목록을 각각 보여주는 탭이다.
바로 직전에 만들어두었던 Begin 프로젝트가 Available 탭에 보인다는 것은 Tomcat에 추가할 수 있다는 의미이다.

Begin 프로젝트를 선택하고 Add 버튼을 누르거나 더블클릭하면 추가가 완료된다.
Finish 버튼을 눌러서 완료하도록 하자.

이제 실행시키고 인터넷 브라우저를 켠 다음 Tomcat의 기본 URL 경로인 localhost:8080 (혹은 변경한 포트 번호)에 접속해보자.
아마 별다른 설정 없이 바로 Tomcat을 실행시켰다면 사진처럼 404 Not Found Error가 뜰 것이다.
이는 Tomcat에 기본적으로 프로젝트 별 URL path가 지정되어있기 때문이다.

지난 포스팅에서 살펴봤던 Tomcat Overview를 다시 열어보자.
그런 다음, 왼쪽 아랫부분에 Modules 탭을 눌러보도록 하자.

Path 부분에 /begin이 설정되어 있는 것을 볼 수 있다.

위와 같이 Tomcat에 설정된 Path를 URL에 추가한 localhost:8080/begin 경로로 접속해보면, 생성된 프로젝트가 서버에서 잘 돌아가고 있는 것을 볼 수 있다.
(Encoding 설정 제대로 안 해주면 이렇게 된다)

추가적으로, URL Path를 Root 경로로 지정해주는 것이 더 깔끔하고 편할 수가 있기 때문에 없애보도록 하겠다.
다시 Overview > Modules 탭으로 가서, 변경할 모듈을 선택하고 Edit 버튼을 누르자.
그다음 Path 부분에서 'begin'을 지우고 '/(슬래시)' 하나만 남기고 OK 버튼으로 마무리하자. Ctrl + S를 눌러서 저장하고 Tomcat을 Restart 해주는 것 잊지 말자.

다 적용이 끝났다면 다시 처음의 localhost:8080 URL로 접속해보자.
이제 원하는 경로명으로 잘 접속이 될 것이다.

지금까지 프로젝트를 생성하고 서버에 추가하는 것을 알아보았다.
다음엔 Spring 프로젝트의 구조에 대해서 정리해보려고 한다.