도도의 초록누리

[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] 1. 간단한 소개, STS 4 설치와 실행

오랜만에 글을 작성한다.

스프링 프레임워크에 대해서 간단하게 소개하려고 한다.

Java 기반으로 만든 프레임워크라고 이해하면 되겠다.

과거의 전자정부 프레임워크의 기반이 되는 원래 프레임워크는 Spring Framework Project라고 보면 되겠다.

기본적인 셋팅은 간단하다고 보면 된다.

주로 어디에 사용되는 프레임워크냐면, 국내에서는 웹 개발 프로젝트에 많이 사용되는 것으로 알려져 있다.

물론 순수하게 jsp model1기반으로 작성된 웹 페이지도 있다.

[1. Spring Framework 사이트에서 프로젝트 내려받기]

https://spring.io/tools

그림 1. Spring Tools 4 for Eclipse 사이트(2020-09-15)

Projects에서 Development Tools의 Spring Tools 4를 클릭한다.

그림 2. Spring Tools 4 for Eclipse 사이트(2020-09-15)

버전은 크게 리눅스(Linux 64-BIT), MACOS 64-BIT, 윈도우 64비트(Windows 64bit) 버전으로 3가지로 구성된다.

운영체제에 맞는 걸로 내려받으면 된다.

2. 압축 풀기

spring-tool-suite-4-4.7.2.RELEASE-e4.16.0-win32.win32.x86_64.self-extracting.zip을 압축풀면 내부 폴더에 contents.zip이라는 파일이 있다.

이 파일도 압축을 풀어준다.

그림 3. 프로그램 설치 완료

이렇게 되어있으면 설치는 완료된 것이라고 보면 되겠다.

4. 프로그램 실행

Spring Tools Suites는 SpringToolSuite4.exe 파일을 실행시키면 된다.

그림 4. SpringToolSuite4 - 위치 찾기

IDE 사용자체를 놓고 본다면, Eclipse 기반이므로 친숙하게 적응할 수 있다.
(MVC패턴, 프레임워크 사용방법 등 생략하고 IDE만 놓고 보면)

그림 5. SpringToolSuites 4-4.7.2 (2020-09-15)

5. MarketPlace의 STS 검색 후 Add-On 설치하기

Spring Tools 3 Add-On for Spring Tools 4 3.9.14.CI를 찾으면 된다. (Legacy Project 등 이전 버전의 부가기능을 사용하고자 할 때)

그림 6. Eclipse Marketplaces의 모습(2020-09-15)

그림 7. Install 모습

Confirm을 눌러서 다음 과정을 진행한다.

그림 8. 라이선스에 관한 것

오픈소스 라이선스에 관한 것이다. I accept the terms of the.....을 체크하고 Finish를 누른다.

그림 9. 설치중 모습(2020-09-15)

기다리면 된다.

그림 10. Restart Now 누르기 전 모습 - Eclipse(STS)

Restart Now를 누르면 STS 프로그램이 다시 시작된다.

6. Spring Project -> 새 프로젝트 확인해보기

이전 "STS3"버전에서 사용했던 부가 기능이 존재하는지 확인할 수 있다.

그림 11. File -> New -> Project 모습

File -> New -> Other를 클릭한다.

그림 12. Spring 프로젝트 내에 이전의 부가 기능

STS3 하위 버전을 설치하지 않아도 부가 기능 추가로 다시 활용할 수도 있다.