도도의 초록누리

[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.