📚 [Spring] #2. 스프링 웹 개발 기초

📕 정적 컨텐츠

서버에서 처리하는 작업 없이 단지 파일을 웹 브라우저에 내려주는 방식

• 스프링 부트는 정적 컨텐츠 기능을 자동으로 제공한다
• resources/static 폴더에 study.html 파일을 만들었다고 하면 정적 페이지의 url은 http://localhost:8080/study.html이 된다

🎈 동작 방식

1. 웹 브라우저에서 http://localhost:8080/hello-static.html을 던지면 내장 톰캣 서버가 받아 스프링한테 전달한다.

2. 스프링은 먼저 Controller 쪽에서 hello-static이 있는지 찾아본다. (Controller가 우선순위를 갖는다)

3. 만약 없다면, resources/static 폴더 안에서 해당 페이지를 확인한 후 존재한다면 그 파일을 반환한다.

📙 MVC와 템플릿 엔진

서버에서 프로그래밍해서 HTML을 동적으로 바꿔서 내려주는 방식

• MVC란 Model View Controller을 말한다
  Model : 화면에 필요한 것들을 담아서 전달하고, 내부 비즈니스 로직을 처리하는 역할
  View : 화면을 그리는 역할, 사용자에게 보여주는 화면(UI)
  Controller : 비즈니스 로직이나 서버 뒷 단에 관련된 것을 처리하고, Model과 View 사이를 이어주는 인터페이스 역할

🎈 @RequestParam

웹 url에서 파라미터를 받아와 데이터에 저장 (ex. ?name=spring!)

@GetMapping("hello-mvc")
public String helloMvc(@RequestParam("name") String name, Model model) {
	model.addAttribute("name", name);
	return "hello-template";
}

http://localhost:8080/hello-mvc?name=spring!
@RequestParam에서는 required라는 속성이 있다. default 값은 true이기 때문에 값을 넘기지 않으면 오류가 뜬다. 만약 값을 넘기고 싶지 않다면 required를 false로 넣어주면 된다. required = false일 때 요청 파라미터에 값이 없으면 null이 저장된다.

🎈 이 코드는 뭐야?

위 코드에서 하이라이트 코드는 없이도 제대로 동작한다! 그렇다면 왜 필요한걸까?

thymeleaf 기능 중 하나인데 서버 없이 HTML 파일을 열어 화면에 띄울 수 있도록 해준다!

🎈 동작 방식

1. 웹 브라우저에서 http://localhost:8080/hello-mvc를 던지면 내장 톰캣 서버가 받아 스프링한테 전달한다.

2. 전달받은 스프링은 매칭 가능한 Controller를 찾아 해당 메소드를 실행시킨다. (@GetMapping)

3. 매칭된 메소드는 리턴을 할 때 hello-template을 넘기고 Model에는 (name:spring)을 담아 보낸다.

4. viewResolver가 화면을 찾고 템플릿 엔진에 연결한다.

5. 템플릿 엔진이 렌더링을 통해 변환된 HTML을 웹 브라우저에 반환한다.

📒 API

서버에서 Json 데이터 구조 포맷으로 클라이언트에게 데이터를 전달하는 방식

@GetMapping("hello-string")
@ResponseBody //HTTP의 Body에 문자 내용을 직접 반환
public String helloString(@RequestParam("name") String name) {
	return "hello " + name; //만약 name이 spring이라면 hello spring, view 없이 문자가 바로 전달
}

✔ View를 작성하지 않기 때문에 페이지 소스 보기를 했을 때 html 코드로 뜨지 않고 글자만 그대로 뜸

🎈 JSON

@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;
	}
}

✔ 객체를 전달하게 되면, key와 value로 이루어진 JSON 형식으로 반환

🎈 동작 방식

1. 웹 브라우저에서 http://localhost:8080/hello-api를 던지면 내장 톰캣 서버가 받아 스프링한테 전달한다.

2. 전달받은 스프링은 매칭 가능한 Controller를 찾아 해당 메소드를 실행시킨다. (@GetMapping)

3. @ResponseBody는 HTTP의 응답 body에 그대로 데이터를 넘기도록 동작한다. 이때, 넘겨야 하는 데이터가 문자라면 바로 반환하고 객체라면 json 방식으로 데이터를 만들어 반환하도록 default가 설정되어 있다.

4. 변환을 하기 위해 HttpMessageConverter가 동작하는데, 기본 문자 처리는 StringHttpMessageConverter에서 하고, 기본 객체 처리는 MappingJackson2HttpMessageConverter에서 한다.

5. 추가로 byte 처리 등 여러 HttpMessageConverter가 기본으로 등록되어 있다. 클라이언트의 HTTP Accept 헤더와 서버의 컨트롤러 반환 타입 정보를 조합해서 선택한다.

6. 그 후 변환된 데이터를 요청한 서버나 웹 브라우저로 반환한다.

📚 참고자료

스프링 입문 - 코드로 배우는 스프링 부트, 웹 MVC, DB 접근 기술