Protocol Buffers

핵심 개념

IDL (Interface Definition Language)

.proto 파일에 메시지 필드와 타입, 서비스 인터페이스를 언어 중립적인 문법으로 정의하는 방식이다.

Message

직렬화 대상이 되는 데이터 구조의 단위로, 필드 이름·타입·번호로 구성된다.

Field Number

각 필드에 부여되는 고유 번호로, 실제 전송 시 필드 이름 대신 사용되어 크기를 줄이고 하위 호환성을 유지한다.

Code Generation

protoc 컴파일러가 .proto 정의를 읽어 여러 언어의 클래스/구조체 코드를 자동 생성해준다.

Binary Serialization

데이터를 사람이 읽기 어려운 압축된 이진 형태로 인코딩해 전송 크기와 파싱 비용을 줄인다.

Schema Evolution

필드를 추가·삭제해도 번호 규칙을 지키면 기존 클라이언트와의 호환성이 깨지지 않도록 설계된 특성이다.

기본 .proto 메시지 정의

User 메시지와 이를 조회하는 서비스 인터페이스를 정의한 예시로, protoc으로 컴파일하면 각 언어별 코드가 생성된다.

syntax = "proto3";

package user;

message User {
  int64 id = 1;
  string name = 2;
  string email = 3;
  repeated string roles = 4;
}

service UserService {
  rpc GetUser (UserRequest) returns (User);
}

message UserRequest {
  int64 id = 1;
}