gRPC (개발자 관점)
gRPC는 바이너리 RPC입니다. 이 도구는 .proto 파일 준비를 요구하지 않습니다 — 서버가 Server Reflection을 켜두기만 하면, 클라이언트가 서비스와 메서드를 자동 탐색하고 필드를 확인해 그 자리에서 호출할 수 있습니다.
핵심 흐름
UI에서의 사용법 (3단계)
샘플 서비스 qrtest.v1.EchoService(grpc://127.0.0.1:18089, 평문 h2c)를 사용한 예:
- gRPC 요청을 연결합니다(url은
host:port를 저장). Reflection이 자동 실행되어 메서드 트리가 나옵니다:/qrtest.v1.EchoService/Echo— 단일 응답(unary)/qrtest.v1.EchoService/EchoStream— 서버 스트리밍/qrtest.v1.EchoService/Collect— 클라이언트 스트리밍/qrtest.v1.EchoService/Chat— 양방향 스트리밍
Echo메서드의 스키마를 확인합니다:- 입력
EchoRequest { message: string, count: int32 } - 출력
EchoResponse { message: string, seq: int64, metadataJson: string }
- 입력
{"message":"hello-grpc","count":3}로Echo를 호출합니다:- Unary:
{message:"hello-grpc", seq, metadataJson}응답 1건, 상태OK - 같은 입력으로 서버 스트리밍
EchoStream:stream#1/#2/#33프레임
- Unary:
메타데이터 (gRPC 헤더)
인증 / 트레이싱 헤더는 소문자 키의 메타데이터로 전달됩니다. grpc-*, content-type 등 예약 헤더는 걸러집니다.
TLS / mTLS
Pre-URL에 grpcs://를 쓰고, 설정에서 클라이언트 인증서를 임포트합니다.
주의 사항 (중요)
- non-OK 상태는 정상적인 비즈니스 결 과이며, 연결 실패가 아닙니다: 타임아웃과 비즈니스 오류는 상태 코드와 (비어 있을 수 있는) 응답으로 돌아옵니다 — 트랜스포트 오류로 취급하지 마세요. HTTP 4xx만이 실제 오류를 나타냅니다.
- 이 도구가 지원하는 것은 unary와 서버 스트리밍뿐입니다. 클라이언트 스트리밍 / 양방향 스트리밍은 아직 호출할 수 없습니다(앱 내 완전한 스트리밍은 UI가 기준입니다).
- 복합 타입:
map필드는 중첩된mapEntry로 나타납니다. 간접 참조되는 타입도 함께 로드됩니다.
관련: 환경의 Pre-URL과 TLS 설정은 concepts.