스프링 api 메세지 수신시 map dto 뭐가 좋을까요? 어떤상황에 map , dto 를 선택해서 사용해야 할까요?

각 방식의 장점과 단점을 생각해보시고 어떤 경우에 적합한지 판단하셔서 사용하시면 됩니다.

Map은 일단 클래스를 매번 선언하지 않아도 되니까 빠릅니다. 키가 뭐가 들어가는지도 미리 알 필요도 없죠. 그리고 이걸 그대로 화면에 출력하거나 다시 앞 단으로 전달하고 마는 경우라면 생산성이 좋아서 DB에서 조회성 결과를 가져오거나 할 때 유리합니다.

하지만 Map에 담긴 정보를 활용해야 하는 경우엔 헬이 시작되죠. Map의 value에는 타입이 한가지 밖에 안들어가니 보통 String으로 받겠죠. 그걸 로직을 적용해야 하는 코드에서 사용하는 타입으로 변환을 하게 되면 난리가 납니다. 키를 문자열로 넘기기 때문에 오타가 발생하기도 하고, 로직을 적용한 뒤에 다시 Map에 담는 것도 별로 효과적이지 못합니다.

단순 조회용으로 많은 양을 빠르게 찍어내고 프로젝트에서 도망갈 수 있는 상황이라면 Map을 쓰셔도 좋겠습니다만, 저는 그 외에는 DTO와 같은 클래스, 혹은 레코드(자바14+)를 사용하시는 걸 권장드립니다. Lombok 등을 사용하면 필드만 정의하면 되니까 개발도 시간이 걸리지 않습니다. 내가 다루는 데이터가 어떤 것들이고 어떤 타입으로 처리해야할지도 명확하게 하니까 로직을 적용할 때 버그가 줄어들겠죠.

api가 응답하는 데이터의 형식이 미리 알려지지 않은 경우가 있습니다. 이렇게 규약이 정해지지 않았지만 전달 받은 데이터를 활용해야 하는 경우엔 Map이 필요하겠지만 저는 그 외의 경우라면 DTO를 반드시 사용합니다.

그런데 Mapstruct는 어떤 이유로 쓰시는지 잘 모르겠네요. 가져온 자료를 또 다른 형식으로 가공하는게 필요한가보네요. 저는 이런 경우 성능이 아주 중요한 경우가 아니라면 ModelMapper를 사용하는 편인데, 언제부터인가는 수동으로 변환하는 코드를 직접 작성합니다. 생성자나 팩토리 메소드를 이용하죠. 이게 조금 번거롭긴하지만 명시적이라서 좋습니다. 코드에서 정확히 뭘 다루는지 보이니까요. Github copilot을 쓰면서부터는 그 변환 코드를 아주 영리하게 자동으로 만들어줘서 더 사용하기 좋네요.