[스프링부트 입문] 2. 스프링 웹 개발 기초

WEB/Server

[스프링부트 입문] 2. 스프링 웹 개발 기초

kite707 2024. 4. 25. 01:03

개발을 하기 전 스프링에서 웹을 개발하는 3가지 방법에 대해 간단히 살펴보도록 하자. 크게 정적컨텐츠, MVC와 템플릿엔진, API 방식으로 나뉜다.

정적 컨텐츠

실습

정적컨텐츠란 서버에서 따로 작업을 하지 않고 그대로 파일을 웹 브라우저에 내려주는 것이다. 정적이라는 말 그대로 바뀌지 않는 컨텐츠이다.

main/resources/static폴더에 hello-static.html파일을 생성하고(cmd+n) 아래 코드를 넣어보자.

<!DOCTYPE HTML>
 <html>
 <head>
     <title>static content</title>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
 </head>
<body>
정적 컨텐츠 입니다.
</body>
</html>

서버를 실행한 뒤 localhost:8080/hello-static.html로 접속하면 정적컨텐츠입니다.라는 화면이 보일 것이다.

동작 원리

내부적으로는 웹 브라우저에서 localhost:8080/hello-static.html요청이 온 것을 보고 내장된 Tomcat서버에서 스프링에게 hello-static.html이라는 요청이 왔음을 알려준다. 그러면 스프링은 컨트롤러에서 hello-static이 있는지 먼저 살펴본다. 둘 다 있을 경우 컨트롤러가 우선순위를 가짐에 유의하자. 매핑된 컨트롤러가 없으니 스프링은 resources폴더에서 hello-static.html파일을 찾는다. 그렇게해서 있으면 이 파일을 리턴해주는 것이다.

템플릿 엔진

실습

main/resources/templates폴더에 hello.html파일을 하나 생성하고(cmd+n) 아래 코드를 넣도록 하자.

<!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>

그리고 com.example.hello에 controller 패키지를 만들고 HelloController클래스를 만들고 아래와 같이 작성하도록 하자.

package com.example.hello.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";
    }
}

그렇게 하고 localhost:8080/hello 로 접속하면 안녕하세요. hello가 출력된다. 이제 이렇게 작동한 원리를 파악해보도록 하자.

동작 원리

웹브라우저에서 localhost:8080/hello라는 요청이 오면 (브라우저로부터 왔으니 당연히 GET요청이다.) Spring Boot에 내장된 Tomcat서버에서 Spring에게 해당 요청과 매핑된 메서드가 있는지 물어본다. 스프링은 @GetMapping(”hello”)덕분에 hello와 매핑된 hello메서드를 찾을 수 있고, 이 메서드를 실행한다.

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

메서드가 실행되면서 model에 data라는 키와 hello라는 값을 넣는다. 그리고 hello를 리턴한다. 스프링부트 공식 문서에 따르면 컨트롤러에서 return값으로 문자를 반환하면 viewResolver가 화면을 찾아서 처리해준다. 즉 templates폴더에서 hello.html을 찾아 화면에 띄워주게 되는데, 그 전에 Thymeleaf가 ${data}부분을 앞서 저장한 hello라는 값으로 바꿔주는 것이다.

API

실습

앞서 만든 HelloController에 아래 코드를 추가하도록 하자.

   @GetMapping("hello-string")
    @ResponseBody
    public String helloString(@RequestParam(value = "name", required = false)String name){
        return "hello " + name;
    }

    @GetMapping("hello-object")
    @ResponseBody
    public Hello helloApi(@RequestParam("name")String name){
        Hello hello=new Hello();
        hello.setName(name);
        return hello;
    }
    static class Hello{
        private String name;

        public String getName() {
            return name;
        }

        public void setName(String name) {
            this.name = name;
        }
    }

그리고 http://localhost:8080/hello-string?name=kite를 브라우저에 검색하면 기대했던대로 hello kite가 출력되는 것을 확인할 수 있다. 또 http://localhost:8080/hello-object?name=kite라고 치면
{"name":"kite"} 이 출력될 것이다. 내부적으로 일어나는 일을 살펴보도록 하자.

동작 원리

먼저 주목해야 할 점은 @ResponseBody라는 어노테이션이다. hello-string요청이 왔음을 톰캣 서버가 스프링에게 알려주면 앞서 봤던대로 스프링은 Controller에 hello-string이 있는지를 찾는다. 그런데 해당 컨트롤러에는 @ResponseBody어노테이션이 붙어있다. 여기서의 body는 http 헤더-바디 할때 그 body이다. 그 body값을 조작하겠다는 의미이므로 내부적으로 HttpMessageConverter이 동작한다. 이때 리턴값이 문자라면 StringConverter이 동작하고 객체면 JsonConverter가 동작한다.

참고로 http헤더에는 Accept라는 필드가 있는데 그곳에서 json이라는 요청이 오면 json이라고 보내고 xml로 보내면 xml로 변환해서 보낸다. 그리고 아무것도 없으면 스프링이 알아서 변환해서 보낸다. 즉 HTTP accept필드와 서버 컨트롤러 반환 타입의 정보를 조합해서 적절한 HTTP 메시지 컨버터가 선택되고, 컨트롤러 값을 변환해서 반환하는 것이다.