[JPA로 REST API 만들기] 서버 애플리케이션 구조 - MVC 패턴과 RESTful API 란?

MVC 패턴이란?

Layered Architecture 에 기안한 디자인 패턴이다. user interface 에서 business layer 와 presentation layer 를 분할하여 비즈니스 로직은 재사용 가능하게 하고 interface 도 쉽게 수정하게 하는 것이 목적이다. MVC 패턴의 구성요소는 뷰, 모델, 컨트롤러가 있다.

 

View

컨트롤러가 반환한 데이터를 이용해 사용자에게 출력할 화면이나 인터페이스를 그린다. 여기서는 Todo list 의 화면을 그리는 부분이다.

 

Model

컨트롤러가 요청한 비즈니스 로직을 처리한다. 비즈니스 로직은 데이터를 처리하는 주요 업무를 말한다. 즉, DB에 접속해 데이터를 입출력하고, 용도에 맞게 가공하거나 하는 로직을 수행한다. 만약 데이터에 상태 변화가 있다면 뷰와 컨트롤러에게 알리는 역할도 한다. Service, Entity, Repository 등으로 구현되곤 한다. 또 모델 계층은 비즈니스 로직을 처리할 때 필요한 비즈니스 모델을 가지고 있다. 비즈니스 모델은 데이터를 말한다. 여기서는 Todo list 의 todo item 이다.

• Entity : 비즈니스 모델 객체.
• Repository : DB 조작을 담당함
• Service : 실제 비즈니스 로직을 처리함

 

Controller

사용자의 요청을 각각 모델로 라우팅하고 뷰 쪽에 반영하여 그 결과(화면 등)를 응답한다. 라우팅이란 요청을 적합한 모델 쪽으로 보내 처리하게 하는 것이다.

 

여기서는 View 를 프론트엔드 서버로 분할했기 때문에 구현하지 않고 컨트롤러에서 data 를 사용자에게 반환한다.

 

서버 애플리케이션 구조

위에서 설명한 MVC 패턴에 기반하여 Client <-> Controller <-> Service <-> Repository <-> DB 구조로 설정하였다. Client 의 http 요청이 Contoller 에 들어오면 컨트롤러가 필요한 서비스를 호출해 비즈니스 로직을 실행한다. 서비스에서는 필요한 데이터가 있다면 Repository 를 통해 DB 에 접속해 데이터를 CRUD 한다.

 

RESTful API 란?

REST 아키텍처를 준수하는 API 를 말한다. 간단히 말하면, HTTP method 로 데이터 입출력을 수행한다.

• GET - Read
• POST - Create
• PUT - All fields Update
• PATCH - Some fields Update
• DELETE - Delete

REST 아키텍처 준수사항은 많지만, 명명규칙만 정리해보면

• uri 에 resource name 과 id 를 명시한다.
• 그 외 파일 확장자, 행위에 대한 동사 등은 명시하지 않는다.
• / 는 계층관계를 나타낸다. 연관 관계는 맨 뒤에 표시한다.

 

todo RESTful API 구현

Description	HTTP method	Route
todo list 를 가져온다	GET	/todos
todo 를 가져온다	GET	/todo/:id
todo 를 생성한다	POST	/todo
todo 를 수정한다	PUT or PATCH	/todo/:id
todo 를 삭제한다	DELETE	/todo/:id