Chuyển tới nội dung chính

gRPC (Góc nhìn nhà phát triển)

gRPC là RPC nhị phân. Công cụ này không yêu cầu bạn chuẩn bị tệp .proto — miễn máy chủ bật Server Reflection, máy khách tự khám phá dịch vụ và phương thức, rồi xem trường và gọi theo nhu cầu.

Luồng cốt lõi​

Cách dùng trong UI (ba bước)​

Dùng dịch vụ mẫu qrtest.v1.EchoService (grpc://127.0.0.1:18089, h2c văn bản rõ):

  1. Kết nối yêu cầu gRPC (url lưu host:port). Reflection chạy tự động và cho cây phương thức:
    • /qrtest.v1.EchoService/Echo — unary
    • /qrtest.v1.EchoService/EchoStream — server-streaming
    • /qrtest.v1.EchoService/Collect — client-streaming
    • /qrtest.v1.EchoService/Chat — streaming hai chiều
  2. Xem schema của phương thức Echo:
    • Đầu vào EchoRequest { message: string, count: int32 }
    • Đầu ra EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Gọi Echo với {"message":"hello-grpc","count":3}:
    • Unary: một phản hồi {message:"hello-grpc", seq, metadataJson}, trạng thái OK
    • Server-streaming EchoStream với cùng đầu vào: 3 khung stream#1/#2/#3

Metadata (header gRPC)​

Header xác thực/theo dõi được truyền dưới dạng metadata với khóa viết thường; các header dành riêng như grpc-* và content-type bị lọc bỏ.

TLS / mTLS​

Dùng Pre-URL grpcs:// và nhập chứng chỉ khách trong cài đặt.

Lưu ý quan trọng​

  • Trạng thái không phải OK là kết quả nghiệp vụ bình thường, không phải lỗi kết nối: hết thời gian chờ và lỗi nghiệp vụ trả về dưới dạng mã trạng thái kèm phản hồi có thể rỗng — đừng coi đó là lỗi truyền vận. Chỉ HTTP 4xx mới cho thấy lỗi thực sự.
  • Công cụ chỉ hỗ trợ unary và server-streaming; client-streaming / streaming hai chiều chưa gọi được (với streaming đầy đủ trong ứng dụng, UI là chuẩn).
  • Kiểu phức tạp: trường map hiện dưới dạng mapEntry lồng nhau; các kiểu được tham chiếu gián tiếp cũng được kéo vào.

Liên quan: Pre-URL môi trường và cấu hình TLS trong concepts.