RESTful 개념과 소프트웨어 아키텍처 레이어

1. RESTful 개념

**REST (Representational State Transfer)**는 웹에서 자원을 효율적으로 주고받기 위한 아키텍처 스타일이다.
이를 따르는 설계 방식을 RESTful이라고 부른다.

RESTful의 핵심 특징은 다음과 같다:

1. 자원(Resource)의 명확한 식별

   • 웹에서 모든 자원은 고유한 URI로 표현된다.

   • 예: /students/1 → id가 1인 학생 자원

2. 표준 HTTP 메서드 활용

   • GET : 자원 조회

   • POST : 자원 생성

   • PUT : 자원 전체 수정

   • PATCH : 자원 부분 수정

   • DELETE : 자원 삭제

3. 무상태성(Stateless)

   • 서버는 요청 간 상태를 저장하지 않는다.

   • 각 요청은 독립적이며 필요한 정보를 모두 포함한다.

4. 표준화된 응답 포맷

   • 주로 JSON, 때로는 XML을 사용한다.

   • 일관된 응답 구조는 클라이언트 개발의 편의성을 높인다.

RESTful은 단순히 API 작성 규칙이 아니라, "웹 자원을 일관되게 표현하고 다루는 철학" 이다.

2. 소프트웨어 아키텍처 레이어

웹 애플리케이션은 보통 **3계층 구조(Layered Architecture)**를 따른다.
이 구조는 책임을 분리하여 유지보수성과 확장성을 높인다.

1. Controller (프레젠테이션 레이어)

   • 사용자의 요청을 받고, 적절한 응답을 돌려주는 역할

   • RESTful API 엔드포인트를 정의하는 곳

   • 예: GET /students 요청을 받아 서비스에 전달

2. Service (비즈니스 로직 레이어)

   • 실제 동작(로직)을 처리하는 계층

   • 데이터 검증, 규칙 적용, 알고리즘 수행 등을 담당

   • 예: 학생 성적 평균을 계산하는 기능

3. Repository (데이터 접근 레이어)

   • 데이터베이스와 직접 소통하는 계층

   • SQL 실행, 데이터 저장/조회/삭제 담당

   • 예: 학생 정보를 MySQL에서 가져오기

3. 레이어 간 관계

흐름은 다음과 같다:

사용자 요청 → Controller → Service → Repository → DB
↘ (결과 반환)

이 구조 덕분에:

• Controller는 단순히 입출력만 담당

• Service는 비즈니스 규칙만 집중

• Repository는 데이터 접근만 전담

책임이 명확히 나뉘어 있으므로, 코드가 깔끔해지고 유지보수가 쉬워진다.

정리:

• RESTful은 자원을 URI와 HTTP 메서드로 표현하는 웹 아키텍처 철학.

• 레이어드 아키텍처는 Controller–Service–Repository로 책임을 분리한 구조.

• 둘을 결합하면, RESTful API 설계가 명확해지고, 시스템이 견고해진다.