## gRPC-JSON轉碼過濾器 gRPC-JSON轉碼[配置概述](../../Configurationreference/HTTPfilters/gRPCJSONtranscoderfilter.md)。 ### gRPC-JSON轉碼配置 過濾器配置所需要描述符文件以及要轉碼的gRPC服務列表。 ``` { "name": "grpc_json_transcoder", "config": { "proto_descriptor": "proto.pb", "services": ["grpc.service.Service"], "print_options": { "add_whitespace": false, "always_print_primitive_fields": false, "always_print_enums_as_ints": false, "preserve_proto_field_names": false } } } ``` - **proto_descriptor**<br /> (required, string) 為gRPC服務提供二進制`protobuf`描述符集。描述符集必須包含在服務中使用的所有類型。確保為`protoc`使用`--include_import`選項。 要為gRPC服務生成一個`protobuf`描述符集，在運行`protoc`之前，還需要從Github中克隆`googleapis`倉庫，因為在`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 /> (required, array) 提供代碼轉換器進行轉碼服務的服務器名稱列表。如果服務名稱在`proto_descriptor`中不存在，Envoy將啟動失敗。`proto_descriptor`可能包含比這里指定的服務名稱更多的服務，但是它們不會進行轉碼。 - **print_options**<br /> (optional, object) 響應json的控制選項。這些選項直接傳遞給[JsonPrintOptions](https://developers.google.com/protocol-buffers/docs/reference/cpp/google.protobuf.util.json_util#JsonPrintOptions)。有效的選項是： - **add_whitespace**<br /> (optional, boolean) 是否添加空格，換行符和縮進以使輸出的JSON易于閱讀。默認為false。 - **always_print_primitive_fields**<br /> (optional, boolean) 是否始終打印原始字段。默認情況下，具有默認值的原始字段將在JSON輸出中被省略。例如，設置為0的`int32`字段將被省略。將此標志設置為true，將覆蓋默認行為并打印原始字段，而不考慮其值。默認為false。 - **always_print_enums_as_ints**<br /> (optional, boolean) 是否始終打印枚舉作為整數。默認情況下，它們呈現為字符串。默認為false。 - **preserve_proto_field_names**<br /> (optional, boolean) 是否保留原始字段名稱。默認情況下，`protobuf`將使用`json_name`選項生成JSON字段名稱，或者按照下面的順序生成較低的駱駝大小寫。設置此標志將保留原始字段名稱。默認為false。 ## 返回 - [上一級](../HTTPfilters.md) - [首頁目錄](../../README.md)