---

📦 HttpMessageConverter

---

기존 구조의 view resolver 가 화면을 보여주는 대신, http 메세지를 보여줌

📖 HttpMessageConverter의 구조

• 요청시 ⇢ ArgumentResolver 사용
  : @RequestBody, HttpEntity<>, RequestEntity<>

• 응답시 ⇢ ReturnValueHandler 사용
  : @ResponseBody, HttpEntity<>, ResponseEntity<>

  💡 구조상 양방향으로 (요청, 응답) 전부 작동한다

  
  

📌 우선순위

▶️ Byte ⇢ String ⇢ JSON

• 요청이나 응답을 변환할때 어떤 Media Type인지 확인
• 순서대로 검사해서 가능한 게 있으면 그걸로 처리하고 나머지는 무시함

📌 동작 흐름

요청

• 1️⃣ RequestBody나 파라미터로 바인딩
• 2️⃣ canRead()로 데이터 타입을 조회, Content-Type 헤더의 미디어타입 지원여부 확인
• 3️⃣ read()로 객체로 변환

응답

• 1️⃣ 컨트롤러가 @ResponseBody나 HttpEntity<> 리턴함
• 2️⃣ canWrite()로 데이터 타입을 조회, Accept 헤더의 미디어타입 지원여부 확인
• 3️⃣ write() 로 응답메세지 바디에 직접 데이터 입력

---

📥 ArgumentResolver (요청)

🌟 컨트롤러 메서드의 파라미터를 자동으로 바인딩해주는 인터페이스

• Spring MVC 구조에서 요청이 컨트롤러로 가기 전 RequestMappingHandlerAdapter가 호출함
• Controller가 필요한 파라미터 값을 생성함
• 값이 준비되면 실제 컨트롤러를 호출한다

📍 실제 클래스 이름 : HandlerMethodArgumentResolver

✔️ ArgumentResolver의 종류

---

📤 ReturnValueHandler (응답)

🌟 컨트롤러 메서드가 반환하는 값을 HTTP 응답으로 변환하는 인터페이스

• ModelAndView, @ResponseBody, HttpEntity<> 등
• 예를 들어, 컨트롤러에서 String 리턴해도 문자 그대로가 아니라 View 이름임을 인식함

📍 실제 클래스 이름 : HandlerMethodReturnValueHandler

✔️ ReturnValueHandler의 종류

• 인터페이스이므로 확장가능, 구현체 많음

---

💡 요청과 응답 모두에서 사용되는 클래스

▶️ArgumentResolver + ReturnValueHandler를 둘다 구현한 클래스

클래스명	처리 대상
RequestResponseBodyMethodProcessor	@RequestBody, @ResponseBody
HttpEntityMethodProcessor	HttpEntity<>, RequestEntity<>, ResponseEntity<>

→ 내부에서 HttpMessageConverter를 호출해 객체 생성 또는 응답 변환을 처리함

---

📦 Converter, Fomatter

---

⚙️ WebMvcConfigurer

설정을 통해 Converter, Formatter를 추가할 수 있다

• 커스텀 Converter, Formatter, HttpMessageConverter 등을 등록할 때 오버라이딩해서 사용
• 속에 @Configuration 도 있음 ⇢ @Component를 포함 ⇢ Spring Bean으로 등록

---

📖 Converter

객체의 타입을 서로 변환할때

• HttpServletRequest
  기본적으로 요청 파라미터는 문자열로 처리가 되기 때문에
  숫자로 변환하고 싶다면, 하나씩 직접변환해줘야한다

  @Slf4j
   @RestController
   public class TypeConverterController {
  
       @GetMapping("/param")
       public void param(HttpServletRequest request) {
  
           // 조회시 : String
           String stringExample = request.getParameter("example");
   
           // ✅Integer로 Type 변환
           Integer integerExample = Integer.valueOf(stringExample);
           log.info("integerExample = {}", integerExample);
  
       }
     }

• @RequestParam
  변환 안거쳐도 알아서 나온다~~ (바인딩될 타입을 정해놨음)
  요걸 누군가 알아서 타입을 자동으로 변환해준다! 이게 타입 컨버터??

  @GetMapping("/v2/param")
  public void paramV2(@RequestParam Integer example) {
  		// Integer 타입으로 바인딩
     log.info("example = {}", example);
  }

📌 Converter Interface

특정타입을 다른 타입으로 변환할때 사용하는 인터페이스

• 새로운 타입의 변환
  • localhost:8080/type-converter?person=wonuk:120
  • 입력받은 문자열 데이터를 Person 객체로 변환
    

  public class Person {
  		private String name;
  		private String age;
  }

  • wonuk:120 → TypeConverter → name: wonuk , age : 10 (개월수를 나이로)
  • 이럴때 컨버터 인터페이스 사용!
• 스프링이 제공하는 인터페이스이므로 implements해서 컨버터로 등록하면 된다
• 변환하고자 하는 타입에 맞춰서 Type Converter를 구현하고 등록하면 된다

📌 Converter 사용하기

⚠️ 주의 : 같은 이름을 가진 interface가 많으니 주의
org.springframework.core.convert.converter

• 1️⃣ Converter implements 하기
• 2️⃣ Converter를 열고
  • S : 변환할 소스
  • T : 변환할 타입

✔️ 예시

---

❶ String → Integer

@Slf4j
public class StringToIntegerConverter implements Converter<String, Integer> {
	
	@Override
	public Integer convert(String source) {
		log.info("source = {}", source);
		// 검증
		return Integer.valueOf(source);
	}
	
 }

❷ Integer → String

@Slf4j
public class IntegerToStringConverter implements Converter<Integer, String> {
	
	@Override
	public String convert(Integer source) {
		log.info("source = {}", source);
		return String.valueOf(source);
	}
}

❸ String → Person

(요청예시 : localhost:8080/type-converter?person=wonuk:1200)

@Getter
public class Person {
	
		// 이름
		private String name;
		// 나이
		private int age;
	
		public Person(String name, int age) {
			this.name = name;
			this.age = age;
		}
	
}

------------------

public class StringToPersonConverter implements Converter<String, Person> {
		// source = "wonuk:1200"
		@Override
		public Person convert(String source) {
			// ':' 를 구분자로 나누어 배열로 만든다.
			String[] parts = source.split(":");
	
			// 첫번째 배열은 이름이다. -> wonuk
	    String name = parts[0];
	    // 두번째 배열은 개월수이다. -> 1200
	    int months = Integer.parseInt(parts[1]);
	    
			// 개월수 나누기 12로 나이를 구하는 로직 (12개월 단위만 고려)
			int age = months / 12;
	
			return new Person(name, age);
		}
}

------------------

public class PersonToStringConverter implements Converter<Person, String> {
		
		@Override
		public String convert(Person source) {
				// 이름
				String name = source.getName();
				// 개월수
				int months = source.getAge * 12;
				// "wonuk:1200"
				return name + ":" + months;
		}
	
}
------------------

PersonToStringConverter converter = new PersonToStringConverter();
String source = "wonuk:1200";
converter.convert(source);

📌 Spring이 제공하는 Converter

1. Converter

   • 기본적인 변환을 담당하는 인터페이스
   • 단일 타입에서 단일 타입으로 변환할 때 사용한다.
     • Converter<Source, Type>

2. ConverterFactory

3. GenericConverter

4. ConditionalGenericConverter

1번만 외우고, 나머지는 필요할때 공식문서에서 찾던지~

---

🔄 ConversionService

컨버터를 모아서 편리하게 사용하게 해준다

• 인터페이스인데 컨버터를 사용할 수 있는지도 확인해주고, 사용도 해준다
• 우선 순위 = 내가 커스텀해 구현한 컨버터 >>>> 기본제공 컨버터

📌 DefalutConversionService

ConversionService를 구현한 구현체, ConvertRegistry에 다양한 Converter를 등록

📌 ConverterRegistry

Converter를 등록하고 관리

✔️ 예시

---

import static org.assertj.core.api.Assertions.*;// ✅ Assertions static 임포트 필요

public class ConversionServiceTest {

    @Test
    void defaultConversionService() {
        // given
        DefaultConversionService dcs = new DefaultConversionService();
        dcs.addConverter(new StringToPersonConverter());
        Person wonuk = new Person("wonuk", 100);
        
		// when
        Person stringToPerson = dcs.convert("wonuk:1200", Person.class);
        
		// then 
        assertThat(stringToPerson.getName()).isEqualTo(wonuk.getName());
        assertThat(stringToPerson.getAge()).isEqualTo(wonuk.getAge());
    }

}

위 코드를 통해 알수있는 것 ⇢> 컨버터 등록 / 사용은 분리 ! (ISP 원칙 적용)

📌 사용해보기

• 이미 내부적으로 ConversionService 가 있으니까

1️⃣ WebMvcConfigurer를 구현

2️⃣ addFomatters()로 컨버터를 등록만하고 사용

▶️ 결과

---

📖 Formatter

객체를 특정한 포맷에 맞춰서 문자로 출력하는데 특화 (Converter보다 더 세부기능 )

• printer, parser 상속 ( 객체를 문자로 변환 / 문자를 객체로 변환 )

Locale

• 지역 / 언어 정보를 나타내는 객체
  언어코드 en, ko / 국가코드 US, KR

📌 사용하기

---

1️⃣ Formatter 만들기

@Slf4j
public class PriceFormatter implements Formatter<Number> {
	
	@Override
  public Number parse(String text, Locale locale) throws ParseException {
    log.info("text = {}, locale={}", text, locale);
		
		// 변환 로직
		// NumberFormat이 제공하는 기능
		NumberFormat format = NumberFormat.getInstance(locale);
		// "10,000" -> 10000L
		return format.parse(text);
  }

  @Override
  public String print(Number object, Locale locale) {
			log.info("object = {}, locale = {}", object, locale);
			// 10000L -> "10,000"
      return NumberFormat.getInstance(locale).format(object);
  }
	
}

2️⃣ 변환하기

class PriceFormatterTest {

		PriceFormatter formatter = new PriceFormatter();

    @Test
    void parse() throws ParseException {
        // given, when
        Number result = formatter.parse("1,000", Locale.KOREA);

        // then
        // parse 결과는 Long
        Assertions.assertThat(result).isEqualTo(1000L);
    }

    @Test
    void print() {
        // given, when
        String result = formatter.print(1000, Locale.KOREA);

        // then
        Assertions.assertThat(result).isEqualTo("1,000");
    }
}

📌 Spring이 제공하는 Formatter

✔️ FormattingConversionService

ConversionService + Formatter 결합 구현체

어댑터 패턴으로 포매터가 컨버터처럼 동작하도록 만들어준다

✔️ DefaultFormatteingConversionService

FormattingConversionService + 통화, 숫자관련 Formatter를 추가한 것

public class FormattingConversionServiceTest {

    @Test
    void formattingConversionService() {

        // given
        DefaultFormattingConversionService conversionService = new DefaultFormattingConversionService();

        // Converter 등록
        conversionService.addConverter(new StringToPersonConverter());
        conversionService.addConverter(new PersonToStringConverter());
        // Formatter 등록
        conversionService.addFormatter(new PriceFormatter());

        // when
        String result = conversionService.convert(10000, String.class);

        // then
        Assertions.assertThat(result).isEqualTo("10,000");

    }

}

✔️ Annotation (DTO)

@NumberFormat - 숫자관련 지정 Formatter 사용
@DateTimeFormat - 날짜관련 지정 Formatter 사용 등등,,,

💡외울 필요 없음 공식문서에서 찾으셈