docs(kitex): improve transport protocol#1329
Closed
panda-xinyi wants to merge 19 commits intocloudwego:mainfrom
Closed
docs(kitex): improve transport protocol#1329panda-xinyi wants to merge 19 commits intocloudwego:mainfrom
panda-xinyi wants to merge 19 commits intocloudwego:mainfrom
Conversation
DMwangnima
reviewed
May 12, 2025
| 在理解 Kitex 的协议支持前，有必要明确两个概念： | ||
|
|
||
| - **消息协议（Message Protocol）**：定义了数据如何序列化/反序列化的格式，如 Thrift、Protobuf 等 | ||
| - **传输协议（Transport Protocol）**：定义了消息如何在网络中传输，包括头部信息、元数据等，如 TTHeader、HTTP/2 等 |
DMwangnima
reviewed
May 12, 2025
| - Framed 和 TTHeader 也可以结合使用，所以有 TTHeaderFramed 。 | ||
| - **Protobuf 的两种使用模式**：Kitex 对 Protobuf 的支持有 Kitex Protobuf 和 gRPC 两种模式 | ||
| - **Kitex Protobuf**：仅使用 Protobuf 作为消息协议（Payload 编码），传输协议可以自由选择（如 TTHeader、Framed 等） | ||
| - **gRPC**：完整的 gRPC 协议栈，**固定使用 Protobuf 作为消息协议**（必须使用 .proto 文件，不支持 Thrift IDL），HTTP/2 作为传输协议 |
Contributor
There was a problem hiding this comment.
咱们的 Kitex gRPC 是支持 Thrift 的，这个文档有点过时了
Contributor
There was a problem hiding this comment.
在 Thrift Streaming 中，底层的传输协议就是 gRPC
…rts and standardized terms
… streaming documentation
GuangmingLuo
changed the title
panda-xinyi
force-pushed
the
docs/improve-transport-protocol
branch
2 times, most recently
from
7c0fa7c to
906686b
Compare
…rotocol combinations and configuration examples
panda-xinyi
force-pushed
the
docs/improve-transport-protocol
branch
from
906686b to
1a1fbd7
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What type of PR is this?
docs(kitex): improve transport protocol documentation with clearer explanations
Check the PR title.
(Optional) Translate the PR title into Chinese.
(Optional) More detailed description for this PR(en: English/zh: Chinese).
en:
zh(optional):
(Optional) Which issue(s) this PR fixes: