💡 @RequestParam

---

✔️ 요청 파라미터를 연결할 때 매개변수에 붙이는 애너테이션

✏️ @RequestParam: required=false & String year

@RequestMapping("/requestParam2")
//public String main2(@RequestParam(name="year", required=false) String year)
public String main2(String year) {
//		http://localhost/ch2/requestParam2         ---->> year=null
//		http://localhost/ch2/requestParam2?year    ---->> year=""
     System.out.printf("[%s]year=[%s]%n", new Date(), year);
     return "yoil";
}

➡️ public String main2(@RequestParam(name="year", required=false) String year)
: 생략된 것. year를 필수로 입력안해도 됨

• required: 필수입력 여부
• @RequestParam 을 붙이면 required는 true가 됨

---

✏️ @RequestParam: required=true & String year

   @RequestMapping("/requestParam3")
//  public String main3(@RequestParam(name="year", required=true) String year) {   // 아래와 동일
    public String main3(@RequestParam String year) {
        System.out.printf("[%s]year=[%s]%n", new Date(), year);
        return "yoil";
    }

• http://localhost/ch2/requestParam3?year
  ➡️ year = ""

• http://localhost/ch2/requestParam3
  ➡️ 400 Bad Request.
  : required=true라서 클라이언트 잘못. 무조건 year의 값을 넣어줘야 함

---

✏️ @RequestParam: required=false & int year

✔️ defaultValue: 필수입력이 없는 파라미터는 기본값을 넣어준다.

@RequestMapping("/requestParam8")
public String main8(@RequestParam(required = false, defaultValue = "2021") int year) { 
     System.out.printf("[%s]year=[%s]%n", new Date(), year);
     return "yoil";
}

• 필수값 아님. 그래서 서버 오류 필수가 아니기 때문에 이 값이 안 들어왔을 때의 대비가 되어있어야 한다.

• http://localhost/ch2/requestParam8
  ➡️ 500 java.lang.IllegalStateException : Optional int parameter 'year' is present but cannot be translated into a null value due to being declared as a primitive type. Consider declaring it as object wrapper for the corresponding primitive type.
  : 필수입력이 아님 ➡️ 서버 잘못
  : year 자체가 없어서 null 이 나오고 이 null 값은 int 로 변환 ❌

• http://localhost/ch2/requestParam8?year
  ➡️ 400 Bad Request, nested exception is java.lang.NumberFormatException: For input string: ""
  : 빈문자열 숫자 변환 ❌ ➡️ 클라이언트 잘못

• String 으로 바로 받는 것이 아닌 int 로 변환되는 거라서 에러가 다른 것

---

✏️ @RequestParam: required=true & int year

✔️ 필수입력일 때는 사용자가 잘못된 값을 넣을 수 있으므로 예외 처리를 해 준다.

@RequestMapping("/requestParam9")
    public String main9(@RequestParam(required = true) int year) {
        System.out.printf("[%s]year=[%s]%n", new Date(), year);
        return "yoil";
    }

• http://localhost/ch2/requestParam9
  ➡️ 400 Bad Request, Required int parameter 'year' is not present
  : 필수입력인데 안줬으니까 클라이언트 잘못

• http://localhost/ch2/requestParam9?year
  ➡️ 400 Bad Request, nested exception is java.lang.NumberFormatException : For input string: ""
  : 빈문자열 숫자 변환 ❌ ➡️ 클라이언트 잘못

• 예외 처리를 해서 사용자가 올바른 입력 값을 넣을 수 있게 해준다.

✏️ 예외 처리

✏️ YoilTellerMVC.java

package kr.ac.jipark09.ch2;

import java.io.IOException;
import java.io.PrintWriter;
import java.util.Calendar;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

// 년,월,일을 입력하면 요일을 알려주는 프로그램
@Controller
public class YoilTellerMVC {
	@RequestMapping("/getYoilMVC")
    // required = true 해줌
	public String main(
			@RequestParam(required = true) int year, 
			@RequestParam(required = true) int month,
			@RequestParam(required = true) int day,
			Model model
			) throws IOException {
		
		//1. 유효성 검사
		if(!isVaild(year, month, day)) {
			return "yoilError";
		}
		
		// 2. 요일 계산
		char yoil = getYoil(year, month, day);
		getYoil(year, month, day);
		
		// 3. 계산한 결과를 model에 저장
		model.addAttribute("year", year);
		model.addAttribute("month", month);
		model.addAttribute("day", day);
		model.addAttribute("yoil", yoil);
		
		return "yoil"; // yoil.jsp를 보여줘라
	}

	private boolean isVaild(int year, int month, int day) {
		return true;
	}

	private char getYoil(int year, int month, int day) {
		Calendar cal = Calendar.getInstance();
		cal.set(year, month - 1, day);
		
		int dayOfWeek = cal.get(Calendar.DAY_OF_WEEK);
		return " 일월화수목금토".charAt(dayOfWeek);
	}
}

• day를 넣지 않아서 400번 에러가 나왔다.
• 이런 화면이 나오게 하지 않기 위해 예외 처리를 해 준다.

✏️ catcher 예외 처리 메서드 만듬

✔️ @ExceptionHandler를 붙이면 파라미터의 예외를 처리할 수 있게 해준다.

@ExceptionHandler(Exception.class)
public String catcher(Exception e) {
	e.printStackTrace();
	return "yoilError";
}

---

year, month, day로 하나하나 넣어주는 것이 아닌, 이것들을 하나로 합친 객체로 만들어보자.

✏️ Date 객체를 만들어서 전달

✏️ YoilTellerMVC4.java

package kr.ac.jipark09.ch2;

import java.io.IOException;
import java.io.PrintWriter;
import java.util.Calendar;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

// year, month, day를 하나로 합쳐봄 => 객체로 만들기(dto)
@Controller
public class YoilTellerMVC4 {
	@ExceptionHandler(Exception.class)
	public String catcher(Exception e) {
		e.printStackTrace();
		return "yoilError";
	}
	
	@RequestMapping("/getYoilMVC4")
	public String main(MyDate date, Model model) throws IOException {
		
		//1. 유효성 검사
		if(!isVaild(date)) {
			return "yoilError";
		}
		
		// 2. 요일 계산
		char yoil = getYoil(date);
		
		// 3. 계산한 결과를 model에 저장
		model.addAttribute("date", date);
		model.addAttribute("yoil", yoil);
		
		return "yoil"; // yoil.jsp를 보여줘라
	}

	private boolean isVaild(MyDate date) {
		return isVaild(date.getYear(), date.getMonth(), date.getDay());
	}
	private boolean isVaild(int year, int month, int day) {
		if(year == 1 || month == 1 || day == 1) {
			return false;
		}
		return (1 <= month && month <= 12) && (1 <= day && day <= 31);
	}

	private char getYoil(MyDate date) {
		int year = date.getYear();
		int month = date.getMonth();
		int day = date.getDay();
		Calendar cal = Calendar.getInstance();
		cal.set(year, month - 1, day);
		
		int dayOfWeek = cal.get(Calendar.DAY_OF_WEEK);
		return " 일월화수목금토".charAt(dayOfWeek);
	}

}

✏️ yoil.jsp

<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<%@ page session="false" %>
<html>
<head>
	<title>Home</title>
</head>
<body>
<h1>year=<%=request.getParameter("year") %></h1>
<!-- EL -->
<p>${myDate.year }년 ${myDate.month }월 ${myDate.day }일은 ${yoil }입니다.</p>
</body>
</html>

❓ 입력되는 값이 year, month, day인데 MyDate로 잘 나오는 이유가 뭘까?

이러한 부분도 스프링이 알아서 찾아가주기 때문이다.
예제를 보며 살펴보자.

✏️ SetterCall

package com.fastcampus.ch2;

import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

import org.springframework.util.StringUtils;

public class SetterCall {
	public static void main(String[] args) throws Exception{
		Map<String, String> map = new HashMap<>();
		map.put("year", "2021");
		map.put("month", "10");
		map.put("day", "1");
		
		Class<?> type = Class.forName("com.fastcampus.ch2.MyDate");

		// MyDate인스턴스를 생성하고, map의 값으로 초기화한다. 
		Object obj = dataBind(map, type);
		System.out.println("obj="+obj); // obj=[year=2021, month=10, day=1]
	} // main

	private static Object dataBind(Map<String, String> map, Class<?> clazz) throws Exception {
		// 1. MyDate인스턴스 생성
//		Object obj = clazz.newInstance(); // deprecated method
		Object obj = clazz.getDeclaredConstructor().newInstance(new Object[0]);

		// 2. MyDate인스턴스의 setter를 호출해서, map의 값으로 MyDate를 초기화
		// 	 2-1. MyDate의 모든 iv를 돌면서 map에 있는지 찾는다.
		// 	 2-2. 찾으면, 찾은 값을 setter로 객체에 저장한다.
		Field[] ivArr = clazz.getDeclaredFields();
		
		for(int i=0;i<ivArr.length;i++) {
			String name = ivArr[i].getName();
			Class<?>  type = ivArr[i].getType();
			
			// map에 같은 이름의 key가 있으면 가져와서 setter호출 
			Object value = map.get(name); // 못찾으면 value의 값은 null
			Method method = null;
			
			try {   // map에 iv와 일치하는 키가 있을 때만, setter를 호출
				if(value==null) continue;
				
				method = clazz.getDeclaredMethod(getSetterName(name), type); // setter의 정보 얻기	
				System.out.println("method="+method);
				method.invoke(obj, convertTo(value, type)); // obj의 setter를 호출
			} catch(Exception e) {
				e.printStackTrace();
			}
		}
		
		System.out.println(Arrays.toString(ivArr));
		
		return obj;
	}

	private static Object convertTo(Object value, Class<?> type) {
		// value의 타입과 type의 타입이 같으면 그대로 반환
		if(value==null || type==null || type.isInstance(value))
			return value;
		
		// value의 타입과 type이 다르면, 변환해서 반환
		if(String.class.isInstance(value) && type==int.class) // String -> int
			return Integer.valueOf(""+value);

		return value;
	}

	// iv의 이름으로 setter의 이름을 만들어서 반환하는 메서드("day" -> "setDay")
	private static String getSetterName(String name) {
//		return "set"+name.substring(0,1).toUpperCase()+name.substring(1);
		return "set" + StringUtils.capitalize(name); // org.springframework.util.StringUtils
	}
}

[실행결과]
method=public void com.fastcampus.ch2.MyDate.setYear(int)
method=public void com.fastcampus.ch2.MyDate.setMonth(int)
method=public void com.fastcampus.ch2.MyDate.setDay(int)
[private int com.fastcampus.ch2.MyDate.year, private int com.fastcampus.ch2.MyDate.month, private int com.fastcampus.ch2.MyDate.day]
obj=[year=2021, month=10, day=1]

1. 요청한 값들이 HashMap으로 담긴다.

2. MyDate 라는 타입이 있을 때 bind() 메서드가 Map하고 연결해준다.

   1) 타입으로 넘어온 클래스 정보를 가지고 객체를 만든다.

   2) MyDate 인스턴스의 setter를 호출해서, Map의 값으로 MyDate를 초기화한다.

   2-1. myDate의 모든 iv(인스턴스 변수)를 돌면서 Map에 존재하는지 찾는다.

   2-2. 찾으면, 찾은 값을 setter로 객체에 저장한다.

   ➡️ setter가 없으면 스프링이 자동으로 처리해주지 못함. setter 필수!

---

Reference
: https://fastcampus.co.kr/dev_academy_nks