🎽 인프런 워밍업 클럽 0기 백엔드 두 번째 과제

출처
https://inf.run/XKQg

⛳️ 문제 1

@RequestParam

@GetMapping("/api/v1/calc")
public CalcResponse getCalcResults(
	@RequestParam int num1, 
    @RequestParam int num2) {
	// ..
}

@RequestParam 어노테이션을 사용하면, HTTP 요청 파라미터의 이름으로 바인딩하여 그 값을 변수에 저장한다.
(파라미터의 이름과 변수이름이 다르다면, @RequestParam의 value를 작성해야 한다.)

다만, 여러 개의 파라미터를 받을 때 @RequestParam을 사용하면 가독성을 해칠 수 있으므로 Dto로 받아오도록 한다.

Dto(Data Transfer Object)

// Request Dto
public record CalcRequest(int num1, int num2) {
}

// Response Dto
public record CalcResponse(int add, int minus, int mul) {
}

Dto는 이름 그대로 데이터를 전달하는 객체이다.
Controller의 API method의 파라미터로 Dto를 사용하면, 스프링이 자동으로 Dto에 쿼리 파라미터를 바인딩한다.
또한, 연산 결과를 Dto에 담아 리턴하면, 스프링이 해당 객체를 JSON으로 자동 변환하여 응답을 해준다.

여기서 class 대신 적은 코드로 명확한 의도를 표현할 수 있는 record 를 사용했다.

record 특징은 다음과 같다.

• 멤버 변수는 private final로 선언된다. (불변)
• getter가 자동으로 생성된다.
• 모든 멤버 변수에 대한 public 생성자를 자동으로 생성한다.
• equals, hashcode, toString을 자동으로 생성한다.

💻 최종 코드

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class CalcController {

  @GetMapping("/api/v1/calc")
  public CalcResponse getCalcResults(CalcRequest request) {
      int num1 = request.num1();
      int num2 = request.num2();
      return new CalcResponse(num1 + num2, num1 - num2, num1 * num2);
  }
}

⛳️ 문제 2

LocalDate

과거에는 기본 날짜 타입인 Date 클래스, Calendar 클래스를 사용했지만, Java 8부터 LocalDate 클래스를 사용한다.

LocalDate의 주요 특징은 다음과 같다.

• 날짜(yyyy-MM-dd)를 나타낸다.
• 불변 객체이므로 thread-safe하다.

💻 최종 코드

import java.time.DayOfWeek;
import java.time.LocalDate;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class DayController {

    @GetMapping("/api/v1/day-of-the-week")
    public DayResponse getDay(@RequestParam("date") LocalDate date) {
        DayOfWeek dayOfWeek = date.getDayOfWeek();
        return new DayResponse(dayOfWeek.toString());
    }
}

이번에는 @RequestParam 어노테이션과 LocalDate를 사용하여 쿼리 파라미터 값을 바인딩했다.
또한, 요일을 리턴해야 하므로 LocalDate 클래스의 getDayOfWeek() 메소드를 사용했다.

⛳️ 문제 3

@RequestBody

POST API를 만들기 위해 @RequestBody 어노테이션을 사용해야 한다.
@RequestBody는 스프링에서 요청 본문을 자바 객체로 매핑하는 어노테이션이며, 본문 데이터가 없으면 400 Bad Request 오류를 발생한다.

💻 최종 코드

public record SumRequest(List<Integer> numbers) {

}

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class CalcController {

    @PostMapping("/api/v1/sum")
    public int sumNumbers(@RequestBody SumRequest request) {
        return request.numbers().stream()
                .mapToInt(number -> number)
                .sum();
    }
}

Request Dto의 멤버 변수를 List<Integer>로 지정하여 JSON 배열을 매핑하고, 스트림을 사용하여 리스트 요소의 합을 계산하여 리턴하도록 했다.