Amazon SQS 클라이언트 (TsgcHTTPAWS_SQS_Client) — sgcWebSockets

한눈에 보기

TsgcHTTPAWS_SQS_Client

AWS SQS 클라이언트 컴포넌트 — SendMessage, ReceiveMessage, DeleteMessage, ChangeMessageVisibility, 큐 CRUD 등 모든 작업이 access-key/secret 쌍을 통한 SigV4 서명으로 이루어져요.

컴포넌트 클래스

TsgcHTTPAWS_SQS_Client

프로토콜

Amazon SQS API

플랫폼

Windows, macOS, Linux, iOS, Android

에디션

Standard / Professional / Enterprise

빠른 시작

자격 증명 설정, 보내기 및 받기

AccessKey / SecretKey / Region을 설정한 다음, 메시지 추가에는 SendMessage, 소비에는 ReceiveMessage, 확인에는 DeleteMessage를 호출해요.

uses
  sgcHTTP;

var
  SQS: TsgcHTTPAWS_SQS_Client;
begin
  SQS := TsgcHTTPAWS_SQS_Client.Create(nil);
  SQS.AWSOptions.AccessKey := 'AKIA...';
  SQS.AWSOptions.SecretKey := 'your-secret';
  SQS.AWSOptions.Region    := 'eu-west-1';

  // publish
  SQS.SendMessage(
    'https://sqs.eu-west-1.amazonaws.com/123456789012/orders',
    '{"orderId":42,"status":"new"}');

  // consume
  Memo1.Text := SQS.ReceiveMessage(
    'https://sqs.eu-west-1.amazonaws.com/123456789012/orders', 10);
end;

// uses: sgcHTTP
TsgcHTTPAWS_SQS_Client *SQS = new TsgcHTTPAWS_SQS_Client(this);
SQS->AWSOptions->AccessKey = "AKIA...";
SQS->AWSOptions->SecretKey = "your-secret";
SQS->AWSOptions->Region    = "eu-west-1";

SQS->SendMessage(queueUrl, payload);
Memo1->Text = SQS->ReceiveMessage(queueUrl, 10);

기술 기능

내부 구성

최신 sqs.<region>.amazonaws.com JSON+SigV4 엔드포인트를 대상으로 해요.

큐 수명 주기

CreateQueue, DeleteQueue, GetQueueUrl, ListQueues, GetQueueAttributes, SetQueueAttributes가 큐 컨트롤 플레인을 처리해요.

전송 / 수신 / 삭제

SendMessage, SendMessageBatch, ReceiveMessage, DeleteMessage, DeleteMessageBatch, ChangeMessageVisibility가 데이터 플레인을 담당해요.

FIFO 지원

FIFO 큐의 경우 컴포넌트는 MessageGroupId와 MessageDeduplicationId를 받아요. SequenceNumber는 응답으로 반환돼요. 가시성 시간 초과는 그룹 단위로 적용돼요.

AWS Signature V4

모든 요청은 AWS의 SigV4 사양에 따라 서명돼요 — 정규화된 요청, 해시, 서명 키, 헤더 주입. 장기 키를 지원하며, STS 세션 토큰은 AWSOptions.SessionToken을 통해 처리돼요.

Long polling

SQS long polling을 사용하려면 ReceiveMessage에 0이 아닌 WaitTimeSeconds를 전달하세요 — 최대 20초 대기, 빈 수신 감소, 더 적은 요청 수.

전송 중 암호화

리전 SQS 엔드포인트로 항상 HTTPS를 사용해요 — SSE-SQS / SSE-KMS 저장 시 암호화는 SetQueueAttributes를 통해 서버 측에서 구성돼요.

표준

사양 & 참고 자료

이 컴포넌트가 구현하는 API의 공식 출처.

리소스

문서 & 데모

컴포넌트 레퍼런스로 바로 이동하고, 바로 실행 가능한 데모 프로젝트를 가져오고, 체험판을 다운로드해요.

	온라인 도움말 — AWS SQS Client 이 컴포넌트의 전체 속성, 메서드, 이벤트 레퍼런스.	열기
	데모 프로젝트 — Demos\20.HTTP_Protocol\04.AWS 바로 실행 가능한 예제 프로젝트. sgcWebSockets 패키지에 포함되어 있어요 — 아래에서 체험판을 다운로드하세요.	열기
	기술 문서 (PDF) 이 컴포넌트만의 기능, 빠른 시작, Delphi & C++ Builder 코드 샘플과 1차 출처 참고 자료.	열기
	사용자 설명서 (PDF) 라이브러리의 모든 컴포넌트를 다루는 종합 설명서.	열기

Amazon SQS