Stephen Ball 블로그 글 중에 REST API를 클라이언트 개발에 큰 도움이 될만한 글이라 생각되어 번역해보았습니다.

REST API 클라이언트 구현 중 마스터-디테일 관계 구현에 도움이 될것입니다.

이 글은 ‘REST 서버와 클라이언트 개발하기’의 세번째 편이다. 여기에서는TRESTResponseDataSetAdapter를 주로 사용한다.

 

앞선 두편의 글에서, REST서버를 만들고 YAML을 이용하여 API 전체 도움말을 제공해보았다. 당시  우리는 데이터 집합 3개를 제공했었다. 그리고 나서, 코드를 직접 쓰지 않고도 마스터-디테일 관계를 가진 데이터 집합(들)을 REST 상에 오픈했다. 앞선 글과 비디오를 보지 못했다면, 1편부터 시작하기를 권장한다.- 이 세번째 편에서는 델파이로 멀티 플랫폼 클라이언트를 만들어서 앞에서 만든 API를 사용해보기로 하자.

 

클라이언트를 만드는 순서

이 글과 비디오는 아래 순서로 진행된다.

  1, REST API에 연결할 컴포넌트(들) 설정 (RAD 방식으로 빠르게 구현)

  2, JSON을 읽어서 마스터-디테일 데이터셋(들)로 변환 (JSON 데이터의 계층 구조를 기준으로)

  3, 생성된 데이터셋을 라이브바인딩(LiveBindings)을 이용하여 코드 작성없이 화면에 표현

  4, API 호출을 줄이는 팁

 

클라이언트에서 REST 리소스에 연결하기

델파이/C++빌더에서 REST 리소스에 빠르게 연결하도록 하는 컴포넌트 셋트는 윈도우용 VCL 애플리케이션과 멀티-플랫폼용 FMX에서 모두 사용할 수 있다. 해당 유닛(들)은 모두 REST 네임스페이스 안에 있으며, 윈도우, 맥OS, 안드로이드, iOS 각각에 알맞은 네이티브 코드를 만들어낸다. 

 

이미 ‘TRESTClient를 사용하여 MailChimp와 Azure Translation Services에 연결하기’ 편에서 이 컴포넌트 세트에 대한 기초를 다루었으므로, 지금은 바로 REST Debugger를 활용하여 바로 시작해보자. REST Debugger는 매우 유용하며, 다양한 목적으로 사용할 수 있는 도구이다. 

 

REST Debugger는 (RADStudio /bin 디렉토리에 들어있는) 애플리케이션이다. REST 엔드 포인트에 빠르게 연결할 때 사용된다. 사용자 보안 정보, 엔드 포인트, 리소스, 파라미터 등을 화면에서 손쉽게 지정하고 나서 “copy components” 버튼을 클릭하고나서, 개발 화면에서 붙여넣기를 하면, REST 데이터를 가져오는데 필요한 모든 컴포넌트(들)이 앞서 설정한 모든 정보가 반영된  상태로 추가된다. (REST Debugger를 개발 환경 도구 메뉴에 추가하는 방법 보기

 

아래와 같이 REST Debugger를 실행하고, 필요한 설정을 한 후, 원하는 엔드 포인트에 잘 연결되는지를 확인하고나서 해당 컴포넌트(들)을 애플리케이션으로 가져오면 된다.

RestDebugger.gif

 

 

비디오 보기 - Rest Debugger 사용하기

 

클라이언트에서 JSON을 TDataSet으로 변환

TRESTResponse 컴포넌트에 있는 JSON 배열 데이터를 TDataSet으로 변환할 때에는TRESTResponseDataSetAdapter가 유용하다.
TRestResponseDataSetAdapater.png

 

 

 

TRESTResponseDataSetAdapter는 TRESTRequest 통해 가져온 JSON 내용을 FieldDefs에 맞게 변환하여 TDataSet에 넣어준다. 

 

RAD 스튜디오 개발 환경에서 TRESTRequest를 (마우스 오른쪽을 클릭하여) Execute를 실행하면, 반환되는 데이터 내용을 바탕으로 TDataSet에 자동으로 FieldDefs(들)이 완성된다. 255자가 넘는 문자열이 필요하다면 StringFieldSize 프로퍼티를 수정하면 된다. (또는 원하는 문자열에 해당되는 FieldDefs를 수정하면 된다.)

 

RESTResponseDataSetAdapter를 사용해 JSON 데이터 배열의 상세 데이터 다루기

TRESTRequest는 하나를 TRESTResponseDataSetAdapters 여러개에서 사용할 수 있는데 상당히 편리하다. 지금 처럼 JSON 배열 안에 또 다른 배열 데이터가 들어있는 경우에도 API 호출을 한번만에 전달할 수 있다.

JSON-data-with-embedded-Array.png

 

샘플 REST 서버에 있는 예시(http://localhost:8080/exams/1/questionsfull/)

 

REST 서버의 /exams/{exam_id}/questionsfull/ 리소스는 QUESTIONS 배열을 제공하는데, 각 QUESTIONS 배열에는 해당 QUESTIONS에서 제시될 문항들이 ANSWERS 배열로 들어있다. 

 

위의 예를 반복하면 QUESTIONS을 데이터 집합으로 익스포트할 수 있다. (하지만, 다루기 쉬운 형태로 결과가 나오지는 않는다. 따라서). 

 

TRESTResponseDataSetAdapter를 하나 더 사용하여 RootElement에 특정 JSON 배열 필드를 지정하자. (예를 들어 특정 QUESTIONS에 해당하는 ANSWERS 배열들만 디테일 TDataSet에 넣도록 하자).

MasterDetail_TRESTRequestDataSetAdapter1.gif

예> RootElement 가져오기

 

RESTDebugger는 필요한 컴포넌트를 구성 (또는 RootElement 관련 구문을 확인) 할 때에도 역시 도움이 된다. TRESTResponseDataSetAdapter과 TDataSet를 수동으로 새로 추가할 수도 있다. 아니면 위와 같이 복사하여 붙여넣고 나서 중복해서 생긴 TRESTClient and TRESTRequest만 삭제하면 된다. JSON의 RootElement는 JSON 내용의 인덱스와 해당 프로퍼티의 이름을 기반으로 한다. 예를들어 [0].ANSWERS는 (우리가 지금 가져오려는 값인) JSON 배열의 첫번째 요소에 있는 ANSWERS 필드를 가져와서 TDataSet으로 변환한다.

 

런타임 시, TRESTRequestDataSetAdapter의 RootElement 사용하기

해당 TDataSet(들)은 지정된 TRESTResponse와 RootElement에 의해 자동으로 채워진다. 하지만, 지정된 RootElement가 Questions 데이터셋의 현재 레코드에 맞춰주어야 한다.  TDataSet의 AfterScroll 이벤트에서 쉽게 처리할 수 있다. (지금은 데이터 로드는 신경쓰지 말자. 관련 메소드를 만들고 사용하는 것은 잠시 후에 보기로 하자).

procedure TdataExams.table_QUESTIONSAfterScroll(DataSet: TDataSet);
begin
  if (DataSet.FieldByName('QUESTION_ID').AsString 
    = '') or Loading then Exit;

  rdsaANSWERS.RootElement :=
    '['+Pred(DataSet.RecNo).ToString+'].ANSWERS';
end;

이제 스크롤 될 때, 마스터 디테일 데이터가 데이터셋에 로드된다. 하지만, 질문이 해당 시험과 확실히 잘 연결되도록 해야한다. 

 

Exams 데이터셋에서 역시 같은 이벤트를 사용하면, Questions API에 전달할 파라미터를 (해당되는 EXAM에 맞게) 업데이트하고  TRESTRequest.Execute 메소드를 상용하여 데이터를 가져올 수 있다.

procedure TdataExams.tblEXAMSAfterScroll(DataSet: TDataSet);
begin
  if  Loading or  (DataSet.FieldByName('EXAM_ID').AsString = '') then
    Exit;

  RESTRequestQUESTIONSFULL.Params.
  ParameterByName('EXAM_ID').Value := 
    DataSet.FieldByName('EXAM_ID').AsString;
  BeginLoad;
  try
    // reset the RootElement before execute
    rdsaANSWERS.RootElement := '[0].ANSWERS';
    RESTRequestQUESTIONSFULL.Execute;
  finally
    EndLoad(rdsaQUESTIONS.Dataset);
  end;
end;

Loading, BeginLoad, EndLoad

해당 데이터용 코드 전체가 해당 데이터모듈 안에 들어 있도록 하기 위해 LoadExams 메소드를 추가한다. 여기에는 다음과 같은 메소드(들)이 포함된다. FLoad : Integer는 이 데이터모듈의 변수(variable)로써 데이터가 로드되는 시점을 추적한다. 일단 로드가 되는 중에는 데이터셋이 스크롤 되는 동안 API 호출이 중복하여 발생되지 않도록 체크한다.

procedure TdataExams.BeginLoad;
begin
  Inc(FLoad);
end;

procedure TdataExams.EndLoad(DataSet: TDataSet);
begin
  Dec(FLoad);
  // Now loading is done, update the data
  if Assigned(DataSet) and
     Assigned(DataSet.AfterScroll) then
    DataSet.AfterScroll(DataSet);
end;

function TdataExams.Loading: Boolean;
begin
  Result := FLoad > 0;
end;

procedure TdataExams.LoadExams;
begin
  BeginLoad;
  try
    RESTRequestEXAMS.Execute;
  finally
    EndLoad(rdsaEXAMS.Dataset);
  end;
end;

 

화면에 데이터 표현하기

화면에 데이터를 어떻게 표현하는지 확실히 알지 못한다면, 위에 언급한 비디오를 보거나 이전에 작성한 라이브바인딩(LiveBindings) 글 시리즈를 살펴보기 바란다. 예를 들어 시험, 질문, 답변이라는 그리드 3개로 시작해보는 것도 좋다. 

요컨대, uses에 해당 데이터 모듈을 추가(File > Use Unit.. > 목록에서 해당 데이터 모듈 선택)했는 지 확인하고 나서, 폼에서 마우스 오른쪽 클릭 > Bind Visually > 해당 데이터셋을 원하는 그리드 콘트롤에 연결하면 된다. 이제 클라이언트 애플리케이션에서는 해당 데이터모듈에 있는 LoadExams 메소드만 호출하면 된다. 다음 시간까지… 해피 코딩(happy coding)!

 

이 글의 본문. 즉, Developing client applications using RESTful master-detail data with TRESTResponseDataSetAdapter은 Stephen Ball's Technical Blog에 먼저 게시되었다..

 

번호 제목 글쓴이 날짜 조회 수
공지 [DelphiCon 요약] 코드사이트 로깅 실전 활용 기법 (Real-world CodeSite Logging Techniques) 관리자 2021.01.19 14387
공지 [UX Summit 요약] 오른쪽 클릭은 옳다 (Right Click is Right) 관리자 2020.11.16 13023
공지 [10.4 시드니] What's NEW! 신기능 자세히 보기 관리자 2020.05.27 15532
공지 RAD스튜디오(델파이,C++빌더) - 고객 사례 목록 관리자 2018.10.23 21064
공지 [데브기어 컨설팅] 모바일 앱 & 업그레이드 마이그레이션 [1] 관리자 2017.02.06 22297
공지 [전체 목록] 이 달의 기술자료 & 기술레터 관리자 2017.02.06 17933
공지 RAD스튜디오(델파이, C++빌더) - 시작하기 [1] 관리자 2015.06.30 38228
공지 RAD스튜디오(델파이,C++빌더) - 모바일 앱 개발 사례 (2020년 11월 업데이트 됨) 험프리 2014.01.16 173741
1403 [발표자료] 20190214 델파이 24주년 기념 세미나: 델파이 앱 현대화 방안 - 다양한 데이터 서비스 연동하기 관리자 2023.04.20 1354
1402 [10.4 시드니][업데이트 2] TNUMBERBOX – 새로운 VCL 컨트롤 관리자 2023.03.09 277
1401 [10.4 시드니][업데이트 2] TCONTROLLIST – 새로운 VCL 컨트롤 관리자 2023.03.09 245
1400 이 달의 기술자료 - 2021년 09월 file 험프리 2021.08.26 1385
1399 [고객 사례- 델파이, 모바일, 전략] 축구 전술 기획 앱 - Soccer Playview 관리자 2021.08.20 1305
1398 데스크탑, 무엇과도 비교할 수 없는 강력한 생산성의 동력 관리자 2021.08.18 1234
1397 RAD스튜디오 11, 미리보기! 관리자 2021.08.17 1138
1396 RAD스튜디오 11을 준비하는 방법 관리자 2021.08.17 1063
1395 REST 웹서비스, 델파이에서 어떻게 활용해야 할까요? 관리자 2021.08.11 1200
1394 이 달의 기술자료 - 2021년 08월 file 험프리 2021.07.29 1154
1393 [TCoffeeAndCode] – 대규모 프로젝트 관리와 IDE 성능 향상 방안 관리자 2021.07.22 1072
1392 [LEARN TO CODE] 코드 썸머 캠프 2021 관리자 2021.07.16 1070
1391 RAD스튜디오 11, 곧 만나볼 수 있습니다: 새 버전 안내 & 베타 테스터 초대장 관리자 2021.07.15 1168
1390 무료 데이터베이스 활용하기 (여러 데이터베이스 기능 비교) 관리자 2021.07.13 1205
1389 이번주! 꼭 알아야 할 C++ 기술 관리자 2021.07.09 1205
1388 웹사이트 메트릭스, 앱에 바로 적용하는 방법 관리자 2021.07.09 1138
1387 새로운 무료 개발 도구들 관리자 2021.07.07 1267
1386 윈도우 11: 공룡들을 전멸 시킬 유성이 곧 쏟아집니다. 관리자 2021.07.02 1240
1385 델파이용 로우 코드 앱 마법사(LOW CODE APP WIZARD) 관리자 2021.06.25 1271
1384 이 달의 기술자료 - 2021년 07월 험프리 2021.06.24 1284