[Spring] 스프링 프레임워크 MVC 프로젝트 생성 및 설정

Spring MVC 프로젝트 초기설정하기

MVC 프로젝트는 템플릿을 미리 만들어두고 필요할 때마다 꺼내 쓰면 좋다.

환경 : 이클립스 2019-06, Spring Tools 3 (Standalone Edition) 3.9.10.RELEASE

 

 

 

---

프로젝트 생성

 

File > New > Spring Legacy Project에서 새 프로젝트를 생성해준다.

 

 

 

 

여기서는 ex01 이라는 이름으로 만들어주었다.

Templates를 Spring MVC Project로 선택하고 Next 클릭.

 

 

빌딩이 완료되길 기다린다.

 

 

 

빌딩이 끝나고(진행바가 사라지고) 폴더구조가 이렇게 생성되어 있다면 성공.

 

 

 

 

---

자바 버전 및 서버 사용 설정

 

이번엔 설정으로 간다.

 

 

 

 

왼쪽 메뉴에서 Project Facets 선택하고 Java Version은 드롭다운 메뉴에서 1.8로 변경해주고 Apply.

 

 

 

Runtimes 탭을 누르고 사용할 서버를 체크해준 뒤 Apply and Close.

 

 

 

 

이제 pom.xml 창을 열어준다.

 

 

 

 

자바버전 1.6은 현재 자바버전 (나는 1.8로 설정했다)으로 변경,

스프링프레임웍버전은 3.1.1에서 현재 스프링프레임워크버전(나는 5.1.4로 설정) 변경하면 된다.

 

 

 

아래쪽으로 내려가서 플러그인 설정도 둘 다 현재 자바버전으로 바꿔준다.

 

 

 

 

---

라이브러리 설치

 

 

라이브러리를 다운받을 수 있는 MvnRepository 사이트로 들어가자.

https://mvnrepository.com/

 

 

 

 

Spring TestContext Framework를 클릭.

 

 

 

 

내 스프링 프레임워크 버전에 맞게 (나는 5.1.4 RELEASE) 선택해준다.

 

 

 

하단 Maven탭 안쪽을 클릭하면 자동으로 복사가 된다.

 

 

 

pom.xml에 이렇게 붙여넣어준다.

lombok도 같은 방식으로 넣어주자.

 

 

 

 

같은 방식으로 Servlet api도 2.5로 되어 있던 것을 3.1.0 버전으로 바꿔준다.

 

 

 

---

필터 넣기

 

web.xml에는 인코딩 필터를 넣어준다.

실행결과 창에서 한글이 깨지지 않도록 하는 역할이다.

 

	<!-- 실행결과 화면에서 한글 깨짐 방지하기 위해 인코딩 필터 적용 -->

	<filter>
		<filter-name>encodingFilter</filter-name>
		<filter-class>org.springframework.web.filter.CharacterEncodingFilter
		</filter-class>
		<init-param>
			<param-name>encoding</param-name>
			<param-value>UTF-8</param-value>
		</init-param>
		<init-param>
			<param-name>forceEncoding</param-name>
			<param-value>true</param-value>
		</init-param>
	</filter>
	<filter-mapping>
		<filter-name>encodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

 

 

 

 

---

ojdbc8.jar 추가

- Build Path에 추가

- Deployment Assembly에 추가

 

 

 

 

---

서버 설정

 

서버 더블클릭.

 

 

 

 

아래쪽 탭에서 Modules를 선택한다.

현재 쓰는 프로젝트가 없다면 Add Web Module...을 클릭한다.

 

 

 

 

사용할 프로젝트를 선택하고 Path를 /root로 바꿔준다음 OK.

 

 

 

 

추가된 프로젝트를 선택하고 Edit를 누른다.

 

 

 

Path를 /로 바꿔주고 OK를 누른다.

모듈창에서 변경사항을 저장(Ctrl+S)해준다.

 

 

---

컨트롤러 패키지 생성

 

이제 src/main/java에 컨트롤러 패키지를 새로 생성해줄 차례다.

 

 

 

 

내가 쓸 도메인 이름을 앞에 넣어주고 Finish.

(형식 : aaa.bbb.controller)

 

 

 

 

---

메이븐 업데이트

 

전부 잘 되었다면 현재 프로젝트를 오른클릭하고 위와 같은 경로로 들어가 메이븐 업데이트 창을 연다.

 

 

 

현재 사용할 프로젝트가 잘 선택되었는지 확인하고 OK.
우하단의 진행바가 사라질 때까지 기다린다.

 

설정 끝!

 

 

 

 

 

 

 

---

프로그램 오류 발생 시 Tip

 

Q. 프로그램 Run은 잘 되는데 여전히 프로젝트 아이콘에 빨간 X가 떠 있다면?
메이븐 업데이트를 다시 해주면 됨!

Q. 문제없이 다 잘 했는데도 Tomcat 오류 등이 뜬다면?

이클립스 종료 > m2 폴더 삭제 > 이클립스 재부팅 및 빌딩 기다리기 > 메이븐 업데이트 후 진행 기다리기

프로그램을 재실행해보자.

 

Q. 뜬금 없이 Classnotfound 등의 오류가 뜬다면?

서버 종료 > 서버 클린 > 프로젝트 클린 > 프로젝트 리프레쉬 후 프로그램을 재실행.