Skip to content

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

Merged
merged 4 commits into from
Aug 7, 2024

Conversation

vasilvv
Copy link
Collaborator

@vasilvv vasilvv commented Aug 7, 2024

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.

This does minimal editing to the existing text, and mostly moves things
around.
@vasilvv vasilvv requested a review from ianswett August 7, 2024 14:31
Copy link
Collaborator

@afrind afrind left a 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}}) |
Copy link
Collaborator

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

Copy link
Collaborator Author

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.

Copy link
Contributor

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.

Copy link
Contributor

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



# Data Streams {#data-streams}

Copy link
Collaborator

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 ?

Copy link
Collaborator

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.

Copy link
Collaborator

@suhasHere suhasHere left a 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 .

@ianswett ianswett merged commit e1f5486 into moq-wg:main Aug 7, 2024
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants