Spring 프로젝트 설정 및 기초

김영한님의 Spring 수업을 듣고 정리한 내용입니다.

공식 사이트

https://spring.io

공식문서에 Document, Getting Started 등을 참조할 수 있다.

프로젝트 생성

https://start.spring.io

Dependency - SpringWeb, ThymeLeaf

Gradle은 버전설정, 라이브러리 가져오고, 라이프 사이클 관리를 수행한다.

build.gradle

repository - mavenCentral 이라는 사이트에서 dependency를 다운로드한다.

dependencies - 라이브러리들 가져온다.

프로젝트를 실행하면 log: Tomcat Started on port(s) 8080 라는 로그가 남는데, 스프링이 내장하는 웹 서버가 TomCat임을 알 수 있다.

스프링에서 라이브러리 살펴보기

External Libraries 를 보면 엄청나게 많은 라이브러리가 온 걸 볼 수 있다.

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'
}

에서, starter-web은 그 안에 톰캣, 웹 등 또 많은 라이브러리에 의존을 하고 있고 Gradle은 의존하는 라이브러리를 다 가져오는 역할을 수행한다.

여기서 라이브러리 간의 의존관계를 살펴볼 수 있는데, 스프링부트 관련 라이브러리를 쓰면, 스프링 코어도 가져오는 것을 확인할 수 있다.

서버에서 로깅 역시 중요한데, 스프링 같은 경우 Gradle Dependencies를 보면 spring-boot-starter-loggin 안에 slf4j, logback 등을 사용하는 것을 볼 수 있다. (자주 사용되는 라이브러리를 스프링 진영에서 추가한 것)

테스트 관련 라이브러리도 마찬가지로 junit(테스트 프레임워크)등이 추가된 것을 볼 수 있다. (그 외 mockito(목 라이브러리), assertj(테스트 코드 라이브러리), spring-test 등이 있다.)

View 환경 설정

Welcome Page 만들기
- 스프링은 src > resources > static에 index.html 파일을 만들면, 해당 페이지가 보여진다. (정적 페이지)
thymeleaf 템플릿 엔진 적용하기 (그 외 FreeMarker, Groovy, Mustache 등이 있다)
Web Application에서 첫 번째 진입점을 Controller라 한다.

package com.kakaopay.springstudy.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";
    }

}

hello.html
- 결과

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

동작환경

컨트롤러에서 리턴한 String을 ViewResolver가 화면을 찾아 처리한다.
- 스프링 부트 템플릿엔진 기본 viewName 매핑
- resources: templates/{viewName}.html
참고
- spring-boot-dedvtools 라는 라이브러리를 추가하면 html 파일을 컴파일만 해주면 서버 재시작 없이 View 파일 변경이 가능하다.

빌드와 실행

$ ./gradlew build

$ cd build

$ java -jar hello-spring-0.0.1-SNAPSHOT.jar

빌드 지우기

$ ./gradlew clean

스프링 웹 개발 기초

정적 컨텐츠
- Spring은 Controller에 맵핑된 게 없다면 static 폴더에서 정적 파일을 찾는다.
MVC와 템플릿 엔진
- MVC는 Model, View, Controller의 준말, 관심사의 분리를 위함 (View는 화면을 그리는 것에만, Model은 데이터의 형식만, Controller는 비즈니스 로직만 관리)
- Parameter 받기

    @GetMapping("hello-mvc")
    public String helloMVC(@RequestParam(value = "name", required = false) String name, Model model) {
        model.addAttribute("name", name);
        return "hello-template";
    }

API (보통 HTML이 아닌 JSON 포멧으로 클라이언트에게 전달, React, Android, Vue 혹은 서버와 통신)
- @ResponseBody는 Body에 이 문자열을 넣을 것을 의미함 (데이터를 그대로 보낼 것이라는 걸 의미함, default가 true이기 때문에 default=false가 없다면 에러가 발생할 것)

    @GetMapping("hello-string")
    @ResponseBody
    public String helloString(@RequestParam("name") String name) {
        return "hello " + name;
    }

JSON 포멧으로 리턴하기 (default가 JSON 리턴)
- ResponseBody 어노테이션이 있다면 ViewResolver가 아닌, HttpMessageConverter가 작동한다.
  - 단순 문자열이면 StringHttpMessageConverter 아니라면 MappingJackson2HttpMessageConverter가 처리를 한다. (따라서 객체가 JSON 형식으로 바뀌어 리턴되는 것)

    static class Hello {
        private String name;
        public String getName() { return name; }
        public void setName(String name) { this.name = name; }
    }

    @GetMapping("hello-api")
    @ResponseBody
    public Hello helloJSON(@RequestParam("name") String name) {
        Hello hello = new Hello();
        hello.setName(name);
        return hello;
    }

결과

저작자표시