## gRPC-JSON 轉碼器 gRPC-JSON 轉碼器[配置參考](../../../Configurationreference/HTTPfilters/gRPCJSONtranscoderfilter.md)。 ### filter.http.GrpcJsonTranscoder [filter.http.GrpcJsonTranscoder proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/filter/http/transcoder.proto#L9) ``` { "proto_descriptor": "...", "services": [], "print_options": "{...}" } ``` - **proto_descriptor**<br /> ([string](https://developers.google.com/protocol-buffers/docs/proto#scalar), REQUIRED) 為gRPC服務提供二進制`protobuf`描述符集合。描述符集合必須包含服務中使用的所有類型。確保為`protoc`，并使用`--include_import`選項。 要為gRPC服務生成一個`protobuf`描述符集，在運行`protoc`之前，還需要從Github中克隆google apis庫，因為在`include`路徑中需要`annotations.proto`。 ``` git clone https://github.com/googleapis/googleapis GOOGLEAPIS_DIR=<your-local-googleapis-folder> ``` 然后運行protoc從`bookstore.proto`生成描述符： ``` protoc -I$(GOOGLEAPIS_DIR) -I. --include_imports --include_source_info \ --descriptor_set_out=proto.pb test/proto/bookstore.proto ``` 如果您有許多原始源文件，則可以使用通過這個命令來傳遞所有文件。 - **services**<br /> ([string](https://developers.google.com/protocol-buffers/docs/proto#scalar), REQUIRED) 提供將要轉換的服務名的字符串列表。如果服務名在`proto_descriptor`中不存在，Envoy則啟動失敗。`proto_descriptor`可能包含比這里指定的服務名稱更多的服務，但是它們不會被轉換。 - **print_options**<br /> ([filter.http.GrpcJsonTranscoder.PrintOptions](#filterhttpgrpcjsontranscoderprintoptions)) 響應JSON的控制選項。這些選項直接傳遞給[JsonPrintOptions](https://developers.google.com/protocol-buffers/docs/reference/cpp/google.protobuf.util.json_util#JsonPrintOptions)。 ### filter.http.GrpcJsonTranscoder.PrintOptions [filter.http.GrpcJsonTranscoder.PrintOptions proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/filter/http/transcoder.proto#L39) ``` { "add_whitespace": "...", "always_print_primitive_fields": "...", "always_print_enums_as_ints": "...", "preserve_proto_field_names": "..." } ``` - **add_whitespace**<br /> ([bool](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 是否添加空格，換行符和縮進以使輸出的JSON易于閱讀。默認為false。 - **always_print_primitive_fields**<br /> ([bool](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 是否始終打印原始字段。默認情況下，具有默認值的原始字段將在JSON輸出中被省略。例如，設置為0的int32字段將被省略。將此標志設置為true，將覆蓋默認行為并打印原始字段，而不考慮其值。默認為false。 - **always_print_enums_as_ints**<br /> ([bool](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 是否始終打印枚舉作為整數。默認情況下，它們呈現為字符串。默認為false。 - **preserve_proto_field_names**<br /> ([bool](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 是否保留原始字段名稱。默認情況下，`protobuf`將使用`json_name`選項生成JSON字段名稱，或者按照下面的順序生成較低的駱駝風格的大小寫。設置此標志將保留原始字段名稱。默認為false。 ## 返回 - [上一級](../HTTPfilters.md) - [首頁目錄](../../../README.md)