[SpringBoot 입문 시리즈 (2)] 스프링 웹 개발 기초 - 정적 컨텐츠, MVC와 템플릿 엔진, API

이 포스트는 인프런의 스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술(무료) 강의 내용을 정리한 글이다.

---

 

스프링이 클라이언트에게 페이지를 보여주는 경우는 세가지가 있다.

1. 정적 파일 제공 (ex: test.jpeg, test.html)
2. 템플릿 엔진(html을 동적으로 바꾸는 애들)과 MVC(Model, View, Controller)
3. API - JSON 형태로 클라이언트에게 직접 데이터를 내려주는 형식

오늘은 이 세가지에 대해 포스팅해보도록 하겠다.

 

정적 파일 제공

src/main/resources/static에 정적 파일 abc.txt를 저장했다고 해보자.

그러면 URL에서 검색할 때 localhost:8080/abc.txt로 그냥 접근하면된다. (단순히 URL에 파일 입력하면 됨)

물론 프로그램 같은 거 말고 단순 파일만 띄워줄 수 있다!

간단한 html 정적 파일

 

로직은 뭘까?

일단 웹브라우저에서 localhost:8080/hello-spring.html로 접근하면, 먼저 톰캣 서버가 hello-spring이라는 이름의 컨트롤러를 찾는데, 없으므로 static에 가서 찾게 되는 것이다. 이처럼 먼저 컨트롤러에 가서 스프링은 맞는 컨트롤러를 찾는다.

강의 자료 첨부 (문제 시 바로 삭제)

MVC

MVC는 Model, View, Controller의 약자이다. 이제 이 세가지와 템플릿 엔진이 어떤 방식으로 돌아가는지 알아보자

 

먼저 View vs Controller이다.

View와 Controller는 비슷한 기능을 하지만 View는 화면을 그리는데 집중한다면, Controller는 비즈니스적 로직, 내부적 로직(ex: 회원가입 중복 검사 등) 을 구현하는데 집중한다.

예전에는 View 파일 하나에다 다 해서 너무 길고 복잡해지는 면이 없지않아 있었는데 이렇게 controller랑 view를 쪼개 기능을 분배하는 것이 더  효율적이어서 현재는 view과 controller를 함꼐 쓰고 있다.

 

@GetMapping("hello-mvc") //hello-mvc라는 경로로 get방식으로 접속했을 때 이 컨트롤러 실행
public String helloMVC(@RequestParam("name") String name, Model model){
	 model.addAtrribute("name",name); //model에 {name:name}으로 key:value 값? 추가
	 return "hello-template"; //이러면 hello-template.html을 띄워줘!
}

//@RequestParam("name") String name : 사용자가 name(왼쪽)이란 이름으로 보내준 값을 String name(오른쪽)으로 받겠다는 뜻
//여기서 끝내면 Required request parameter 'name' for method parameter type String is not present 라는 에러남
//왜냐하면 name이란 파라미터를 안보내줬기 때문

 

위 코드로 localhost/hello-mvc에 접근했을 때는 안타깝게도 에러가 뜬다

이는 쿼리스트링으로 name값을 사용자가 안 보내줬기 때문에 생기는 에러이다. (@GetRequest 에서 name을 받기로 했었으므로) /hello-mvc/name=haeun 이런식으로 접근하면 잘 해결된다.

 

 

강의자료 첨부 (문제 시 바로 삭제)

 

참고) html 파일의 p 태그

<p th:text="'hello' +${name}">hello!empty</p>
//여기서 템플릿 엔진이 작동하면 p 태그 안에 있는 값들*hello+$(name)~이 작동이 되구,,,,,,
만약에 작동 안하면 hello, empty가 작동되는것!(신기한건 그냥 절대경로로 입력해도 url에서 접근이 된다! 그런데 템플릿 엔진은 적용 안되는거구~)

 

API

위에서 템플릿 엔진으로 html파일을 렌더링해서 내려주었다면, 이제 API 방식은 그냥 데이터 그자체만 내려주는 방식이다. 이게 뭔 소린가 아주아주 간단히 설명하면 아래와 같다

 

@GetMapping("hello-string")
@ResponseBody //이걸 추가하면 데이터 자체가 그냥 바로 http 바디에 들어감!! 템플릿 엔지이나 뷰같은거 상관 없이!
// 이게 몬 소리냐 하면, 쿼리스트링에 name 넣어서 접근해서 화면에서 소스보기(개발자 도구말고!) 하면, 그냥 ㄹㅇ로 html 이딴 거 없이 데이터만 썡으로 내려감
public String helloString(@RequestParam("name") String name){
    return "hello "+name;
}

@ResponseBody는 우리가 데이터를 HTTP Response 메시지의 body 부분에 넣어서 보내겠다는 뜻이다!

다른 방식들은 html로 감싸서 들어갔따면 이건 그런거 없다 

 

왼 쪽이 템플릿 엔진 이용해서 간 경우, 오른 쪽은 API 이용해서 간경우의 소스 코드

오른 쪽은 html 따위 없이 말그대로 hello cute만 전달되고 있는 것을 볼 수 있다!

 

 

 

좀더 복잡하게 가보자. 이제 클래스를 정의해주고 이 클래스로 만든 객체를 API로 내보내줄(?) 것이다.

static class Hello{ //클래스 Hello 정의
        private String name;

        //게터세터 정의~올만이야ㅠㅠ
        public String getName(){
            return name;
        }
        public void setName(String name){
            this.name=name;
        }
    }

아주 간단한 Hello라는 클래스를 정의해주었다. 

얘는 name이라는 String을 멤버로, getName(),setName()이라는 메소드를 가진다.

 

@GetMapping("hello-api") 
@ResponseBody 
public Hello helloAPI(@RequestParam ("name") String name){ //이제 Hello라는 객체를 변환하는 메소드!
        //참고로 @requestParam(name)은 사용자가 보낸 변수 'name'(왼쪽)을 오른쪽 name이라는 String으로 받는다는 거 같다
        Hello hello = new Hello();
        hello.setName(name);
        return hello; //hello라는 객체를 반환
    }
    //json은 key,value 형태로된 구조
}

 

처음으로 String이 아니라 객체를 반환하는 메소드가 나왔다. Hello 객체 생성후 name을 사용자가 설정한 값으로 설정한다. 사용자가 설정하므로 얘도 쿼리스트링에서 ?name=어쩌구 형식으로 보내서 접근해야한다.

 

localhost:8080/hello-api?name=hannah 로 접근한 모습

이처럼 객체 그자체가 반환된 것을 볼 수 있다.

 

이런건 JSON 방식인데, 예전에는 XML 방식이 많이 쓰였다고 한다!! (html 태그가 그런 방식임!) 그런데 좀 무겁고, 태그 열고 닫고 해야돼서 귀찮은 문제가 있었다.. 그래서 요즘은 JSON를 디폴트로 사용한다고 한다!

 

viewResolver는 여기서 안나온다!! 

그리고 객체는 기본으로 json형태로 바꿔서 보내주는 것이 기본 정책이다!!

@ResponseBody 를 사용하면 viewResolver 말고 HttpMessageConverter가 동작하게 된다 (템플릿 엔진을 사용했을 때는 viewResolver로 가서 템플릿을 처리해줬다)

• 아마 HttpMessageConverter는 json형태로 바꿔주는 역할도 하는 애인가…….?
• 오,,, HttpMessageConverter는 객체가 오면 JSON 형태로 바꿔주는 MappingJackson2HttpMessageConverter기능이 내장되어있다고 한다!!(Jackson은 뭥미? 걍 객체를 json으로 바꿔주는 라이브러리가 jackson인듯하다) 그리고 String이 오면 얘를 처리해주는 StringHttpMessageConverter 기능이 있고~! 얘네말고 다른 애들 ex)byte 도 다뤄주는 다른 converter들도 있다구 한당

 

아무튼 오늘은 Spring이 기본적으로 어떤 방식으로 돌아가는지 알아보았다.

 

강의 끝까지 다 들었는데,,, 새로 플젝 파고 거기서 작성했는데 깃헙에 올리다가 터미널에서 실수로 !! 프로젝트를 삭제해버려서 다시 들어야한다..... 거기 필기도 다있음 ㅋ ㅋ ㅋ ㅋ ㅋ ㅋ ㅋ ㅜ ㅠ ㅠ ㅠ