도도의 초록누리

[Spring-Framework] 4. Eclipse와 Maven MVC 웹 프로젝트 - 생성하기

이번에 소개할 글은 Apache Maven 프로젝트(이하 "메이븐" 또는 "Maven")을 활용하여 Maven 기반의 MVC 프로젝트를 생성하도록 하겠다.

Spring-Framework를 이해하기 전에 경험해보면 도움이 될 것이라고 생각한다.

1. 프로젝트 생성하기

프로젝트 생성부터 간단하면서도 알기 쉽게 작성하였다.

그림 1. Project 생성하기

File에서 New->Project...을 클릭한다.

그림 2. Project 생성하기

Use Default Workspace location을 체크한 후 Next를 누른다.

그림 3. Project 생성하기

해당 카탈로그를 선택한 후 Next를 누른다.

그림 4. Project 생성하기

아래 그림 3처럼 여러가지 값을 적는 창이 나타난다.

Group Id는 프로젝트를 진행하는 회사나 팀의 도메인 이름을 거꾸로 적는다.

Artifact Id는 해당 프로젝트의 이름을 적는다.

package는 위 두가지가 조합된 이름으로 나온다.

작성을 완료하였으면, Finish를 누른다.

그림 5. Project 생성하기

프로젝트 생성이 된 것을 확인할 수 있다.

Problems 창에 보면, Servlet 오류가 있는 것을 확인할 수 있다.

정상적으로 프로젝트가 생성된 것이다.

2. Maven 프로젝트에서의 Servlet-api.jar 파일에 대한 것(pom.xml 이해)

maven을 사용하면, 귀찮게 servlet-api.jar 파일을 따로 복사, 붙여넣기를 할 필요가 없다.

그림 6. 이전 스타일 - Maven 프로젝트를 사용하지 않은 경우

Apache Maven 프로젝트는 POM.xml 기반으로 동작한다.

따로 servlet-api.jar를 이전의 "WebContents\Web-inf\lib에 복사, 붙여넣기"를 안 해도 된다.

3. Maven 프로젝트에서의 Servlet-api.jar 파일에 대한 것(pom.xml 구현)

pom.xml 파일을 편집하여 servlet-api.jar를 자동으로 생성하는 방법에 대해서 소개하겠다.

그림 7. pom.xml - eclipse

pom.xml을 더블클릭한다.

<dependencies>~</dependencies> 내에는 <dependency>가 정의되어 있는 것을 살펴볼 수 있다.
(글로만 보면, 조금 어려우니 그림을 가지고 소개함.)

</dependency> 뒤에 위의 내용을 입력해준다.

그림 8. pom.xml - eclipse

pom.xml에 명령어를 입력함으로서 잠시 기다리면, javax-servlet-api-3.1.0.jar 파일이 자동으로 생성되는 것을 확인할 수 있다.

그리고 Problems 내에 발생했던 javax.servlet Error도 함께 사라지는 것을 확인할 수 있다.

4. Maven 프로젝트 - Hello World 실행하기

Maven 프로젝트를 Apache Tomcat 9으로 실행하도록 하겠다.

그림 9. Apache Tomcat 9으로 개발환경에서 모의 태스트 하기

"Run As..."를 누른다.

그림 10. Apache Tomcat 9으로 개발환경에서 모의 태스트 하기

Run on Server를 선택한 후 OK를 누른다.

그림 11. Apache Tomcat 9으로 개발환경에서 모의 태스트 하기

Tomcat 서버 셋팅을 한 후 Finish를 누른다.

그림 12. Apache Tomcat 9으로 개발환경에서 모의 태스트 하기

Finish를 누른다.

그림 13. Apache Tomcat 9으로 개발환경에서 모의 태스트 하기

Maven 기반으로 완성된 홈페이지를 살펴볼 수 있다.

5. Maven Project의 pom.xml 설정이 만능인가?

앞서 servlet-api.jar에 대해서 간단한 설정으로 자동생성이 된다고 소개하였다.

pom.xml 설정으로 모든 것을 다 처리할 수 있을 정도인지 언급해보려고 한다.

결론은 아니다.

그림 14. pom.xml 설정에서의 오류

pom.xml 설정을 하였는데, 운이 안 좋으면 jar파일을 못 찾을 수도 있다.

물론 36줄~40줄의 내용이 완벽한 것은 절대 아니다.

6. Maven Project의 pom.xml 설정에 대한 정보찾기 

그림 14에서의 잘못된 pom.xml 설정의 문제에 대해서 잠깐 소개하였다.

구체적으로 Maven Project에서 지원하는 Repository가 무엇인지, 버전은 어떻게 되는지 각종 정보에 대해서 알 수 있는 사이트를 소개하겠다.

https://mvnrepository.com/

그림 15. mvnpepository.com (2020-09-19)

그림 15 사이트에 접속해서 검색해서 사용하고자 하는 버전, pom에서 지원하는지 등을 쉽게 살펴볼 수 있다.

그림 16. mvnrepository.com의 mysql 검색 결과 (2020-09-19)

MySQL Connector/J를 클릭한다.

그림 17. mvnrepository.com의 mysql 세부 결과 (2020-09-19)

세부적으로 지원하는 버전에 대해서 소개하고 있다.

그림 18. 버전을 클릭하여 pom에서 사용하는 코드 생성

Maven에 적용할 수 있는 코드가 출력되는 것을 확인할 수 있다.

그림 14의 오류 문제가 해결되는지 한번 적용해보겠다.

그림 19. 이상없이 적용된 mysql-connecotr-java-8.xx버전 - Maven MVC

정상적으로 동작하는 모습을 살펴볼 수 있다.

7. 결론(Conclusion)

pom.xml을 제대로 적용해주면, 많은 문제를 쉽고 간단하게 해결할 수 있다고 본다.

Maven MVC 웹 프로젝트 입문에 대해서 소개하였다.

JSP/Servlet을 경험한 사용자들을 위한 글을 한번 추가로 연재해보겠다.

* 참고 자료(References)

1. Maven Repository: mysql » mysql-connector-java » 8.0.21, https://mvnrepository.com/artifact/mysql/mysql-connector-java/8.0.21, Accessed by 2020-09-20, Last Modified 2020-07-12.

2. Spring MVC Example for User Registration and Login - DZone Web Dev, https://dzone.com/articles/spring-mvc-example-for-user-registration-and-login-1, Accessed by 2020-09-20, Last Modified 2017-03-05.

3. Maven Repository: Search/Browse/Explore, https://mvnrepository.com/ , Accessed by 2020-09-20, Last Modified 2020-09-20.

[Spring-Framework] 3. Eclipse와 Apache Maven 프로젝트 - 구축하기(1)

Spring-Framework의 배경이 되는 Maven(이하 "Apache Maven") 프로젝트에 대해서 소개하려고 한다.

수동으로 콘솔 환경 등의 명령어로 Maven 개발환경을 구축하는 방법부터 시작해서 Eclipse 내장기능으로 사용하는 방법에 대해서 소개하겠다.

[Maven 개발방법]

1. 콘솔 등으로 수작업 개발 및 코딩
   (1, 2항목을 잘 읽어보면 도움이 될 것으로 보인다.)

2. Eclipse IDE 등을 활용한 Maven 개발환경 구축

1. Apache Maven Project

Apache Maven Project 사이트에 들어가면, Maven 프로젝트에 대해서 소개 및 자세한 내용을 살펴볼 수가 있다.

URL: https://maven.apache.org/

그림 1. Apache Maven Project

그림 2. Apache Maven - Download

그림 2의 사이트에서 apache-maven-3.6.3.bin.zip을 내려받아서 수동으로 설치할 수 있다.

2. Maven 개발환경 - 설치하기

내려받은 apache-maven-3.6.3-bin을 압축푼다.

그림 3. apache-maven-3.6.3-bin 압축 풀기

apache-maven-3.6.3-bin.zip을 압축 푼다.

그러면, 폴더 하나가 생성되는 것을 확인할 수 있다.

그림 4. apache-maven-3.6.3

3. Maven 개발환경 - 시스템 환경설정

방금 전에 압축 푼 폴더를 바탕으로 Maven 개발환경을 셋팅할 것이다.

그림 5. apache-maven-3.6.3 - 시스템 환경 변수(N)

"시스템 -> 오른쪽 버튼 -> 속성"을 누른다.

"고급 시스템 설정 -> 고급 탭 -> 환경 변수(N)"을 클릭한다.

그림 6. apache-maven-3.6.3 - 시스템 환경 변수(N)

시스템 변수(S)에서 "Path" 변수를 찾아서 클릭한다.

"편집(I)"을 누른다.

그림 7. apache-maven-3.6.3 - 시스템 환경 변수(N)

맨 아래 항목에 아까 메모해둔 경로를 입력해준다. ("복사", "붙여넣기"를 권장함.)

4. Maven 개발환경 - 명령 프롬프트로 구축환경 확인하기

앞에 단계를 잘 했다면, 확인해야 할 것이다.

아래의 과정을 잘 따라하도록 하자.

그림 8. 명령 프롬프트 - 관리자 권한으로 실행하기

시작 메뉴에 cmd라고 입력 후 "관리자 권한으로 실행"을 클릭한다.

그림 9. 명령 프롬프트 - 관리자 권한으로 실행하기

이라고 명령어를 입력하면, 그림 9의 출력화면을 볼 수 있다.

5. Maven - Repository 경로 변경

그림 10. 폴더 만들기

임의의 폴더명 "repository"라는 폴더를 만들어본다.

그림 11. 환경설정 변경하기(1) - 변경 전

약 53줄에 있는 <localRepository>~</localRepository>를 복사해서 (빈 줄) 55줄 정도에 붙여넣는다.

[주석이 없는 빈줄에 넣어주기]

그림 12. 환경설정 변경하기(1) - 변경 후

입력을 완료하였다면, 저장을 누른다.

6. 응용 - Eclipse 프로젝트에 수동 설치한 Apache Maven 적용하기

최근 eclipse는 기본적으로 Apache Maven을 내장하고 있다.

하지만, 굳이 수동으로 설치한 Maven을 사용하고 싶다면, 다음처럼 사용할 수도 있다.

그림 13. Preferences 설정하기

"Window->Preferences"를 클릭한다.

그림 14. Preferences 셋팅하기

Maven 탭에서 Installations을 클릭한다.

그리고 "Add..." 버튼을 클릭한다.

그림 15. Preferences 셋팅하기

Directory 버튼을 누른다.

그림 16. Preferences 셋팅하기

apache-maven-3.6.3의 설치 경로를 선택한 후 "폴더 선택"을 누른다.

그림 17. Preferences 셋팅하기

설정을 확인한 후 "Finish"를 누른다.

그림 18. Preferences 셋팅하기

"apache-maven-3.6.3"을 체크한다.

그리고 "Apply"를 누르면 적용이 완료된다.

그림 19. Preferences 셋팅하기

사용자 환경설정에 관한 것이다.

Maven 탭에서 User Settings를 클릭한다.

그림 20. Preferences 셋팅하기

앞서 환경설정을 변경한 경로를 찾아서 선택한 후 "settings"를 열기한다.

(비고: Apache-maven-3.6.3\conf폴더 내에 settings.xml 파일이 존재함)

그림 21. Preferences 셋팅하기

그림 21처럼 변경한 후 "Apply"를 누르면 적용이 완료된다.

7. 맺음글(Conclusion)

Apache Maven 프로젝트를 설치하는 방법과 개발 환경 구축이라는 주제를 소개하였다.

* 참고 자료(Reference)

1. Maven - Welcome to Apache Maven, https://maven.apache.org/, Accessed by 2020-09-19, Last Modified 2020-09-10