8.6. REST API 서버 기초

REST(Representational State Transfer)는 웹 서비스 아키텍처의 일종으로, 클라이언트와 서버 간의 통신을 간편하게 해줍니다. RESTful API는 HTTP 프로토콜을 기반으로 하여 웹 리소스에 접근하고 조작하는 방식으로 설계됩니다. 이 장에서는 REST API의 기본 개념과 이를 구현하기 위한 Java 기반의 방법론을 설명합니다.

REST API의 기본 원칙

1. Stateless: 클라이언트의 상태 정보를 서버에 저장하지 않음. 모든 요청은 독립적이어야 함.
2. Uniform Interface: API의 인터페이스는 항상 동일한 형태이어야 함. 즉, URL, HTTP 메소드, 상태 코드 등을 표준화하여 사용.
3. Resource-Based: 리소스가 URI로 식별되고, 데이터는 JSON 포맷으로 전달됨.

JSON 데이터 처리

REST API에서 주로 사용하는 데이터 포맷은 JSON입니다. 이는 가볍고, 사람과 기계 모두 읽기 쉽기 때문입니다. 다음은 Java에서 JSON을 다루기 위한 예제입니다.

import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.HashMap;
import java.util.Map;

public class JsonExample {
    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();
        Map<String, String> data = new HashMap<>();
        data.put("name", "John Doe");
        data.put("email", "john.doe@example.com");

        // Map을 JSON 문자열로 변환
        String json = objectMapper.writeValueAsString(data);
        System.out.println(json);
    }
}

실습

위 코드를 IntelliJ IDEA에서 실행하여 JSON 문자열을 확인하세요. JSON 포맷에 대한 이해가 중요하며, 클라이언트와 서버 간 데이터 전송 시 어떤 형식으로 데이터를 주고받는지 파악하는 것이 중요합니다.

프로젝트

간단한 REST API 서버를 Spring Boot를 사용하여 구축합니다. 이 서버는 학생 관리, 회원 관리, 게시판 기능을 제공하며, 각 기능은 RESTful 구성을 따릅니다. 아래는 간단한 구조를 제시합니다.

1. 학생 관리 API: 학생 정보를 CRUD(Create, Read, Update, Delete)하는 API
2. 회원 관리 API: 사용자 등록 및 인증을 제공하는 API
3. 게시판 API: 게시글 작성, 조회, 수정 및 삭제를 관리하는 API

각 API는 JSON을 이용하여 데이터를 주고받으며, 클라이언트는 HTTP 요청을 통해 서버와 통신합니다.

정리

REST API는 현대 웹 애플리케이션에서 필수적인 요소입니다. 본 강의에서는 REST API의 기본 개념과 Java를 사용하여 어떻게 구현할 수 있는지에 대해 학습했습니다. 이후 학습에서는 Spring Boot와 함께 이를 실장해보며 더 깊이 있는 경험을 쌓아갈 예정입니다.