SOAP, RESTful

알고 있어야 하는 것들

네트워트 비연결 지향 통신 #60
네트워크 데이터 통신은 (데이터만 주고 받을 수 있도록 설계된 모듈인) 웹 서비스를 사용하는 통신이다.
🖍 웹서비스는 아키텍처의 구조에 따라서 SOAP과 RESTful 방식으로 나뉜다. → 지금 이야기할 것
웹서비스는 데이터 타입에 따라 XML 과 JSON 방식으로 나뉨 #62

웹 서비스 아키텍처 구조에 따라1: SOAP(Simple Object Access Protocol)

HTTP, HTTPS, SMTP 등의 프로토콜을 통해서 양쪽에서 XML 형태의 메세지를 주고 받도록 구현된 프로토콜
웹 서비스에서 메세지를 전달할 때 원격 프로시저 호출 Remote Procedure Call(RPC) 이라고 불리는 클라이언트-서버 구조의 메세지 패턴을 많이 사용
- 통신 구조: Envelope/Header/Body의 세 영역으로 구분

Soap의 메세지 구조

XML을 근간으로 하여 Header 부분과 Body 부분을 조합하는 구조의 디자인 패턴으로 설계
Header: optional
- 반복이나 보안, 트랜젝션을 정보로 하는 메타 정보 처리
Body
- 전달하고자 하는 핵심 내용

예시(위 이미지 및 아래 코드 출처: Soap 메세지의 구조 - IBM Documentation

<?xml version='1.0' Encoding='UTF-8' ?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> 
<env:Header>
<m:reservation xmlns:m="http://travelcompany.example.org/reservation" 
    env:role="http://www.w3.org/2003/05/soap-envelope/role/next">
<m:reference>uuid:093a2da1-q345-739r-ba5d-pqff98fe8j7d</m:reference>
<m:dateAndTime>2007-11-29T13:20:00.000-05:00</m:dateAndTime>
</m:reservation>
<n:passenger xmlns:n="http://mycompany.example.com/employees" 
    env:role="http://www.w3.org/2003/05/soap-envelope/role/next">
<n:name>Fred Bloggs</n:name>
</n:passenger>
</env:Header>
<env:Body>
<p:itinerary xmlns:p="http://travelcompany.example.org/reservation/travel">
<p:departure>
 <p:departing>New York</p:departing>
 <p:arriving>Los Angeles</p:arriving>
 <p:departureDate>2007-12-14</p:departureDate>
 <p:departureTime>late afternoon</p:departureTime>
 <p:seatPreference>aisle</p:seatPreference>
</p:departure>
<p:return>
 <p:departing>Los Angeles</p:departing>
 <p:arriving>New York</p:arriving>
 <p:departureDate>2007-12-20</p:departureDate>
 <p:departureTime>mid-morning</p:departureTime>
 <p:seatPreference></p:seatPreference>
</p:return>
</p:itinerary>
</env:Body>
</env:Envelope>

SOAP 네트워크 통신의 장점

SOAP을 사용한 HTTP는 기존 원격 기술들과 달리, 프락시나 방화벽과 관계 없이 쉽게 통신 OK
SOAP가 사용하는 표준 전송 프로토콜: HTTP, 이외에도 사용할 수 있는 프로토콜 다양
플랫폼 독립적인 통신 → 시스템 바뀌거나 이기종 플랫폼 간의 데이터 통신 편리
프로그래밍 언어에 종속되지 X
간단, 확장 용이

SOAP 네트워크 통신의 단점

XML 포맷을 사용 → CORBA 등 미들웨어 기술과 비교했을 때 상대적으로 느림 → 전송하는 메세지의 양이 클 때에만 이슈가 되며, 일반적인 데이터 교환에서는 문제 X

🔖 출처

꼼꼼한 재은씨의 Swift: 기본편
Soap 메세지의 구조 - IBM Documentation

웹서비스 아키텍처 구조에 따라2: RESTful 방식

REST(Representational State Transfer)는 월드 와이드 웹(WWW)과 같은 분산 하이퍼 미디어 시스템을 위한 소프트웨어 아키텍처의 한 형식 ?
엄격한 기준에서 REST는 실직적인 네트워크 프로토콜은 X
→ 네트워크 자원을 정의하고, 자원에 대한 주소를 관리하는 방법
→ REST: 웹 형식으로 데이터를 전송하되, SOAP이나 쿠키 등의 별도의 전송 프로토콜 없이 전송하기 위해 만들어진 간단한 형식의 인터페이스(프로토콜)

REST의 데이터 구조

cf. SOAP: Envelope/Header/Body의 메세지 구조 가짐 → 이를 HTTP 프로토콜 위에 실어서 보내는 등 전송 규약을 지키기 위해 많은 작업이 필요
REST: HTTP 프로토콜을 바탕으로, 필요한 데이터를 별도의 규약 없이 주고받음
특정 웹페이지 접속하기 위해서 URL입력하는 것처럼, 데이터 요청하는 URI를 네트워크 통해 서버에 전달하면 끝(서버가 알맞은 데이터 보냄)
이러한 REST원리를 따라 구현된 시스템을 RESTful 이라고 함.
RESTful 시스템: 네트워크 서버 통해서 뿐만 아니라, 일반 웹 서버를 통해서도 약간의 설정만으로 쉽고 간단하게 구현 OK → 널리 확산 중

RESTful 시스템 동작

RESTful 시스템: 서버에 요청하려는 정보를 URI를 통해서 나타냄.
URI: 단위마다 슬래시/로 구분
ex. 127.0.0.1 아이피에 해당하는 서버에서 영화정보 얻고자 할 때 URI
```
http://127.0.0.1/movie
```
서버 측에서 제공하는 웹 서비스나 콘텐츠의 성격에 따라
- URI 구성, 데이터 형식 달라짐
데이터를 받기 위해서는, 서버에서 요구하는 요청 규격을 정확하게 맞추어야 한다.
→ 공통적인 표준 형식이 있는 것이 아니라, 서버와 클라이언트의 결정에 따라 달라짐
⇒ 이와 같이 데이터를 주고 받는 방식: RESTful API

RESTful API와 HTTP 전송 방식

일반적으로 서버에 요청하는 정보의 타입은 CRUD(Create쓰기, Read읽기, Update수정, Delete삭제)

ex. CRUD 기능을 가진 SNS에 관한 URI: sns/article 라면 다음과 같은 것들이 필요

http://127.0.0.1/sns/article/create
http://127.0.0.1/sns/article/read
http://127.0.0.1/sns/article/update
http://127.0.0.1/sns/article/delete

URI 구성 권고에 따르면 → RESTful API 구성을 위한 URI에는 정보의 분류 체계만 포함, 정보를 어떻게 다룰것인가(CRUD)하는 동작에 관한 명세는 포함하지 않는 것이 좋음.
- → URI: 어떤 계층의 어떤 데이터라는 정보 (O)
- → URI: 그 데이터를 쓸지, 읽을지, 수정, 삭제할 지에 대한 동작 (X)
⇒ HTTP 메소드 를 사용하여 CRUD 액션을 구분 권장
일반적으로 웹에서 사용되는 HTTP 메소드: GET, POST
- GET: 데이터 요청
  - 데이터 전송에도 사용할 수 있지만, URL뒤에 데이터를 줄줄이 붙여서 전송하는 형식이어서 URL 복잡해짐, 1024 바이트 이상의 정보 전송할 수 없다는 단점 → POST 사용
- POST: 데이터 전송
URI에 CRUD 동작 포함하는 대신, URI 헤더에 동작을 정의하는 것으로 처리할 액션 구분 가능
- 헤더: 주고 받아야 할 데이터 이외에, 시스템적인 필요에 의해 주고 받는 부가적인 정보가 작성되는 영역. 주고 받는 데이터가 작성되는 영역은 바디. 헤더와 바디는 프로토콜에 의해 명확한 형식으로 구분됨.
대부분 SOAP보다 RESTful API 형식으로 데이터를 제공하도록 설계되어 있음

HTTP 메소드의 종류

GET: 특정 리소스의 대표적인 정보 요청
POST: ID 없이 리소스 생성/수정
PUT: ID 기반으로 리소스 생성/수정
DELETE: 리소스 삭제
HEAD: GET방식의 요청, 내용 없이 메타 정보만 요청
OPTIONS: 특정 URL에 대한 보조 메소드 역할

🔖 출처

꼼꼼한 재은씨의 Swift: 기본편

yoogail105 / KkokkoSwift

# SOAP, RESTful #61

SOAP, RESTful

알고 있어야 하는 것들

웹 서비스 아키텍처 구조에 따라1: SOAP(Simple Object Access Protocol)

Soap의 메세지 구조

SOAP 네트워크 통신의 장점

SOAP 네트워크 통신의 단점

🔖 출처

웹서비스 아키텍처 구조에 따라2: RESTful 방식

REST의 데이터 구조

RESTful 시스템 동작

RESTful API와 HTTP 전송 방식

HTTP 메소드의 종류

🔖 출처