[Spring]프로젝트 환경설정

🗨️ Backend/Java

[Spring]프로젝트 환경설정

Kyle99 2022. 10. 17. 19:46

프로젝트 생성

Spring을 사용하기 위해서는 기본적으로 Java를 사용한다.

그렇기 때문에, Java를 기본적으로 설치할 수 있어야 한다.

인프런의 Spring입문강의는 기본적으로 Java 11 버전을 사용하기 때문에 11 버전을 설치하는 게 좋다.

IDE(통합 개발 환경)는 IntelliJ 또는 Eclipse를 설치하면 된다.

이렇게 준비가 되었다면 프로젝트를 생성하면 된다.

옛날 같은 경우에는 Spring프로젝트를 밑바닥부터 만들었던 반면에,

요즘에는 스프링 부트를 사용해 쉽게 생성이 가능하다.

* 스프링 부트 스타터 사이트로 이동해서 스프링 프로젝트 생성 *

https://start.spring.io

위 사진은 스프링 부트 스타터 사이트의 페이지 사진이다.

제일 처음에 Project안의 Maven과 Gradle은 필요한 라이브러리를 가지고 오고

빌드하는 라이프사이클까지 관리를 해주는 툴이다.

과거에는 Maven을 많이 사용했지만 현재는 Greadle을 사용하는 추세이다.

Language 같은 경우에는 Java를 확인하면 된다.

Spring Boot는 버전 옆에 SNAPSHOT은 아직 만들고 있는 버전이고,

M5는 아직 정식 릴리즈 된 버전이 아니다.

그러므로 버전만 표시된 버전 중 가장 높은 버전을 사용하면 된다.

Project Metadata의 Group은 보통에는 기업명을 적는다. 지금은 Spring공부를 위한 것이니 hello를 기재한다.

Artifact는 프로젝트명 같은 것이다. hello-spring을 기재한다.

Dependencies는 지금 스프링 부트를 기반으로 프로젝트를 시작할 때 어떤 라이브러리를 사용할 것인지 결정하는 부분이다.

web 프로젝트를 만들 것이니 spring web과 html을 만들어주는 템플릿 엔진이 필요하니 thymeleaf를 선택한다.

그리고 GENERATE를 누르면 다운로드를 하게 된다. 다운로드가 끝나면 압축을 해제하고

IntelliJ에서 hello-spring> build.gradle을 open 하면 된다.

그러면 프로젝트가 화면에 뜨는 걸 확인할 수 있다.

처음 프로젝트를 열게 되면 외부에서 라이브러리를 다운로드하기 때문에 다운로드가 진행이 된다.

src폴더를 확인하면 main과 test가 있다. 요즘 개발 트렌드에서는 test code가 매우 중요하다.

그리고, build.gradle을 확인하면 다음과 같다.

plugins {
	id 'org.springframework.boot' version '2.7.4' → 스프링 부트 버전
	id 'io.spring.dependency-management' version '1.0.14.RELEASE'
	id 'java'
}

group = 'hello' → Group 명
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '11' → Java 버전

repositories {
	mavenCentral()
}

dependencies {
	implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
	implementation 'org.springframework.boot:spring-boot-starter-web'
	testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
	useJUnitPlatform()

build.gradle의 dependencies를 확인하면 스프링 부트에서 선택한 라이브러리들이 있는 걸 확인할 수 있다.

이때, 어디서 다운로드할지 정하는 것이 repositories의 mavenCentral()이다.

필요하다면 특정 사이트의 url을 기재할 수도 있다.

이제 main의 HelloSpringApplication의 main 메서드를 실행해보면 Spring이라는 글자가 크게 콘솔에 출력이 되며,

Tomcat이 실행되는 것을 확인할 수 있다. 그리고 localhost:8080을 도메인에 입력을 하면 Error page가 뜬다.

Error페이지가 뜬다면 정상적으로 실행이 되고 있다는 것이다.

또한, 실행을 할 때 빠르게 실행이 되게 하기 위해서는 File> Settings에서 gradle을 검색하여 Build and run에서

Gradle로 되어있는 것을 IntelliJ로 변경해주면 된다.

이렇게 설정을 해주면 Run 했을 때 Gradle을 통하지 않고, 바로 IntelliJ로 출력을 하기 때문에 더 빠르게 실행이 된다.

라이브러리 살펴보기

External Libraries를 확인해보면 나는 thymeleaf와 spring web 라이브러리 2개를 가져왔지만,

수많은 라이브러리가 설치되있는것을 확인할 수 있다.

이것은 라이브러리는 기본적으로 의존관계이기 때문이다.

spring web 라이브러리를 사용하기 위해서는

spring web 라이브러리에서 사용하는 라이브러리들을 모두 다 가져오게 된다.

이러한 의존관계는 IntelliJ의 맨 오른쪽 Gradle에서 확인이 가능하다.

이렇게 예전에는 Tomcat서버를 직접 설치하고 할 필요 없이, 라이브러리를 하나만 설치해도 모든게 설치가 가능하다.

Gradle은 의존관계가 있는 라이브러리를 함께 다운로드 한다.

스프링 부트 라이브러리

→ spring-boot-starter-web
→ spring-boot-starter-tomcat: 톰캣 (웹서버)
→ spring-webmvc: 스프링 웹 MVC
→ spring-boot-starter-thymeleaf: 타임리프 템플릿 엔진(View)
→ spring-boot-starter(공통): 스프링 부트 + 스프링 코어 + 로깅
→ spring-boot
→ spring-core
→ spring-boot-starter-logging
→ logback, slf4j

테스트 라이브러리

→ spring-boot-starter-test
→ junit: 테스트 프레임워크
→ mockito: 목 라이브러리
→ assertj: 테스트 코드를 좀 더 편하게 작성하게 도와주는 라이브러리
→ spring-test:스프링 통합 테스트 지원

View 환경설정

localhost:8080을 입력했을 때, Error 페이지가 뜨는 걸 확인할 수 있었다.

이제는 Error화면이 아닌, Welcome페이지에 문자가 출력되게 해보자.

welcome페이지는 도메인을 입력했을 때 제일 첫 화면이다.

src> main> resources> static에 index.html 파일을 생성한다.

<!DOCTYPE HTML> <html>
<head>
    <title>Hello</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> </head>
<body> Hello
<a href="/hello">hello</a> </body>
</html>

그리고 이렇게 간단한 html 코드를 사용해 hello문자와 hello링크를 만들어주고 실행하면 다음과 같다.

이렇게 Error화면이 아닌, Hello가 화면에 출력된다.

이렇게 스프링 부트에서는 static/index.html을 올려두면 Welcome page기능을 제공한다.

스프링은 매우매우 거대하고 방대한 기능을 제공하기 때문에 머리에 모두 담을 수 없다.

그렇기 때문에, 필요한 것을 찾을 수 있는 능력이 매우 중요하다.

spring.io에서 spring의 다양한 기능에 대해 알 수 있다.

위 index.html은 정적 페이지이다. 그냥 그대로 웹서버에게 html 파일을 보내는 것이다.

하지만, 템플릿 엔진을 사용하면 동적인 효과를 줄 수 있다.

여기서는 thymeleaf라는 템플릿 엔진을 사용할 것이다.

thymeleaf 템플릿 엔진

→ thymeleaf 공식 사이트: https://www.thymeleaf.org/
→ 스프링 공식 튜토리얼: https://spring.io/guides/gs/serving-web-content/
→ 스프링 부트 메뉴얼: https://docs.spring.io/spring-boot/docs/2.3.1.RELEASE/reference/html/spring-boot-features.html#boot-features-spring-mvc-template-engines

이제 thymeleaf를 사용해 간단하게 동작하고 프로그래밍이 가능한 웹페이지를 만들어 보자.

웹 애플리케이션에서 첫번째 진입점은 컨트롤러(controller)이다.

hello.hellospring밑에 controller라는 패키지를 생성한다.

controller안에 HelloController Class를 생성해준다.

HelloController안의 Class내용은 다음과 같다.

package hello.hellospring.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class HelloController {

    @GetMapping("hello")
    public String hello(Model model) {
        model.addAttribute("data", "hello!!");
        return "hello";
    }
}

여기서 @GetMapping의 ("hello")는 웹 애플리케이션에서 /hello로 들어오면, 해당 메서드를 호출하게 된다.

hello 메서드의 model은 MVC의 Model의 그 Model이다.

그리고, templates에서 hello.html 파일을 생성한다. hello.html의 코드는 다음과 같다.

<!DOCTYPE HTML>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Hello</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 
</head>
<body>
<p th:text="'안녕하세요. ' + ${data}" >안녕하세요. 손님</p> 
</body>
</html>

hello.html의 ${data}는 HelloController의 data의 value값인 hello!로 치환이 된다.

그렇게 실행을 해서 확인을 해보면 다음과 같다.

이렇게 /hello페이지에서 안녕하세요. hello! 가 뜨는 걸 확인할 수 있다.

위와 같은 과정은 아래의 이미지와 같은 과정이다.

컨트롤러에서 리턴 값으로 문자를 반환하면 뷰 리졸버(viewResolver)가 화면을 찾아서 처리한다.

→ 스프링 부트 템플릿 엔진 기본 viewName 매핑

→ resources:templates/ + {ViewName} + .html

참고 : spring-boot-devtools 라이브러리를 추가하면, html 파일을 컴파일만 해주면
서버 재시작 없이 View 파일 변경이 가능하다.
인텔리J 컴파일 방법: 메뉴 build → Recompile

빌드하고 실행하기

이제 IntelliJ에서 실행하는 것이 아닌, 터미널에서 실행을 해보자.

먼저 IntelliJ에서 실행 중이던 것을 종료해야 한다. ( 같은 서버를 동시에 실행할 수 없다. )

먼저 터미널에서 hello-spring 디렉터리로 이동을 해준다.

그리고 gradlew build를 입력하면 필요한 라이브러리를 다운받으면서 빌드를 한다.

빌드가 완료된 후, hello-spring/build/libs 디렉터리로 이동한다.

그리고 java -jar hello-spring-0.0.1-SNAPSHOT.jar을 실행하면, Spring이 출력되면서

터미널에서 실행이 가능해진다.