📌Spring에서 API, @RequestBody, HTTP Body 완벽 이해하기

📅 2025.04.24

---

📝 학습 내용

1️⃣ API란 무엇인가?

➥ 시스템 간 소통을 위한 인터페이스

✅ 개념 정의

API (Application Programming Interface)

API는 소프트웨어와 소프트웨어가 기능이나 데이터를 주고받기 위해 정해놓은 규칙(인터페이스)입니다.

서로 다른 시스템이 효율적이고 안전하게 소통할 수 있도록 돕습니다.

✅ 주요 특징

• 표준화된 소통 방식 제공
• 기능 재사용 및 확장성
• 내부 로직 보호(보안성)

✅ 대표 사례

• REST API (웹 통신 표준)
• 카카오 지도 API
• 결제 API (PayPal, Stripe 등)
• 구글/네이버 로그인 API

---

2️⃣ HTTP 요청에서 Body란?

➥ 서버로 데이터를 전달하는 공간

✅ HTTP 요청 구조

1. 요청라인 (Request Line)
2. 헤더 (Headers)
3. 바디 (Body)   ⬅ 데이터가 담기는 영역

✅ Body의 역할

• 클라이언트가 서버로 JSON, XML, 텍스트, 파일 등의 데이터를 전송.
• 주로 POST, PUT 요청 시 사용.
• GET 요청은 보통 Body가 없음.

✅ 예시 (JSON 전송)

POST /api/user HTTP/1.1
Content-Type: application/json

{
   "username": "jaewoong",
   "email": "jae@example.com"
}

• 위 JSON 데이터가 HTTP Body에 해당.

---

3️⃣ @RequestBody(required = false)의 의미

➥ HTTP Body 데이터를 자바로 매핑하는 방법

✅ 기본 동작

• @RequestBody는 HTTP 요청의 Body를 자바 객체나 String으로 변환.
• 기본값: required = true → Body가 없으면 400 Bad Request 오류 발생.
  

✅ required = false 설정 이유

• Body가 없어도 요청 허용 (유연한 API 설계 가능).
• Body가 없으면 null로 처리됨.

✅ 코드 예시 (주석 포함)

@PostMapping("/example")  // POST 요청을 처리하는 엔드포인트
public ResponseEntity<String> example(@RequestBody(required = false) String jsonData) {
    if (jsonData == null) {
        return ResponseEntity.ok("No data provided");  // Body가 없을 때 응답
    }
    return ResponseEntity.ok("Received data: " + jsonData);  // Body가 있을 때 응답
}

🔹 출력 결과

• Body 없음 → "No data provided"
• Body 있음 → "Received data: {jsonData}"

---

🔥 정리

API와 HTTP Body, 그리고 @RequestBody를 이해하면 유연하고 효율적인 RESTful 서비스를 설계할 수 있다.

항목	설명
API	시스템 간 데이터 및 기능을 주고받는 인터페이스
HTTP Body	요청 시 서버로 데이터를 전달하는 영역
@RequestBody	HTTP Body를 자바 객체로 변환해주는 Spring 어노테이션
required=false	Body가 없어도 요청을 허용, 널처리로 유연한 대응 가능

---

🔗 참고 자료

• MDN Web Docs - HTTP 개요
• Spring 공식 문서 - @RequestBody
• REST API란 무엇인가?
• Postman 공식 사이트 (API 테스트 툴)

---