Protocol Buffers 도구

Protocol Buffers란?

Protocol Buffers(Protobuf)는 Google에서 개발한 언어 중립적, 플랫폼 중립적인 구조화된 데이터 직렬화 메커니즘입니다. 데이터 직렬화에 있어 XML 및 JSON보다 작고, 빠르며, 간단합니다.

주요 기능

• 언어 및 플랫폼 중립적
• XML/JSON보다 작고 빠름
• 스키마 정의를 통한 강력한 타이핑
• 하위 및 상위 호환성
• 자동 코드 생성
• 효율적인 바이너리 인코딩

이 도구 사용 방법

1. 스키마 에디터에 .proto 스키마 정의를 입력하세요
2. 스키마 파싱을 클릭하여 스키마를 검증하고 파싱하세요
3. 작업할 메시지 유형을 선택하세요
4. 인코딩: JSON 데이터를 입력하고 인코딩을 클릭하세요
5. 디코딩: 바이너리 데이터를 입력하고 디코딩을 클릭하세요
6. Raw 디코딩을 사용하여 스키마 없이 바이너리 데이터 분석

도구 기능

Proto 구문 참조

Protocol Buffers는 메시지 유형 정의를 위한 간단한 구문을 사용합니다:

syntax = "proto3";

message Person {
    string name = 1;
    int32 id = 2;
    string email = 3;
    
    enum PhoneType {
        MOBILE = 0;
        HOME = 1;
        WORK = 2;
    }
    
    message PhoneNumber {
        string number = 1;
        PhoneType type = 2;
    }
    
    repeated PhoneNumber phones = 4;
}

• syntax: protobuf 버전 지정 (proto2 또는 proto3)
• message: 필드가 있는 메시지 유형 정의
• field: 각 필드는 유형, 이름 및 고유 번호를 가짐
• enum: 열거형 유형 정의
• repeated: 필드를 repeated로 표시 (배열/리스트)
• optional: 필드를 optional로 표시 (proto3)

스칼라 유형

Protocol Buffers는 다양한 스칼라 유형을 지원합니다:

와이어 유형

Protobuf는 와이어 유형을 사용하여 바이너리 데이터에서 값을 읽는 방법을 결정합니다:

모범 사례

• 새 프로젝트에는 proto3 구문을 사용하세요 - 더 간단하고 광범위하게 지원됩니다
• 필드 번호를 안정적으로 유지하세요 - 기존 필드의 번호를 재사용하거나 변경하지 마세요
• 데이터를 명확하게 설명하는 의미 있는 필드 이름을 사용하세요
• 자주 사용되는 필드에는 필드 번호 1-15를 사용하세요 (1바이트 사용)
• 값의 배열/리스트에는 'repeated' 키워드를 사용하세요
• 가능한 값의 고정 세트가 있는 필드에는 enum을 정의하세요

일반적인 사용 사례

• 마이크로서비스의 서비스 간 통신 (gRPC)
• 데이터 저장 및 캠싱
• 구성 파일
• 네트워크 프로토콜 및 API

참조

• 공식 Protocol Buffers 문서
• Proto3 언어 가이드
• 인코딩 참조
• Protobuf.js 라이브러리 (GitHub)