김영한의 스프링 입문 - 2. 스프링 웹 개발 기초

채개바라 2024. 2. 13. 22:22

2024. 2. 13. 22:22

정적 컨텐츠

서버에서는 따로 하는 것 없이 그대로 웹 브라우저에 내려주는 방식

[resources/static/hello-static.html]

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

MVC와 템플릿 엔진

HTML을 그냥 내려주는 방식이 아니라 서버 내에서 프로그래밍을 하고, HTML을 동적으로 바꾼 뒤에 웹 브라우저에 내려주는 방식
MVC: Model, View, Controller
Model = 데이터와 비즈니스 로직을 관리
View = 레이아웃과 화면을 처리
Controller = Model과 View로 명령을 전달

Controller

@Controller
public class HelloController {
    @GetMapping("hello-mvc")
    public String helloMvc(@RequestParam("name") String name, Model model){
        model.addAttribute("name", name);
        return "hello-template"; //hello-template 파일을 찾아서 렌더링
    }
}

@RequestParam: HTTP 요청 파라미터 이름으로 바인딩하는 방법. RequestParam을 사용하면 외부에서 요청한 파라미터를 매우 편리하게 사용할 수 있다.
@RequestParam("가져올 데이터의 이름") 데이터 타입, 가져온 데이터를 담을 변수
return "hello-template": hello-template 파일을 찾아서 렌더링한다.

View

[resources/templates/hello-template.html]

<html xmlns:th="http://www.thymeleaf.org">
<body>
<p th:text="'hello ' + ${name}">hello! empty</p>
</body>
</html>

외부에서 파라미터(name)를 받는다. (@RequestParam)
서버 작동 없이 절대경로(C:\study\hello-spring\src\main\resources\templates\hello-template.html)로 실행하면
hello! empty가 출력된다.

API

JSON 형식으로 바꾸어 HTTP Body에 전달하는 방식

JSON이란? (JavaScript Object Notation)

자바 스크립트 객체 표기법
데이터를 쉽게 교환하고 저장하기 위한 텍스트 기반의 데이터 교환 표준
JSON은 텍스트 기반이기 때문에 다양한 프로그래밍 언어에서 데이터를 읽고 사용할 수 있다.
{ key : value } : 키(key)와 값(value)의 쌍으로 이루어져 있는 구조

1. @ResponseBody 문자 반환

package hello.hellospring.controller;

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

@ResponseBody: HTTP(통신 프로토콜)의 body 부에 return값을 직접 넣어주겠다는 의미
@ResponseBody를 사용하면 ViewResolver를 사용하지 않기 때문에 api를 사용하면 view가 따로 없다.
따라서 '페이지 소스 보기'를 확인해봐도 HTML 관련 코드는 없고 출력된 문자만 보인다.
템플릿 엔진 vs API
템플릿 엔진은 view라는 템플릿이 있는 상황에서 view를 HTML로 변환하고, API는 데이터를 그대로 내보낸다.

2. @ResponseBody 객체 반환

사실 @ResponseBody는 문자열(String)을 전달하는 경우는 거의 없고, 데이터. 즉, 객체를 요청할 때 주로 사용한다.

package hello.hellospring.controller;

@Controller
public class HelloController {
    @GetMapping("hello-api")
    @ResponseBody
    public Hello helloApi(@RequestParam("name") String name){
        Hello hello = new Hello();
        hello.setName(name);
        return hello;
        //객체 => Json방식(디폴트)
    }

    static class Hello{
        private String name; //key

        public String getName() {
            return name;
        }

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

Hello라는 클래스를 만들고, 변수 name과 해당 변수에 대한 Getter/Setter을 생성한다.
@GetMapping을 통해 url과 연결하고, @RequestParam을 통해 url에서 변수(name)의 정보를 받도록 한다. 그리고 그 정보를 hello.setName을 통해 hello 객체의 변수 name에 대입한다.
return hello; : 위의 예제처럼 문자를 반환하는 것이 아니라 객체를 반환한다. 객체를 리턴하면 객체가 JSON 방식으로 표현된다. (JSON 방식이 디폴트)

페이지 소스 보기: {key값 : value값}의 JSON 형태로 출력됨

@ResponseBody 사용 원리

@ResponseBody의 사용
- HTTP의 BODY에 문자 내용을 직접 반환
- viewResolver 대신에 HttpMessageConverter가 동작
- 기본 문자처리: StringHttpMessageConverter
- 기본 객체처리: MappingJackson2HttpMessageConverter
- byte 처리 등등 기타 여러 HttpMessageConverter가 기본으로 등록되어 있음

저작자표시 비영리 변경금지

StartCode

김영한의 스프링 입문 - 2. 스프링 웹 개발 기초

정적 컨텐츠

MVC와 템플릿 엔진

API

1. @ResponseBody 문자 반환

2. @ResponseBody 객체 반환

+ Recent posts

티스토리툴바