인프런 강의 37일차.

 - 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 1 (김영한 강사님)

 - 서블릿, JSP, MVC 패턴

 - 서블릿으로 1차 구현

   -> 서블릿으로 구현했을 때 불편한 점 개선을 위해 JSP로 2차 구현

   -> JSP로도 불편한 점을 개선하기 위해 MVC 패턴으로 3차 구현

 - 스프링 프로젝트 시작

   -> 스프링 기본기능 이해

   -> 스프링 MVC 웹페이지 만들기

4. 스프링 MVC - 기본 기능

 4.1 프로젝트 생성

  > 스프링 프로젝트 생성 (https://start.spring.io)

   - 프로젝트 선택 Project: Gradle Project

   - Language: Java

   - Spring Boot: 2.6.x

   - Group: hello

   - Artifact: springmvc

   - Name: springmvc

   - Package name: hello.springmvc

   - Packaging: Jar

   - Java: 11

   - Dependencies: Spring Web, Thymeleaf, Lombok

  > Packaging는 War가 아니라 Jar를 선택. JSP를 사용하지 않기 때문에 Jar를 사용하는 것이 좋습니다.

  > Jar를 사용하면 항상 내장 서버(톰캣등)을 사용하고, webapp 경로도 사용하지 않습니다.

  > 내장 서버 사용에 최적화 되어 있는 기능입니다.

  > War를 사용하면 내장 서버도 사용가능 하지만, 주로 외부 서버에 배포하는 목적으로 사용합니다.

* gradle.build 실행 후 아래 오류 발생 시 gradle-wrapper.properties에서 gradle 버전을 6.9 이하로 변경해서 다운로드하자. (gradle-6.9-all.zip)

 > Unable to find method 'org.gradle.api.artifacts.result.ComponentSelectionReason.getDescription()Ljava/lang/String;'. Possible causes for this unexpected error include: Gradle's dependency cache may be corrupt (this sometimes occurs after a network connection timeout.) Re-download dependencies and sync project (requires network)

  > Welcome 페이지 생성

   - 스프링부트에 Jar를 사용하면 /resources/static/index.html 파일이 존재할 시 Welcome 페이지로 처리해준다.

  > @RestController

   - @Controller 는 반환 값이 String 이면 뷰 이름으로 인식된다. 그래서 해당 뷰를 찾고 뷰가 랜더링 된다.  

   - @RestController 는 반환 값으로 뷰를 찾는 것이 아니라, HTTP 메시지 바디에 바로 입력한다.

   - 따라서 실행 결과로 ok 메세지를 받을 수 있다.

  > 로그 레벨 설정

   - application.properties 설정

#전체 로그 레벨 설정(기본 info)
logging.level.root=info

#hello.springmvc 패키지와 그 하위 로그 레벨 설정
logging.level.hello.springmvc=debug

  > 로그 사용법

   - log.debug("data="+data) : 로그 출력 레벨을 info로 설정해도 해당 코드에 있는 "data="+data가 실제 실행이 되어 버린다. 결과적으로 문자 더하기 연산이 발생한다. 즉 의미 없는 연산이 지속적으로 일어난다.

   - log.debug("data={}", data) : 로그 출력 레벨을 info로 설정하면 아무일도 발생하지 않는다. 따라서 앞과 같은 의미없는 연산이 발생하지 않는다. (이렇게 사용해야함)

  > 로그 사용시 장점

   - 쓰레드 정보, 클래스 이름 같은 부가 정보를 함께 볼 수 있고, 출력 모양을 조정할 수 있다.

   - 로그 레벨에 따라 개발 서버에서는 모든 로그를 출력하고, 운영서버에서는 출력하지 않는 등 로그를 상황에 맞게 조절할 수 있다.

   - 시스템 아웃 콘솔에만 출력하는 것이 아니라, 파일이나 네트워크 등, 로그를 별도의 위치에 남길 수 있다.

   - 특히 파일로 남길 때는 일별, 특정 용량에 따라 로그를 분할하는 것도 가능하다.

   - 성능도 일반 System.out보다 좋다. (내부 버퍼링, 멀티 쓰레드 등등) 그래서 실무에서는 꼭 로그를 사용해야 한다

package hello.springmvc.basic.requestmapping;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.*;

@RestController
public class MappingController {

    private Logger log = LoggerFactory.getLogger(getClass());

    /**
     * 기본 요청
     * 둘다 허용 /hello-basic, /hello-basic/
     * HTTP 메서드 모두 허용 GET, HEAD, POST, PUT, PATCH, DELETE
     */
    @RequestMapping({"/hello-basic", "/hello-go"})
    public String helloBasic(){
        log.info("helloBasic");
        return "ok";
    }
}

/**
 * method 특정 HTTP 메서드 요청만 허용
 * GET, HEAD, POST, PUT, PATCH, DELETE
 */
@RequestMapping(value = "/mapping-get-v1", method = RequestMethod.GET)
public String mappingGetV1() {
    log.info("mappingGetV1");
    return "ok";
}

/**
 * 편리한 축약 애노테이션 (코드보기)
 * @GetMapping
 * @PostMapping
 * @PutMapping
 * @DeleteMapping
 * @PatchMapping
 */
@GetMapping(value = "/mapping-get-v2")
public String mappingGetV2() {
    log.info("mapping-get-v2");
    return "ok";
}

/**
 * PathVariable 사용
 * 변수명이 같으면 생략 가능 (@PathVariable String userId)
 * @PathVariable("userId") String userId -> @PathVariable userId
 */
@GetMapping("/mapping/{userId}")
public String mappingPath(@PathVariable("userId") String data) {
    log.info("mappingPath userId={}", data);
    return "ok";
}

/**
 * PathVariable 사용 다중
 */
@GetMapping("/mapping/users/{userId}/orders/{orderId}")
public String mappingPath(@PathVariable String userId, @PathVariable Long
        orderId) {
    log.info("mappingPath userId={}, orderId={}", userId, orderId);
    return "ok";
}

/**
 * 파라미터로 추가 매핑
 * params="mode",
 * params="!mode"
 * params="mode=debug"
 * params="mode!=debug" (! = )
 * params = {"mode=debug","data=good"}
 */
@GetMapping(value = "/mapping-param", params = "mode=debug")
public String mappingParam() {
    log.info("mappingParam");
    return "ok";
}

/**
 * 특정 헤더로 추가 매핑
 * headers="mode",
 * headers="!mode"
 * headers="mode=debug"
 * headers="mode!=debug" (! = )
 */
@GetMapping(value = "/mapping-header", headers = "mode=debug")
public String mappingHeader() {
    log.info("mappingHeader");
    return "ok";
}

   - header에 mode=debug 값을 추가해서 호출 시에만 정상적으로 호출된다.

/**
 * Content-Type 헤더 기반 추가 매핑 Media Type
 * consumes="application/json"
 * consumes="!application/json"
 * consumes="application/*"
 * consumes="*\/*"
 * MediaType.APPLICATION_JSON_VALUE
 */
@PostMapping(value = "/mapping-consume", consumes = "application/json") //consumes = MediaType.APPLICATION_JSON_VALUE
public String mappingConsumes() {
    log.info("mappingConsumes");
    return "ok";
}

  > 미디어 타입 조건 매핑 - HTTP 요청 Content-Type, consume

   - HTTP 요청의 Content-Type 헤더를 기반으로 미디어 타입으로 매핑한다.

   - 만약 맞지 않으면 HTTP 415 상태코드(Unsupported Media Type)을 반환한다.

   - Postman으로 테스트 해야한다.

/**
 * Accept 헤더 기반 Media Type
 * produces = "text/html"
 * produces = "!text/html"
 * produces = "text/*"
 * produces = "*\/*"
 */
@PostMapping(value = "/mapping-produce", produces = "text/html")    //produces = MediaType.TEXT_HTML_VALUE
public String mappingProduces() {
    log.info("mappingProduces");
    return "ok";
}

  > 미디어 타입 조건 매핑 - HTTP 요청 Accept, produce

   - HTTP 요청의 Accept 헤더를 기반으로 미디어 타입으로 매핑한다.

   - 만약 맞지 않으면 HTTP 406 상태코드(Not Acceptable)을 반환한다

   - Header중 Accpet의 값을 application/json으로 테스트 해볼 시 406 에러 발생

* ContentType : consume 로 사용해야 한다.

* Accpet : produce 로 사용해야 한다.

  > 요청 매핑 - API 예시 (회원 관리 API)

package hello.springmvc.basic.requestmapping;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/mapping/users")
public class MappingClassController {

    /**
        회원 관리 API
        회원 목록 조회: GET /users
        회원 등록: POST /users
        회원 조회: GET /users/{userId}
        회원 수정: PATCH /users/{userId}
        회원 삭제: DELETE /users/{userId}
    */

    /**
     * GET /mapping/users
     */
    @GetMapping
    public String users() {
        return "get users";
    }

    /**
     * POST /mapping/users
     */
    @PostMapping
    public String addUser() {
        return "post user";
    }

    /**
     * GET /mapping/users/{userId}
     */
    @GetMapping("/{userId}")
    public String findUser(@PathVariable String userId) {
        return "get userId=" + userId;
    }

    /**
     * PATCH /mapping/users/{userId}
     */
    @PatchMapping("/{userId}")
    public String updateUser(@PathVariable String userId) {
        return "update userId=" + userId;
    }

    /**
     * DELETE /mapping/users/{userId}
     */
    @DeleteMapping("/{userId}")
    public String deleteUser(@PathVariable String userId) {
        return "delete userId=" + userId;
    }
}

    - @RequestMapping("/mapping/users") 클래스 레벨에 매핑 정보를 두면 해당 정보를 조합해서 사용한다.

인프런 강의 21일차.

 - 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 1 (김영한 강사님)

* 스프링 시작

1. start.spring.io

 - 해당 옵션들을 선택해서 Generate

2. 프로젝트가 정상적으로 세팅되었는지 ServletApplication 실행

 - localhost:8080 접속 시 Whitelabel 오류 나오면 정상적으로 서버 실행 완료(아직 세팅한게 없으니 오류가 정상)

3. 환경설정 변경

 - 빌드 및 실행/테스트 실행 : Default가 Gradle로 되어있지만 IntelliJ IDEA로 실행하도록 변경

4. Lombok 라이브러리 설치

 - Lombok 라이브러리 설치

5. 어노테이션 프로세스 체크

 - 어노테이션 처리 활성화 체크해서 적용

6. Hello 서블릿

 - 스프링 부트 환경에서 서블릿을 등록하고 사용해보자.

  * 참고 : 서블릿은 톰캣 같은 웹 애플리케이션 서버를 직접 설치하고, 그 위에 서블릿 코드를 클래스 파일로 빌드해서 올린 다음, 톰캣 서버를 실행하면 된다. 하지만 이 과정은 매우 번거롭다. 스프링 부트는 톰캣 서버를 내장하고 있으므로, 톰캣 서버 설치 없이 편리하게 서블릿 코드를 실행할 수 있다.

7. 스프링 부트 서블릿 환경 구성

 - @ServletComponentScan

    > 스프링 부트는 서블릿을 직접 등록해서 사용할 수 있도록 @ServletComponentScan을 지원한다.

//ServletApplication.java
package hello.servlet;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletComponentScan;

@ServletComponentScan		//서블릿 자동 등록
@SpringBootApplication
public class ServletApplication {

	public static void main(String[] args) {
		SpringApplication.run(ServletApplication.class, args);
	}

}

//HelloServlet.java
package hello.servlet.basic;

import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import java.io.IOException;

@WebServlet(name = "helloServlet", urlPatterns = "/hello")
public class HelloServlet extends HttpServlet {
    
    @Override       //Ctrl + O 단축키를 통해 메소드 자동 구현
    public void service(ServletRequest request, ServletResponse response) throws ServletException, IOException {

        System.out.println("HelloServlet.Service");
        System.out.println("request = " + request);
        System.out.println("response = "+ response);

        String username = request.getParameter("username");
        System.out.println("username = " + username);

        response.setContentType("text/plain");
        response.setCharacterEncoding("utf-8");
        response.getWriter().write("hello "+username);  //html body에 들어가는 내용
    }
}

 - @WebSevlet : 서블릿 애노테이션

    > name : 서블릿 이름

    > urlPatterns : URL 매핑

 - HTTP 요청을 통해 매핑된 URL이 호출되면 서블릿 컨테이너는 다음 메소드를 실행한다.

    > protected void service(HttpServletRequest request, HttpSevletResponse response)

 - 웹 브라우저 실행

    > http://localhost:8080/hello?userame=world

    > 결과 : hello world

 - 콘솔 실행 결과

    > HelloServlet.Service
    > request = org.apache.catalina.connector.RequestFacade@d7b5a2c
    > response = org.apache.catalina.connector.ResponseFacade@15c00532
    > username = world

 - HTTP 요청 메시지 로그로 확인하기

    > 다음 파일에 설정 추가 (resources/application.properties)

    > logging.level.org.apache.coyote.http11=debug 추가 시 HTTP req, res 내용을 전부 볼 수 있다.

  * 운영서버에 모든 로그를 남길 시 성능저하가 될 수 있으니 참고.

8. 서블릿 컨테이너 동작 방식 설명

 - 스프링부트가 내장 톰캣 서버를 생성한다.

 - 내장 톰캣 서버가 서블릿 컨테이너를 통해 서블릿을 생성한다.

 - 웹 브라우저가 HTTP 요청.

 - HTTP 요청 메시지를 기반으로 WAS가 request, response 객체를 생성해서 싱글톤으로 떠있는 서블릿을 호출함

 - 서블릿이 종료되면 Response 객체 정보를 WAS에 전달

 - WAS는 전달된 Response 객체 정보로 HTTP 응답 메시지를 생성함.

 - 참고 : HTTP 응답에서 Content-Length는 WAS가 자동으로 생성해준다.