Nhập số phức c++

Hướng dẫn này mô tả cách sử dụng ngôn ngữ bộ đệm giao thức để cấu trúc dữ liệu bộ đệm giao thức của bạn, bao gồm cú pháp tệp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Đây là hướng dẫn tham khảo – để biết ví dụ từng bước sử dụng nhiều tính năng được mô tả trong tài liệu này, hãy xem hướng dẫn cho ngôn ngữ bạn chọn (hiện chỉ có proto2; sắp có thêm tài liệu proto3)

Xác định loại tin nhắn

Trước tiên hãy xem một ví dụ rất đơn giản. Giả sử bạn muốn xác định định dạng thông báo yêu cầu tìm kiếm, trong đó mỗi yêu cầu tìm kiếm có một chuỗi truy vấn, trang kết quả cụ thể mà bạn quan tâm và một số kết quả trên mỗi trang. Đây là tệp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

syntax = "proto3";

message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
}

• Dòng đầu tiên của tệp xác định rằng bạn đang sử dụng cú pháp

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  6. nếu bạn không làm điều này, trình biên dịch bộ đệm giao thức sẽ cho rằng bạn đang sử dụng proto2. Đây phải là dòng không trống, không ghi chú đầu tiên của tệp
• Định nghĩa thông báo

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  7 chỉ định ba trường (cặp tên/giá trị), một trường cho mỗi phần dữ liệu mà bạn muốn đưa vào loại thông báo này. Mỗi trường có một tên và một loại

Chỉ định loại trường

Trong ví dụ trên, tất cả các trường là loại vô hướng. hai số nguyên (

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

enum Corpus {
  CORPUS_UNSPECIFIED = 0;
  CORPUS_UNIVERSAL = 1;
  CORPUS_WEB = 2;
  CORPUS_IMAGES = 3;
  CORPUS_LOCAL = 4;
  CORPUS_NEWS = 5;
  CORPUS_PRODUCTS = 6;
  CORPUS_VIDEO = 7;
}
message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
  Corpus corpus = 4;
}

Gán số trường

Như bạn có thể thấy, mỗi trường trong định nghĩa thông báo có một số duy nhất. Các số trường này được sử dụng để xác định các trường của bạn ở định dạng nhị phân thông báo và không được thay đổi sau khi loại thông báo của bạn được sử dụng. Lưu ý rằng các số trường trong phạm vi từ 1 đến 15 cần một byte để mã hóa, bao gồm số trường và loại trường (bạn có thể tìm hiểu thêm về điều này trong Mã hóa bộ đệm giao thức). Số trường trong phạm vi 16 đến 2047 chiếm hai byte. Vì vậy, bạn nên dành các số từ 1 đến 15 cho các phần tử thông báo xuất hiện rất thường xuyên. Hãy nhớ để lại một số chỗ cho các yếu tố thường xuyên xuất hiện có thể được thêm vào trong tương lai

Số trường nhỏ nhất bạn có thể chỉ định là 1 và số lớn nhất là 229 - 1 hoặc 536.870.911. Bạn cũng không thể sử dụng các số từ 19000 đến 19999 (

enum Corpus {
  CORPUS_UNSPECIFIED = 0;
  CORPUS_UNIVERSAL = 1;
  CORPUS_WEB = 2;
  CORPUS_IMAGES = 3;
  CORPUS_LOCAL = 4;
  CORPUS_NEWS = 5;
  CORPUS_PRODUCTS = 6;
  CORPUS_VIDEO = 7;
}
message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
  Corpus corpus = 4;
}

enum Corpus {
  CORPUS_UNSPECIFIED = 0;
  CORPUS_UNIVERSAL = 1;
  CORPUS_WEB = 2;
  CORPUS_IMAGES = 3;
  CORPUS_LOCAL = 4;
  CORPUS_NEWS = 5;
  CORPUS_PRODUCTS = 6;
  CORPUS_VIDEO = 7;
}
message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
  Corpus corpus = 4;
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Chỉ định quy tắc trường

Các trường tin nhắn có thể là một trong những trường sau

• enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  4. một thông báo được định dạng tốt có thể có 0 hoặc một trong các trường này (nhưng không nhiều hơn một). Khi sử dụng cú pháp proto3, đây là quy tắc trường mặc định khi không có quy tắc trường nào khác được chỉ định cho một trường nhất định. Bạn không thể xác định liệu nó đã được phân tích cú pháp từ dây. Nó sẽ được nối tiếp với dây trừ khi nó là giá trị mặc định. Để biết thêm về chủ đề này, hãy xem Sự hiện diện tại hiện trường

• enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  5. giống như

  enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  4, ngoại trừ việc bạn có thể kiểm tra xem giá trị đã được đặt rõ ràng chưa. Trường

  enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  5 ở một trong hai trạng thái có thể
  • trường được đặt và chứa một giá trị được đặt hoặc phân tích cú pháp rõ ràng từ dây. Nó sẽ được nối tiếp với dây
  • trường không được đặt và sẽ trả về giá trị mặc định. Nó sẽ không được nối tiếp với dây

• enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  8. loại trường này có thể được lặp lại 0 lần hoặc nhiều lần trong một thông báo được định dạng tốt. Thứ tự của các giá trị lặp lại sẽ được giữ nguyên

• enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  9. đây là loại trường khóa/giá trị được ghép nối. Xem Bản đồ để biết thêm về loại trường này

Trong proto3, các trường

enum Corpus {
  CORPUS_UNSPECIFIED = 0;
  CORPUS_UNIVERSAL = 1;
  CORPUS_WEB = 2;
  CORPUS_IMAGES = 3;
  CORPUS_LOCAL = 4;
  CORPUS_NEWS = 5;
  CORPUS_PRODUCTS = 6;
  CORPUS_VIDEO = 7;
}
message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
  Corpus corpus = 4;
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Thêm các loại tin nhắn khác

Nhiều loại thông báo có thể được xác định trong một tệp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Thêm Nhận xét

Để thêm nhận xét vào tệp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Trường dành riêng

Nếu bạn cập nhật một loại thông báo bằng cách xóa hoàn toàn một trường hoặc nhận xét nó, những người dùng trong tương lai có thể sử dụng lại số trường khi thực hiện cập nhật của riêng họ cho loại. Điều này có thể gây ra sự cố nghiêm trọng nếu sau đó họ tải các phiên bản cũ của cùng một

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

syntax = "proto3";

message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Lưu ý rằng bạn không thể trộn tên trường và số trường trong cùng một câu lệnh

syntax = "proto3";

message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
}

Điều gì được tạo ra từ message Foo { reserved 2, 15, 9 to 11; reserved "foo", "bar"; } 3 của bạn?

Khi bạn chạy trình biên dịch bộ đệm giao thức trên

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

• Đối với C++, trình biên dịch tạo tệp

  syntax = "proto3";
  
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
  }
  

  04 và

  syntax = "proto3";
  
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
  }
  

  05 từ mỗi

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  3, với một lớp cho từng loại thông báo được mô tả trong tệp của bạn
• Đối với Java, trình biên dịch tạo tệp

  syntax = "proto3";
  
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
  }
  

  07 với một lớp cho từng loại thông báo, cũng như một lớp

  syntax = "proto3";
  
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
  }
  

  08 đặc biệt để tạo các thể hiện của lớp thông báo
• Đối với Kotlin, ngoài mã do Java tạo ra, trình biên dịch tạo tệp

  syntax = "proto3";
  
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
  }
  

  09 cho từng loại thông báo, chứa DSL có thể được sử dụng để đơn giản hóa việc tạo các phiên bản thông báo
• Python hơi khác một chút — trình biên dịch Python tạo ra một mô-đun có bộ mô tả tĩnh của từng loại thông báo trong

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  3 của bạn, mô-đun này sau đó được sử dụng với siêu dữ liệu để tạo lớp truy cập dữ liệu Python cần thiết trong thời gian chạy
• Đối với Go, trình biên dịch tạo tệp

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  21 với loại cho từng loại thông báo trong tệp của bạn
• Đối với Ruby, trình biên dịch tạo tệp

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  22 với mô-đun Ruby chứa các loại thông báo của bạn
• Đối với Objective-C, trình biên dịch tạo tệp

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  23 và

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  24 từ mỗi

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  3, với một lớp cho từng loại thông báo được mô tả trong tệp của bạn
• Đối với C#, trình biên dịch tạo tệp

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  26 từ mỗi

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  3, với một lớp cho từng loại thông báo được mô tả trong tệp của bạn
• Đối với Dart, trình biên dịch tạo tệp

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  28 với một lớp cho từng loại thông báo trong tệp của bạn

Bạn có thể tìm hiểu thêm về cách sử dụng API cho từng ngôn ngữ bằng cách làm theo hướng dẫn cho ngôn ngữ bạn chọn (sắp có phiên bản proto3). Để biết thêm chi tiết về API, hãy xem tài liệu tham khảo API có liên quan (sắp có phiên bản proto3)

Các loại giá trị vô hướng

Trường thông báo vô hướng có thể có một trong các loại sau – bảng hiển thị loại được chỉ định trong tệp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

.proto TypeNotesC++ TypeJava/Kotlin Type[1]Python Type[3]Go TypeRuby TypeC# TypePHP TypeDart Typedoubledoubledoublefloatfloat64Floatdoublefloatdoublefloatfloatfloatfloatfloat32Floatfloatfloatdoubleint32Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead.int32intintint32Fixnum or Bignum (as required)intintegerintint64Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead.int64longint/long[4]int64Bignumlonginteger/string[6]Int64uint32Uses variable-length encoding.uint32int[2]int/long[4]uint32Fixnum or Bignum (as required)uintintegerintuint64Uses variable-length encoding.uint64long[2]int/long[4]uint64Bignumulonginteger/string[6]Int64sint32Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s.int32intintint32Fixnum or Bignum (as required)intintegerintsint64Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s.int64longint/long[4]int64Bignumlonginteger/string[6]Int64fixed32Always four bytes. More efficient than uint32 if values are often greater than 228.uint32int[2]int/long[4]uint32Fixnum or Bignum (as required)uintintegerintfixed64Always eight bytes. More efficient than uint64 if values are often greater than 256.uint64long[2]int/long[4]uint64Bignumulonginteger/string[6]Int64sfixed32Always four bytes.int32intintint32Fixnum or Bignum (as required)intintegerintsfixed64Always eight bytes.int64longint/long[4]int64Bignumlonginteger/string[6]Int64boolboolbooleanboolboolTrueClass/FalseClassboolbooleanboolstringA string must always contain UTF-8 encoded or 7-bit ASCII text, and cannot be longer than 232.stringStringstr/unicode[5]stringString (UTF-8)stringstringStringbytesMay contain any arbitrary sequence of bytes no longer than 232.stringByteStringstr (Python 2)
byte (Python 3)[]byteString (ASCII-8BIT)ByteStringstringList

Bạn có thể tìm hiểu thêm về cách các loại này được mã hóa khi bạn đánh số thứ tự thư của mình trong Mã hóa bộ đệm giao thức

[1] Kotlin sử dụng các loại tương ứng từ Java, ngay cả đối với các loại không dấu, để đảm bảo khả năng tương thích trong các cơ sở mã Java/Kotlin hỗn hợp

[2] Trong Java, các số nguyên 32 bit và 64 bit không dấu được biểu diễn bằng cách sử dụng các số nguyên có dấu của chúng, với bit trên cùng chỉ đơn giản là được lưu trữ trong bit dấu

[3] Trong mọi trường hợp, việc đặt giá trị cho một trường sẽ thực hiện kiểm tra loại để đảm bảo trường đó hợp lệ

[4] Các số nguyên 32 bit 64 bit hoặc không dấu luôn được biểu thị bằng long khi được giải mã, nhưng có thể là một số nguyên nếu một số int được cung cấp khi đặt trường. Trong mọi trường hợp, giá trị phải phù hợp với loại được biểu thị khi đặt. Xem [2]

[5] Các chuỗi Python được biểu diễn dưới dạng unicode khi giải mã nhưng có thể là str nếu một chuỗi ASCII được cung cấp (điều này có thể thay đổi)

[6] Số nguyên được sử dụng trên máy 64 bit và chuỗi được sử dụng trên máy 32 bit

Giá trị mặc định

Khi một thông báo được phân tích cú pháp, nếu thông báo được mã hóa không chứa một phần tử số ít cụ thể, thì trường tương ứng trong đối tượng được phân tích cú pháp được đặt thành giá trị mặc định cho trường đó. Các giá trị mặc định này là loại cụ thể

• Đối với chuỗi, giá trị mặc định là chuỗi rỗng
• Đối với byte, giá trị mặc định là byte trống
• Đối với bool, giá trị mặc định là sai
• Đối với các loại số, giá trị mặc định là 0
• Đối với enum, giá trị mặc định là giá trị enum được xác định đầu tiên, giá trị này phải bằng 0
• Đối với các trường thông báo, trường không được đặt. Giá trị chính xác của nó phụ thuộc vào ngôn ngữ. Xem hướng dẫn mã được tạo để biết chi tiết

Giá trị mặc định cho các trường lặp lại là trống (thường là danh sách trống bằng ngôn ngữ thích hợp)

Lưu ý rằng đối với các trường thông báo vô hướng, một khi thông báo được phân tích cú pháp, không có cách nào để biết liệu một trường có được đặt rõ ràng thành giá trị mặc định hay không (ví dụ: liệu một giá trị boolean đã được đặt thành

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Xem hướng dẫn mã được tạo cho ngôn ngữ bạn đã chọn để biết thêm chi tiết về cách hoạt động mặc định trong mã được tạo

phép liệt kê

Khi bạn đang xác định loại thông báo, bạn có thể muốn một trong các trường của nó chỉ có một trong danh sách giá trị được xác định trước. Ví dụ: giả sử bạn muốn thêm trường

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Trong ví dụ sau, chúng tôi đã thêm một

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Như bạn có thể thấy, hằng số đầu tiên của

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

• Phải có giá trị bằng 0 để chúng tôi có thể sử dụng 0 làm giá trị mặc định số
• Giá trị 0 phải là phần tử đầu tiên, để tương thích với ngữ nghĩa proto2 trong đó giá trị enum đầu tiên luôn là giá trị mặc định

Bạn có thể xác định bí danh bằng cách gán cùng một giá trị cho các hằng số enum khác nhau. Để làm điều này, bạn cần đặt tùy chọn

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Hằng số liệt kê phải nằm trong phạm vi số nguyên 32 bit. Vì các giá trị

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Khi bạn chạy trình biên dịch bộ đệm giao thức trên một

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Trong quá trình khử lưu huỳnh, các giá trị enum không được nhận dạng sẽ được giữ nguyên trong thông báo, mặc dù cách thức này được biểu thị khi thông báo được giải tuần tự hóa phụ thuộc vào ngôn ngữ. Trong các ngôn ngữ hỗ trợ các kiểu enum mở với các giá trị nằm ngoài phạm vi của các ký hiệu đã chỉ định, chẳng hạn như C++ và Go, giá trị enum không xác định được lưu trữ đơn giản dưới dạng biểu diễn số nguyên cơ bản của nó. Trong các ngôn ngữ có kiểu enum đóng, chẳng hạn như Java, một trường hợp trong enum được sử dụng để biểu thị một giá trị không được nhận dạng và số nguyên bên dưới có thể được truy cập bằng các bộ truy cập đặc biệt. Trong cả hai trường hợp, nếu thông báo được đánh số thứ tự thì giá trị không được nhận dạng sẽ vẫn được đánh số thứ tự cùng với thông báo

Để biết thêm thông tin về cách làm việc với thông báo

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Giá trị dành riêng

Nếu bạn cập nhật một loại enum bằng cách loại bỏ hoàn toàn một mục nhập enum hoặc nhận xét nó, những người dùng trong tương lai có thể sử dụng lại giá trị số khi thực hiện cập nhật của riêng họ cho loại. Điều này có thể gây ra sự cố nghiêm trọng nếu sau đó họ tải các phiên bản cũ của cùng một

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

syntax = "proto3";

message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

syntax = "proto3";

message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
}

Lưu ý rằng bạn không thể kết hợp tên trường và giá trị số trong cùng một câu lệnh

syntax = "proto3";

message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
}

Sử dụng các loại tin nhắn khác

Bạn có thể sử dụng các loại thông báo khác làm loại trường. Ví dụ: giả sử bạn muốn bao gồm thông báo

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Nhập định nghĩa

Trong ví dụ trên, loại thông báo

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Bạn có thể sử dụng các định nghĩa từ các tệp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Theo mặc định, bạn chỉ có thể sử dụng các định nghĩa từ tệp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Lưu ý rằng chức năng nhập công khai không khả dụng trong Java

Các phụ thuộc của

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Trình biên dịch giao thức tìm kiếm các tệp đã nhập trong một tập hợp các thư mục được chỉ định trên dòng lệnh của trình biên dịch giao thức bằng cách sử dụng cờ

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Sử dụng các loại tin nhắn proto2

Có thể nhập các loại tin nhắn proto2 và sử dụng chúng trong tin nhắn proto3 của bạn và ngược lại. Tuy nhiên, không thể sử dụng trực tiếp enums proto2 trong cú pháp proto3 (không sao nếu thông báo proto2 đã nhập sử dụng chúng)

Các loại lồng nhau

Bạn có thể xác định và sử dụng các loại thông báo bên trong các loại thông báo khác, như trong ví dụ sau – ở đây thông báo

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Nếu bạn muốn sử dụng lại loại tin nhắn này bên ngoài loại tin nhắn gốc của nó, bạn gọi nó là

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Bạn có thể lồng các tin nhắn sâu như bạn muốn

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Cập nhật loại tin nhắn

Nếu một loại thông báo hiện có không còn đáp ứng tất cả các nhu cầu của bạn – ví dụ: bạn muốn định dạng thông báo có thêm một trường – nhưng bạn vẫn muốn sử dụng mã được tạo bằng định dạng cũ, đừng lo lắng. Rất đơn giản để cập nhật các loại thông báo mà không vi phạm bất kỳ mã hiện có nào của bạn. Chỉ cần nhớ các quy tắc sau

• Không thay đổi số trường cho bất kỳ trường hiện có nào
• Nếu bạn thêm các trường mới, bất kỳ thư nào được đánh số thứ tự theo mã sử dụng định dạng thư "cũ" của bạn vẫn có thể được phân tích cú pháp bằng mã mới được tạo của bạn. Bạn nên ghi nhớ các giá trị mặc định cho các phần tử này để mã mới có thể tương tác đúng cách với các thông báo do mã cũ tạo ra. Tương tự, các thông báo được tạo bởi mã mới của bạn có thể được phân tích cú pháp bằng mã cũ của bạn. nhị phân cũ chỉ cần bỏ qua trường mới khi phân tích cú pháp. Xem phần Trường không xác định để biết chi tiết
• Các trường có thể bị xóa, miễn là số trường không được sử dụng lại trong loại thông báo cập nhật của bạn. Thay vào đó, bạn có thể muốn đổi tên trường, có thể thêm tiền tố "OBSOLETE_" hoặc đặt riêng số trường để người dùng trong tương lai của

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  3 của bạn không thể vô tình sử dụng lại số

• message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  438,

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  439,

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  440,

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  441 và

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  442 đều tương thích – điều này có nghĩa là bạn có thể thay đổi trường từ một trong các loại này sang loại khác mà không vi phạm khả năng tương thích xuôi hoặc ngược. Nếu một số được phân tích cú pháp từ dây không khớp với loại tương ứng, bạn sẽ nhận được hiệu ứng tương tự như thể bạn đã chuyển số đó sang loại đó trong C++ (ví dụ: nếu một số 64 bit được đọc dưới dạng

• message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  443 và

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  444 tương thích với nhau nhưng không tương thích với các kiểu số nguyên khác

• message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  445 và

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  446 tương thích miễn là các byte hợp lệ UTF-8
• Tin nhắn được nhúng tương thích với

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  446 nếu các byte chứa phiên bản được mã hóa của tin nhắn

• message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  448 tương thích với

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  449 và

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  450 với

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  451
• Đối với các trường ________ 2445, ________ 2446 và thông báo, các trường số ít tương thích với các trường

  enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  8. Với dữ liệu được tuần tự hóa của một trường lặp lại làm đầu vào, các máy khách mong đợi trường này là số ít sẽ lấy giá trị đầu vào cuối cùng nếu đó là trường loại nguyên thủy hoặc hợp nhất tất cả các thành phần đầu vào nếu đó là trường loại thông báo. Lưu ý rằng điều này thường không an toàn đối với các loại số, bao gồm bool và enums. Các trường lặp lại của các loại số có thể được sắp xếp theo thứ tự ở định dạng đóng gói, định dạng này sẽ không được phân tích cú pháp chính xác khi một trường số ít được mong đợi

• message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  11 tương thích với ________ 2438, ________ 2439, ________ 2440 và ________ 2441 về định dạng dây (lưu ý rằng các giá trị sẽ bị cắt bớt nếu chúng không vừa). Tuy nhiên, hãy lưu ý rằng mã máy khách có thể xử lý chúng khác đi khi thông báo được giải tuần tự hóa. ví dụ: các loại proto3

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  11 không được nhận dạng sẽ được giữ nguyên trong tin nhắn, nhưng cách điều này được thể hiện khi tin nhắn được giải tuần tự hóa phụ thuộc vào ngôn ngữ. Các trường int luôn chỉ bảo toàn giá trị của chúng
• Thay đổi một trường hoặc phần mở rộng

  enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  5 thành một thành viên của một

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  462 mới là an toàn và tương thích nhị phân. Di chuyển nhiều trường sang một

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  462 mới có thể an toàn nếu bạn chắc chắn rằng không có mã nào đặt nhiều trường cùng một lúc. Di chuyển bất kỳ trường nào vào một

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  462 hiện có là không an toàn. Tương tự như vậy, việc thay đổi một trường duy nhất

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  462 thành trường

  enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  5 hoặc phần mở rộng là an toàn

Trường không xác định

Các trường không xác định là dữ liệu được tuần tự hóa trong bộ đệm giao thức được định dạng tốt biểu thị các trường mà trình phân tích cú pháp không nhận ra. Ví dụ: khi một nhị phân cũ phân tích dữ liệu được gửi bởi một nhị phân mới với các trường mới, những trường mới đó trở thành các trường không xác định trong nhị phân cũ

Ban đầu, các thông báo proto3 luôn loại bỏ các trường không xác định trong quá trình phân tích cú pháp, nhưng trong phiên bản 3. 5, chúng tôi đã giới thiệu lại việc bảo tồn các trường không xác định để phù hợp với hành vi proto2. Trong phiên bản 3. 5 trở lên, các trường không xác định được giữ lại trong quá trình phân tích cú pháp và được đưa vào đầu ra được tuần tự hóa

Không tí nào

Loại thông báo

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

URL loại mặc định cho một loại thông báo nhất định là

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Việc triển khai ngôn ngữ khác nhau sẽ hỗ trợ các trình trợ giúp thư viện thời gian chạy để đóng gói và giải nén các giá trị

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Hiện tại các thư viện thời gian chạy để làm việc với các loại

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Nếu bạn đã quen thuộc với cú pháp proto2, thì

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Một trong

Nếu bạn có một thư có nhiều trường và nơi tối đa một trường sẽ được đặt cùng lúc, bạn có thể thực thi hành vi này và tiết kiệm bộ nhớ bằng cách sử dụng tính năng một trong những

Một trong các trường giống như các trường thông thường ngoại trừ tất cả các trường trong một bộ nhớ dùng chung và nhiều nhất một trường có thể được đặt cùng một lúc. Đặt bất kỳ thành viên nào của oneof sẽ tự động xóa tất cả các thành viên khác. Bạn có thể kiểm tra xem giá trị nào trong một trong số được đặt (nếu có) bằng phương pháp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Lưu ý rằng nếu nhiều giá trị được đặt, giá trị được đặt cuối cùng được xác định theo thứ tự trong proto sẽ ghi đè lên tất cả các giá trị trước đó

Sử dụng Oneof

Để xác định một trong số trong

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Sau đó, bạn thêm các trường oneof của mình vào định nghĩa oneof. Bạn có thể thêm các trường thuộc bất kỳ loại nào, ngoại trừ trường

enum Corpus {
  CORPUS_UNSPECIFIED = 0;
  CORPUS_UNIVERSAL = 1;
  CORPUS_WEB = 2;
  CORPUS_IMAGES = 3;
  CORPUS_LOCAL = 4;
  CORPUS_NEWS = 5;
  CORPUS_PRODUCTS = 6;
  CORPUS_VIDEO = 7;
}
message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
  Corpus corpus = 4;
}

enum Corpus {
  CORPUS_UNSPECIFIED = 0;
  CORPUS_UNIVERSAL = 1;
  CORPUS_WEB = 2;
  CORPUS_IMAGES = 3;
  CORPUS_LOCAL = 4;
  CORPUS_NEWS = 5;
  CORPUS_PRODUCTS = 6;
  CORPUS_VIDEO = 7;
}
message SearchRequest {
  string query = 1;
  int32 page_number = 2;
  int32 result_per_page = 3;
  Corpus corpus = 4;
}

Trong mã được tạo của bạn, một trong các trường có cùng getters và setters như các trường thông thường. Bạn cũng có một phương pháp đặc biệt để kiểm tra xem giá trị nào (nếu có) trong oneof được đặt. Bạn có thể tìm hiểu thêm về API oneof cho ngôn ngữ bạn đã chọn trong tài liệu tham khảo API có liên quan

Một trong những tính năng

• Đặt trường oneof sẽ tự động xóa tất cả các thành viên khác của oneof. Vì vậy, nếu bạn đặt một số trường, chỉ trường cuối cùng bạn đặt sẽ vẫn có giá trị

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  48

• Nếu trình phân tích cú pháp gặp nhiều thành viên của cùng một trong số trên dây, thì chỉ thành viên cuối cùng được nhìn thấy được sử dụng trong thông báo được phân tích cú pháp

• Một trong số không thể là

  enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  8

• Reflection API hoạt động cho một trong các trường

• Nếu bạn đặt trường oneof thành giá trị mặc định (chẳng hạn như đặt trường oneof int32 thành 0), "trường hợp" của trường oneof đó sẽ được đặt và giá trị sẽ được đánh số thứ tự trên dây

• Nếu bạn đang sử dụng C++, hãy đảm bảo rằng mã của bạn không gây ra sự cố bộ nhớ. Mã mẫu sau đây sẽ gặp sự cố vì

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  489 đã bị xóa bằng cách gọi phương thức

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  490

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  49

• Một lần nữa trong C++, nếu bạn

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  491 hai tin nhắn với một trường hợp, mỗi tin nhắn sẽ kết thúc bằng một trường hợp của tin nhắn kia. trong ví dụ dưới đây,

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  492 sẽ có một

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  489 và

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  494 sẽ có một

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  495

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  80

Vấn đề tương thích ngược

Hãy cẩn thận khi thêm hoặc xóa một trong các trường. Nếu kiểm tra giá trị của một trong số trả về

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Vấn đề sử dụng lại thẻ

• Di chuyển các trường vào hoặc ra khỏi một trong các trường. Bạn có thể mất một số thông tin của mình (một số trường sẽ bị xóa) sau khi thư được đánh số thứ tự và phân tích cú pháp. Tuy nhiên, bạn có thể di chuyển một trường đơn lẻ sang một trường mới một cách an toàn và có thể di chuyển nhiều trường nếu biết rằng chỉ có một trường được đặt
• Xóa một trường một trong hai và thêm lại trường đó. Thao tác này có thể xóa trường oneof hiện được đặt của bạn sau khi thư được đánh số thứ tự và phân tích cú pháp
• Tách hoặc hợp nhất một trong hai. Điều này có các vấn đề tương tự như di chuyển các trường thông thường

bản đồ

Nếu bạn muốn tạo bản đồ kết hợp như một phần của định nghĩa dữ liệu của mình, bộ đệm giao thức cung cấp cú pháp phím tắt tiện dụng

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

trong đó

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Vì vậy, ví dụ: nếu bạn muốn tạo bản đồ các dự án trong đó mỗi thông báo

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

• Các trường bản đồ không thể là

  enum Corpus {
    CORPUS_UNSPECIFIED = 0;
    CORPUS_UNIVERSAL = 1;
    CORPUS_WEB = 2;
    CORPUS_IMAGES = 3;
    CORPUS_LOCAL = 4;
    CORPUS_NEWS = 5;
    CORPUS_PRODUCTS = 6;
    CORPUS_VIDEO = 7;
  }
  message SearchRequest {
    string query = 1;
    int32 page_number = 2;
    int32 result_per_page = 3;
    Corpus corpus = 4;
  }
  

  8
• Thứ tự định dạng dây và thứ tự lặp lại bản đồ của các giá trị bản đồ không được xác định, vì vậy bạn không thể dựa vào các mục bản đồ của mình theo một thứ tự cụ thể
• Khi tạo định dạng văn bản cho

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  3, bản đồ được sắp xếp theo khóa. Các phím số được sắp xếp theo số
• Khi phân tích cú pháp từ dây hoặc khi hợp nhất, nếu có các khóa bản đồ trùng lặp, khóa cuối cùng nhìn thấy sẽ được sử dụng. Khi phân tích cú pháp bản đồ từ định dạng văn bản, quá trình phân tích cú pháp có thể thất bại nếu có các khóa trùng lặp
• Nếu bạn cung cấp khóa nhưng không cung cấp giá trị cho trường bản đồ, hành vi khi trường được đánh số thứ tự sẽ phụ thuộc vào ngôn ngữ. Trong C++, Java, Kotlin và Python, giá trị mặc định cho loại được tuần tự hóa, trong khi ở các ngôn ngữ khác, không có gì được tuần tự hóa

API bản đồ được tạo hiện có sẵn cho tất cả các ngôn ngữ được hỗ trợ proto3. Bạn có thể tìm hiểu thêm về API bản đồ cho ngôn ngữ bạn đã chọn trong tài liệu tham khảo API có liên quan

Tương thích ngược

Cú pháp bản đồ tương đương với cú pháp sau trên dây, do đó, việc triển khai bộ đệm giao thức không hỗ trợ bản đồ vẫn có thể xử lý dữ liệu của bạn

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Mọi triển khai bộ đệm giao thức hỗ trợ bản đồ đều phải tạo và chấp nhận dữ liệu có thể được chấp nhận theo định nghĩa trên

gói

Bạn có thể thêm một trình xác định

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Sau đó, bạn có thể sử dụng trình xác định gói khi xác định các trường thuộc loại thông báo của mình

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Cách trình xác định gói ảnh hưởng đến mã được tạo tùy thuộc vào ngôn ngữ bạn đã chọn

• Trong C++, các lớp được tạo được bao bọc bên trong một không gian tên C++. Ví dụ:

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  807 sẽ nằm trong không gian tên

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  808
• Trong Java và Kotlin, gói được sử dụng làm gói Java, trừ khi bạn cung cấp một cách rõ ràng một

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  809 trong tệp

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  3 của mình
• Trong Python, chỉ thị gói bị bỏ qua, vì các mô-đun Python được tổ chức theo vị trí của chúng trong hệ thống tệp
• Trong Go, gói được sử dụng làm tên gói Go, trừ khi bạn cung cấp rõ ràng một

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  811 trong tệp

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  3 của mình
• Trong Ruby, các lớp được tạo được bao bọc bên trong các không gian tên ruby ​​lồng nhau, được chuyển đổi thành phong cách viết hoa ruby ​​cần thiết (chữ cái đầu tiên được viết hoa; nếu nhân vật đầu tiên không phải là một chữ cái,

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  813 được chuẩn bị). Ví dụ:

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  807 sẽ nằm trong không gian tên

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  815
• Trong C#, gói được sử dụng làm không gian tên sau khi chuyển đổi sang PascalCase, trừ khi bạn cung cấp rõ ràng một

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  816 trong tệp

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  3 của mình. Ví dụ:

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  807 sẽ nằm trong không gian tên

  message Foo {
    reserved 2, 15, 9 to 11;
    reserved "foo", "bar";
  }
  

  819

Độ phân giải gói và tên

Nhập độ phân giải tên trong ngôn ngữ bộ đệm giao thức hoạt động như C++. đầu tiên, phạm vi trong cùng được tìm kiếm, sau đó là phạm vi trong cùng tiếp theo, v.v., với mỗi gói được coi là "bên trong" đối với gói mẹ của nó. Một sự dẫn đầu '. ' (ví dụ:

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Trình biên dịch bộ đệm giao thức giải quyết tất cả các tên loại bằng cách phân tích cú pháp các tệp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Xác định dịch vụ

Nếu bạn muốn sử dụng các loại thông báo của mình với hệ thống RPC (Gọi thủ tục từ xa), bạn có thể xác định giao diện dịch vụ RPC trong tệp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Hệ thống RPC đơn giản nhất để sử dụng với bộ đệm giao thức là gRPC. một hệ thống RPC nguồn mở trung lập về ngôn ngữ và nền tảng được phát triển tại Google. gRPC hoạt động đặc biệt hiệu quả với bộ đệm giao thức và cho phép bạn tạo mã RPC có liên quan trực tiếp từ tệp

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

Nếu bạn không muốn sử dụng gRPC, bạn cũng có thể sử dụng bộ đệm giao thức với triển khai RPC của riêng mình. Bạn có thể tìm hiểu thêm về điều này trong Hướng dẫn ngôn ngữ Proto2

Ngoài ra còn có một số dự án của bên thứ ba đang diễn ra để phát triển triển khai RPC cho Bộ đệm giao thức. Để biết danh sách các liên kết đến các dự án mà chúng tôi biết, hãy xem trang wiki tiện ích bổ sung của bên thứ ba

Ánh xạ JSON

Proto3 hỗ trợ mã hóa chuẩn trong JSON, giúp chia sẻ dữ liệu giữa các hệ thống dễ dàng hơn. Mã hóa được mô tả trên cơ sở từng loại trong bảng bên dưới

Nếu một giá trị bị thiếu trong dữ liệu được mã hóa JSON hoặc nếu giá trị của nó là

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}

message Foo {
  reserved 2, 15, 9 to 11;
  reserved "foo", "bar";
}