Spring 기초 Part 2: Spring MVC 요청 처리 흐름

Spring 기초 Part 2: Spring MVC 요청 처리 흐름

Spring MVC는 HTTP 요청을 적절한 Controller에 연결하고, 처리 결과를 View 또는 JSON으로 반환하는 웹 프레임워크다.

처음에는 다음 흐름부터 기억하면 된다.

Client
  → DispatcherServlet
  → Controller
  → Service
  → Repository
  → Database

응답은 반대 방향으로 돌아온다.

Database
  → Repository
  → Service
  → Controller
  → JSON 또는 HTML
  → Client

1. 먼저 알아둘 단어

2. MVC와 계층형 구조는 같은 말이 아니다

기본 MVC는 역할을 다음처럼 구분한다.

실무의 Spring 애플리케이션에서는 유지보수를 위해 역할을 더 세분화한다.

즉 Spring MVC와 계층형 구조를 함께 사용하는 것이다.

Spring MVC
→ HTTP 요청을 Controller에 연결하고 응답을 만드는 구조

계층형 구조
→ Controller, Service, Repository의 책임을 나누는 구조

3. DispatcherServlet

Client의 요청이 Controller로 바로 전달되는 것은 아니다.

Client
  → DispatcherServlet
  → Controller

DispatcherServlet은 모든 요청을 먼저 받고 적절한 Controller로 전달한다. 이런 구조를 Front Controller Pattern이라고 한다.

                       ┌→ UserController
Client → DispatcherServlet → ProductController
                       └→ OrderController

각 Controller가 공통 처리를 직접 반복하지 않아도 DispatcherServlet을 중심으로 일관된 요청 처리가 가능하다.

4. HandlerMapping과 HandlerAdapter

다음 Controller가 있다고 해보자.

@RestController
@RequestMapping("/api/users")
public class UserController {

    @GetMapping("/{id}")
    public UserResponse getUser(@PathVariable Long id) {
        // 사용자 조회
    }
}

Client가 다음 요청을 보낸다.

GET /api/users/1

Spring은 애플리케이션을 시작할 때 어노테이션 정보를 읽고 URL과 메서드의 연결 정보를 준비한다.

GET /api/users/{id}
        ↓
UserController.getUser()

실행 시 각 객체의 역할은 다음과 같다.

1. DispatcherServlet이 요청을 받는다.
2. HandlerMapping이 요청을 처리할 Controller 메서드를 찾는다.
3. HandlerAdapter가 필요한 매개변수를 준비한다.
4. HandlerAdapter가 Controller 메서드를 호출한다.
5. 반환 결과를 DispatcherServlet이 응답으로 처리한다.

Spring MVC REST API 요청 흐름

flowchart LR
    C[Client] -->|HTTP Request| D[DispatcherServlet]
    D -->|처리 대상 검색| HM[HandlerMapping]
    HM -->|Controller 정보| D
    D -->|실행 요청| HA[HandlerAdapter]
    HA --> CT[Controller]
    CT --> S[Service]
    S --> R[Repository]
    R --> DB[(Database)]
    DB --> R
    R --> S
    S --> CT
    CT -->|Java Object| HA
    HA --> D
    D -->|JSON Response| C

5. Controller, Service, Repository

Controller

Controller는 HTTP 요청과 응답에 집중한다.

@RestController
@RequestMapping("/api/users")
public class UserController {

    private final UserService userService;

    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping("/{id}")
    public ResponseEntity<UserResponse> getUser(@PathVariable Long id) {
        UserResponse response = userService.getUser(id);
        return ResponseEntity.ok(response);
    }
}

Controller에는 복잡한 업무 규칙을 넣지 않는다.

Service

Service는 실제 업무 규칙을 처리한다.

@Service
public class UserService {

    private final UserRepository userRepository;

    public UserService(UserRepository userRepository) {
        this.userRepository = userRepository;
    }

    public UserResponse getUser(Long id) {
        User user = userRepository.findById(id).orElseThrow();
        return UserResponse.from(user);
    }
}

Repository

Repository는 데이터베이스 접근을 담당한다.

public interface UserRepository extends JpaRepository<User, Long> {
}

역할을 나누면 HTTP 처리, 업무 규칙, DB 접근을 각각 독립적으로 수정하고 테스트하기 쉬워진다.

6. @Controller와 @RestController

@Controller

일반적인 @Controller가 문자열을 반환하면 View 이름으로 해석할 수 있다.

@Controller
public class HomeController {

    @GetMapping("/")
    public String home() {
        return "home";
    }
}

return "home"
   → ViewResolver
   → home.html 검색
   → HTML 응답

@RestController

@RestController의 반환값은 기본적으로 HTTP 응답 본문으로 전달된다.

@RestController
public class HelloController {

    @GetMapping("/api/hello")
    public MessageResponse hello() {
        return new MessageResponse("hello");
    }
}

Jackson이 자바 객체를 JSON으로 변환한다.

{
  "message": "hello"
}

7. 전체 실행 흐름

GET /api/users/1 요청을 다시 연결하면 다음과 같다.

1. Client가 GET /api/users/1 요청
2. DispatcherServlet이 요청 수신
3. HandlerMapping이 UserController.getUser() 검색
4. HandlerAdapter가 id 값을 준비하고 메서드 호출
5. Controller가 UserService 호출
6. Service가 UserRepository 호출
7. Repository가 DB 조회
8. 조회 결과가 Repository → Service → Controller로 반환
9. Jackson이 UserResponse를 JSON으로 변환
10. Client에 HTTP 응답 반환

핵심 정리

Spring MVC의 핵심은 요청을 Controller에 연결하는 흐름과 Controller, Service, Repository의 책임을 분리하는 데 있다.

참고 자료

• Spring Framework Web MVC 공식 문서