-
Notifications
You must be signed in to change notification settings - Fork 35
Split definition of messages for unidirectional and bidirectional streams #503
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
This does minimal editing to the existing text, and mostly moves things around.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Individual Review:
This split makes sense and helps implementers know that you can write one parser for control messages and another for data streams, rather than implementing them all in one place like I did (and have to undo) in moxygen.
|------:|:----------------------------------------------------| | ||
| 0x0 | OBJECT_STREAM ({{object-stream}}) | | ||
|-------|-----------------------------------------------------| | ||
| 0x1 | OBJECT_DATAGRAM ({{object-datagram}}) | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should we give OBJECT_DATAGRAM code point 0 also to avoid the problem in #410
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Probably yes, though probably not in this PR.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Given that both OBJECT_STREAM and OBJECT_DATAGRAM have the same fields and objects with forwarding preference "Datagram" are either sent as datagrams or dropped, is there a reason to keep both messages instead of using the same type? That would avoid the problem of receiving datagrams on streams, too.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
oh I see that was your suggestion. Please ignore :D
Co-authored-by: Zafer Gürel <[email protected]>
|
||
|
||
# Data Streams {#data-streams} | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
May be we need to add a note on what are Data Streams for ?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good point, I added a sentence.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM . Had a small nit .
This is technically not purely editorial, but should be backwards-compatible in practice.
This PR does minimal editing to the existing text, and mostly moves things around. The text in "Data Streams" section needs more cleanup (e.g. to stop referring to "OBJECT messages" that haven't been a thing for a while), but this is out of scope for this PR.