RESTClientFlow.png REST 클라이언트 라이브러리(이하 REST 클라이언트)는 REST 기반 웹서비스와 연동하기 위한 프레임워크입니다. 이 라이브러리는 델파이에서 지원하는 모든 플랫폼에서 사용할 수 있습니다.(XE5 부터 지원시작)

 

이 프레임워크는 공식적으로 JSON 기반의 데이터를 지원합니다.

 

주요 컴포넌트 및 클래스

REST 클라이언트는

  • 요청과 응답에 관련된 3개의 주요 컴포넌트와
  • 응답 데이터(JSON)를 데이터셋으로 변환하는 컴포넌트,
  • 인증과 관련된 4개의 컴포넌트를 제공합니다.

 

TRESTClient

서비스에 대한 요청을 실제로 수행하는 컴포넌트입니다. 서비스에 대한 HTTP 연결을 관리하고, HTTP 해더 및 프록시 서버를 처리하고 응답 데이터를 받습니다. 인증 컴포넌트를 지정해 요청에 대한 인증 데이터를 손쉽게 추가할 수 있습니다.

 

주요 속성

  • BaseURL : 서비스 URL 중 변경되지 않는 정보를 입력합니다.(프로토콜, 도메인/호스트, 포트 등)
  • Authenticator : 인증 컴포넌트를 지정해 인증 정보를 추가할 수 할 수 있습니다.
  • UserAgent : 사용자 에이전트

 

TRESTRequest - 요청

서비스에 대한 실제 HTTP 요청에 대한 정보를 설정합니다. 여러가지의 요청을 위해 여러개의 컴포넌트로 구성할 수 있습니다. Client 속성에 지정된 TRESTClient의 BaseURL과 TRESTRequest의 Resouce, Method 속성을 조합해 요청을 합니다. Resource에 중괄호를 이용해 파라미터화 할 수 있습니다.

 

주요 속성

  • Resource : 요청할 서비스의 리소스의 경로, 중괄호({})로 파라미터화 가능
  • Method : 요청의 HTTP 메소드(GET, POST, PUT, DELETE, PATCH)
  • Params : 리소스의 파라미터를 지정할 수 있는 목록
  • Client : TRESTClient 지정
  • Response : 응답 컴포넌트 지정
  • Accept / AcceptCharset / AcceptEncoding : 응답에 사용할 수 있는 내용의 종류 / 캐릭터셋 / 인코딩 타입을 지정

 

TRESTResponse - 응답

서비스에서 반환된 데이터를 보관합니다. 이 데이터에는 HTTP 상태 코드와 오류메시지(있는 경우)를 포함합니다. 

 

주요 속성

  • Content : 응답받은 데이터를 보관
  • ContentLength : 응답받은 데이터의 길이
  • ContentType : 응답받은 데이터의 타입
  • RootElement : 응답받은 JSON 데이터 중 사용할 항목 지정 가능

 

TRESTResponseDataSetAdapter

서비스의 응답 데이터가 JSON 형식인 경우, 응답 데이터를 분석하고 그 데이터를 TDataSet(TFDMemTable 등)에 전송합니다.

내부의 파서는 JSON 객체와 JSON 객체의 배열을 찾습니다. 파서는 RootElement에 설정된 JSON 객체 또는 배열의 키로 필드를 만들고 값으로 레코드를 생성합니다. 객체의 경우 레코드 1개가 배열의 경우 배열의 길이만큼 레코드가 생성됩니다.

 

주요 속성

  • RootElement : 변환할 데이터 중 사용할 항목을 지정합니다.
  • Response : 변환할 데이터를 보관한 TRESTResponse 지정
  • Dataset : 분석한 데이터를 보관(전송)할 데이터셋 지정

 

인증 컴포넌트

대부분의 서비스는 사용 전 인증이 필요합니다. REST 클라이언트는 서비스에서 요구하는 인증방법을 컴포넌트 기반으로 설정 해 TRESTClient의 Authenticate 속성에 지정할 수 있습니다.

다음 인증 컴포넌트를 제공합니다.

  • TSimpleAuthenticator : 사용자 이름과 패스워드 등의 입력 필드를 가진 HTML 폼과 같은 기본적인 인증방식 구현
  • THTTPBasicAuthenticator : HTTP 기본 인증 처리
  • TOAuth1Authenticator, TOAuth2Authenticator : OAuth1/2 인증 컴포넌트, 서비스 공급사의 웹페이지로 로그인 후 토큰을 발급받아 인증하는 방식
  • 커스텀 인증 클래스 생성 : TCustomAuthenticator를 상속받아 DoAuthenticate 메소드를 재정의

 

기타 참고자료

데브기어 기술자료

엠바카데로 기술자료

 
번호 제목 글쓴이 날짜 조회 수
공지 [DelphiCon 요약] 코드사이트 로깅 실전 활용 기법 (Real-world CodeSite Logging Techniques) 관리자 2021.01.19 24033
공지 [UX Summit 요약] 오른쪽 클릭은 옳다 (Right Click is Right) 관리자 2020.11.16 22339
공지 [10.4 시드니] What's NEW! 신기능 자세히 보기 관리자 2020.05.27 24376
공지 RAD스튜디오(델파이,C++빌더) - 고객 사례 목록 관리자 2018.10.23 30252
공지 [데브기어 컨설팅] 모바일 앱 & 업그레이드 마이그레이션 [1] 관리자 2017.02.06 31380
공지 [전체 목록] 이 달의 기술자료 & 기술레터 관리자 2017.02.06 26699
공지 RAD스튜디오(델파이, C++빌더) - 시작하기 [1] 관리자 2015.06.30 47714
공지 RAD스튜디오(델파이,C++빌더) - 모바일 앱 개발 사례 (2020년 11월 업데이트 됨) 험프리 2014.01.16 184662
54 모바일 앱 개발 시 툴 선택 file Humphery 2014.04.29 2827
53 20140424_Developer Direct LIVE! 2014 세미나 세션 자료입니다. 관리자 2014.04.25 1808
52 안드로이드 ARM 에뮬레이터 속도를 올리는 8가지 팁 Humphery 2014.04.25 5075
51 RAD Studio XE6 Webinar 그리고 Developer Direct LIVE! 2014 in Seoul(4/24) Humphery 2014.04.09 3735
50 짐 맥키트(Jim McKeeth) - 열손가락과 델파이를 연결하다.(Leap Motion 연동) Humphery 2014.04.04 5199
49 이 달의 기술자료 - 2014년 4월 file 험프리 2014.04.03 16887
48 짐 맥키트(Jim McKeeth) - 델파이가 여러분의 3D모션을 감지합니다.(Kinect 연동) Humphery 2014.04.01 3569
47 짐 맥키트(Jim McKeeth) - 델파이 하늘을 날다(AR.Drone 2.0 연동) Humphery 2014.03.28 4836
46 짐 맥키트(Jim McKeeth) - 당신의 뇌를 델파이에 연결하기(Emotiv EPOC) Humphery 2014.03.25 5355
45 사물인터넷(IoT)과 RAD Studio - 다양한 디바이스 연동 Humphery 2014.03.22 4472
44 부산가톨릭대학교 특강 발표자료 Humphery 2014.03.13 2009
43 "가장 빠른 모바일 앱 개발! 가장 쉬운 멀티플랫폼 개발!" 세미나 발표자료입니다. 관리자 2014.03.12 2244
42 [소식] Nokia X에서 델파이로 만든 앱도 등록가능합니다. [1] file Humphery 2014.03.11 4436
41 '2014 모바일 개발 트렌드' 발표자료입니다. 관리자 2014.03.11 2470
40 RAD Studio, Delphi 그리고 C++빌더 로드맵 - 한글(2014년 3월) file Humphery 2014.03.05 5629
39 이 달의 기술자료 - 2014년 3월 험프리 2014.03.05 9645
38 RAD Studio(델파이, C++빌더) 버전별 공식 지원 플랫폼과 OS 버전 험프리 2014.03.05 11703
37 이전버전에서 최신버전으로 마이그레이션(업그레이드) 참고문서 Humphery 2014.02.28 3165
36 델파이 이전버전을 설치하는 방법 Humphery 2014.02.14 4958
» [REST] REST 클라이언트로 REST 기반 웹서비스와 연동할 수 있습니다. [3] file 험프리 2014.01.29 11064