티스토리 뷰

728x90
반응형

스칼라 데이터 타입(Scalar Value Type)

스칼라 메시지 필드는 아래 타입 중 하나를 가질 수 있습니다.

아래 테이블은 .proto 파일에 지정된 타입과 자동으로 생성된 클래스의 타입을 보여줍니다.

.proty Type Notes C++ Type Java/Kotlin Type Python Type Go Type Ruby Type C# Type PHP Type Dart Type
double double double float float64 Float double float double
float float float float float32 Float float float double
int32 가변 길이 인코딩을 사용, 음수 인코딩에 비효율적, 음수 가능성이 있는 경우 sint32 사용 int32 int int int32 Fixnum or Bignum (as required) int integer int
int64 가변 길이 인코딩을 사용, 음수 인코딩에 비효율적, 음수 가능성이 있는 경우 sint64 사용 int64 long int/long[4] int64 Bignum long integer/string[6] Int64
uint32 가변 길이 인코딩을 uint32 int[2] int/long[4] uint32 Fixnum or Bignum (as required) uint integer int
uint64 가변 길이 인코딩을 uint64 long[2] int/long[4] uint64 Bignum ulong integer/string[6] Int64
sint32 가변 길이 인코딩을, 부호 있는 정수 값, int32보다 음수를 더 효율적으로 인코딩 int32 int int int32 Fixnum or Bignum (as required) int integer int
sint64 가변 길이 인코딩을, 부호 있는 정수 값, int64보다 음수를 더 효율적으로 인코딩 int64 long int/long[4] int64 Bignum long integer/string[6] Int64
fixed32 항상 4 바이트, 값이 2^28보다 큰 경우 uint32보다 효율적으로 인코딩 uint32 int[2] int/long[4] uint32 Fixnum or Bignum (as required) uint integer int
fixed64 항상 8 바이트, 값이 2^56보다 큰 경우 uint32보다 효율적으로 인코딩 uint64 long[2] int/long[4] uint64 Bignum ulong integer/string[6] Int64
sfixed32 항상 4 바이트 int32 int int int32 Fixnum or Bignum (as required) int integer int
sfixed64 항상 8 바이트 int64 long int/long[4] int64 Bignum long integer/string[6] Int64
bool bool boolean bool bool TrueClass/FalseClass bool boolean bool
string 문자열은 항상 UTF-8 인코딩 이거나 7비트 ASCII 텍스트를 포함해야 함, 2^32보다 길 수 없음 string String str/unicode[5] string String (UTF-8) string string String
bytes 2^32 이하의 임의의 바이트 시퀀스를 포함 가능 string ByteString str []byte String (ASCII-8BIT) ByteString string List

프로토콜 버퍼 인코딩에서 메시지를 직렬화할 때 위에 명시된 타입들이 인코딩되는 방법에 대해 자세히 알아볼 수 있습니다.

[1] Kotlinunsigned 타입의 경우에도 Java에 해당하는 타입을 사용합니다. Java/Kotlin간 코드 호환성을 보장하기 위함입니다.

[2] Java에서 부호 없는 32비트 및 64비트 정수는 부호 있는 정수를 사용하여 표현되며 최상위 비트는 단순히 부호 비트에 저장됩니다.

[3] 모든 경우에 필드에 값을 설정하면 타입 검사를 수행하여 유효한지 확인합니다.

[4] 64비트 또는 unsigned 32비트 정수는 디코딩 시 항상 long으로 표시되지만 필드를 설정할 때 int가 지정되면 int가 될 수 있습니다. 값은 모든 경우에 설정 시 지정한 타입에 맞아야 합니다. ([2] 참조)

[5] Python 문자열은 디코딩 시 유니코드로 표시되지만 ASCII 문자열이 제공되면 str이 될 수 있습니다(변경될 수 있음).

[6] 64비트 시스템에서는 정수가 사용되고 32비트 시스템에서는 문자열이 사용됩니다.

기본 값(Default Values)

메시지를 파싱할 때 인코딩된 메시지에 특정 단일 요소가 포함되어 있지 않으면, 파싱된 객체의 해당하는 필는 필드에 대한 기본 값이 설정됩니다.

기본 값은 타입 별로 다릅니다.

  • 문자열: 빈 문자열
  • byte: 빈 바이트
  • bool: false
  • numeric: 0
  • enums: 첫 번 째 enum 값, ordinal 값은 0
  • 메시지 필드: 설정되지 않음

repeated 필드의 경우 비어있습니다. 일반 적으로 empty list에 해당합니다.

각 언어 별로 빈 문자열이나 빈 바이트, 객체 등을 나타내는 문법이 다릅니다.

스칼라 메시지 필드의 경우 메시지가 파싱되면 필드가 명시적으로 기본값으로 설정되었는지 여부를 알 수 있는 방법이 없습니다.

따라서 메시지 타입을 정의할 때 각별히 주의해야 합니다.

또한 스칼라 메시지 필드가 기본 값으로 설정된 경우 값이 직렬화되지 않습니다.

생성된 코드에서 기본 값이 작동하는 방식에 대한 자세한 내용은 선택한 언어에 대해 생성된 코드 가이드를 참조하시면 됩니다.


다음 포스팅에서는 Enumeration과 메시지 타입 내에 다른 타입을 사용하는 방법에 대해 다뤄보겠습니다.

본 포스팅은 gRPC 공식 문서를 참고하여 작성하였습니다.

728x90
반응형
댓글
댓글쓰기 폼