[Spring] 스프링 웹 개발 기초

sooonlog 2023. 1. 7. 23:50

2023. 1. 7. 23:50

🙌잘못된 설명에 대한 지적이나 조언의 댓글을 환영합니다🙌

서론

사수님이 퇴사하고, 주로 비즈니스 로직을 다루는 백엔드 작업을 할 일이 많아졌다. 기존에는 코드를 마치 레시피처럼 외워서 개발해왔기 때문에 문제가 생겼을 때 스스로 디버깅하기가 어려웠다. 그래서 주 1회 퇴근 후 스터디를 통해 스프링 입문부터 공부하기로 결심했다. 오늘은 그 첫 번째 챕터인 웹개발 기초에 대해 알아보고자 한다.

스프링을 통한 웹 개발 방법

스프링으로 웹개발을 할 때 아래 세 가지 방법을 사용할 수 있다.

1. 정적컨텐츠 : HTML 파일 그대로 웹 브라우저에 전달

2. MVC와 템플릿 엔진 : 서버에서 HTML 파일을 동적으로 변환한 뒤 웹 브라우저에 전달

3. API : JSON으로 데이터를 클라이언트에 직접적으로 전달

각 방법의 특징과 스프링에서의 동작방식에 대해서 알아보자.

정적컨텐츠의 동작과 특징

정적컨텐츠는 클래스 경로나 ServletContext 루트에 있는 /static(or /public, /resources, META-INF/resources) 디렉터리에서 제공한다. 해당 폴더 내에 HTML 파일을 추가하는 경우 이를 그대로 반환한다는 특징이 있다. 별도의 설정 없이 스프링부트에서 기본적으로 제공하는 기능이지만 Spring MVC의 ResourceHttpRequestHandler를 사용하여 동작하기 때문에 자체 WebMvcConfigurer를 추가하고 addResourceHandlers 메소드를 재정의하여 해당 동작을 수정할 수도 있다.(~~하지만 이렇게 수정해서 사용할 이유가 없음..~~) 또한, 기본적으로 리소스는 /**에 mapping되며, 이 경로를 수정하고 싶은 경우 spring.mvc.static-path-pattern 속성을 변경하여 mapping 경로를 수정하는 것도 가능하다.

스프링부트로 실행한 웹 브라우저에서 정적컨텐츠인 HTML파일을 표시하기 위해 톰캣 서버로 요청을 보내면, 스프링부트의 스프링컨테이너에서는 해당 url과 mapping 된 controller를 찾는다. 하지만 controller가 없는 정적컨텐츠이기 때문에, static 폴더 등을 살펴보고 동일한 이름의 HTML파일을 브라우저로 전달하는 방식으로 동작한다.

출처: 김영한님의 스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술 강의

MVC와 템플릿 엔진의 동작과 특징

이 방법의 특징은 한번 렌더링 한 HTML을 브라우저에 전달한다는 점이다. 이해를 위해 MVC란 무엇인지에 대해 먼저 알아보자. MVC는 Model, View, Controller의 구성을 뜻하며, 역할에 따라 기능을 분리하여 제공하기 위해 사용한다. Model은 controller가 화면에 표시해야 하는 것들을 정리해서 담는 곳이며, 이를 view에 전달하는 역할을 한다. View는 오로지 화면을 그리는 일만을 담당하며, Controller는 비즈니스 로직을 담당하며, 요청을 받았을 때 화면 뒷단에서 처리해야 하는 일들을 담는 역할이다. 여기서 View가 php, jsp 등 템플릿엔진을 통해 Model, Controller의 정보를 받아 HTML을 다시 렌더링 하고 그 결과를 브라우저에 전달하도록 개발하면 된다. 이처럼 템플릿엔진을 MVC방식으로 쪼개서 동작하도록 만들었다면 이 방법을 사용한 것이라고 이야기할 수 있다.

웹 브라우저의 요청을 톰캣서버로 보냈을 때 스프링컨테이너에서 가장 먼저 확인하는 Controller단에서 mapping된 정보가 존재한다면, 컨트롤러의 동작을 먼저 수행하고 이를 바탕으로 viewResolver가 HTML파일을 렌더링해 변환을 마친 HTML을 웹 브라우저로 전달하는 방식으로 동작한다.

API의 동작과 특징

API 방식은 데이터를 바로 내려준다는 특징을 가진다. 이 방식을 사용하기 위해서는 Controller에서 @ResponseBody라는 어노테이션을 사용해야 하는데, 이는 해당 데이터를 HTML의 <Body> 태그 내부로 전달한다는 뜻이 아닌, HTTP 내 응답 Body부분에 해당 데이터를 직접 넘겨주겠다고 정하는 것을 뜻한다. 따라서 return 값이 view 템플릿을 거치는 것이 아니라 데이터 형식 그대로 전달된다는 특징이 있다.

웹 브라우저를 통해 톰캣서버로 전달된 요청은 MVC 때와 동일하게 스프링컨테이너 내 mapping된 Controller로 전달되고, 해당 Controller에 적용된 @ResponseBody가 파라미터를 통해 생성한 객체를 그대로 return으로 반환한다. 이때 HttpMessageConverter가 JsonConverter를 통해 객체를 JSON 형태로 변환하여 이를 웹 브라우저에 전달하는 방식으로 동작한다.

@Controller
public class HelloController {
 
    @GetMapping("hello-api")
    @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;
        }
    }
}

정리하며,

이렇게 오늘은 스프링을 통해 웹개발하기 위한 방법 세 가지에 대해 공부했다. 부끄럽지만 평소 내가 사용하고 있는 방식이 API인지도 정확히 모르고 사용해 왔었고, view 구성을 위해 model에 데이터를 넘겨주는 방법도 이제야 제대로 알게 된 것 같다. 아직 기본적인 내용 밖에 담지 못했지만, 점차 학습하며 각 방법을 적절하게 활용하는 개발자가 되어야겠다💪

Reference

Spring Boot Features

Graceful shutdown is supported with all four embedded web servers (Jetty, Reactor Netty, Tomcat, and Undertow) and with both reactive and Servlet-based web applications. It occurs as part of closing the application context and is performed in the earliest

docs.spring.io

[무료] 스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술 - 인프런 | 강의

스프링 입문자가 예제를 만들어가면서 스프링 웹 애플리케이션 개발 전반을 빠르게 학습할 수 있습니다., - 강의 소개 | 인프런...

www.inflearn.com

'BE' 카테고리의 다른 글

[ERROR] org.hibernate.ObjectDeletedException: deleted object would be re-saved by cascade (0)	2023.05.31
[postgreSQL] pgAdmin4 테이블 csv 파일 추출 방법 (0)	2023.02.11
[AxiosError] Request failed with status code 403 (0)	2022.04.27
[ERROR] ContextLoaderListener 관련 오류 (4)	2022.04.20

sooonlog