Skip to content
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

Read/WriteObserver: give users visibility into items #2013

Merged
merged 3 commits into from
Dec 14, 2021

Conversation

idelpivnitskiy
Copy link
Member

@idelpivnitskiy idelpivnitskiy commented Dec 11, 2021

Motivation:

Existing ReadObserver and WriteObserver API sends signals without
letting users know what exactly was read or written.

Modifications:

  • Add ReadObserver#itemRead(Object), deprecate ReadObserver#itemRead();
  • Add WriteObserver#itemReceived(Object), deprecate WriteObserver#itemReceived();
  • Add WriteObserver#itemWritten(Object), deprecate WriteObserver#itemWritten();
  • Add WriteObserver#itemFlushed(Object);
  • Update tests and implementations;

Result:

Users can see what items have been read or written at L4 level.

Motivation:

Existing `ReadObserver` and `WriteObserver` API sends signals without
letting users know what exactly was read or written.

Modifications:

- Add `ReadObserver#itemRead(Object)`, deprecate `ReadObserver#itemRead()`;
- Add `WriteObserver#itemReceived(Object)`, deprecate `WriteObserver#itemReceived()`;
- Add `WriteObserver#itemWritten(Object, long)`, deprecate `WriteObserver#itemWritten()`;
- Add `WriteObserver#itemFlushed(Object)`;
- Update tests and implementations;

Result:

Users can see what items have been read or written at L4 level.
idelpivnitskiy added a commit to idelpivnitskiy/servicetalk that referenced this pull request Dec 11, 2021
Motivation:

apple#2013 deprecates some methods on `Read/WriteObserver`.

Modifications:

- Swap default impl from new to deprecated method;

Result:

Users can remove usage of the deprecated methods.
@idelpivnitskiy idelpivnitskiy self-assigned this Dec 11, 2021
idelpivnitskiy added a commit to idelpivnitskiy/servicetalk that referenced this pull request Dec 11, 2021
Motivation:

apple#2013 deprecates some methods on `Read/WriteObserver`.

Modifications:

- Swap default impl from new to deprecated method;

Result:

Users can remove usage of the deprecated methods.
idelpivnitskiy added a commit to idelpivnitskiy/servicetalk that referenced this pull request Dec 11, 2021
Motivation:

apple#2013 deprecates some methods on `Read/WriteObserver`.

Modifications:

- Swap default impl from new to deprecated method;

Result:

Users can remove usage of the deprecated methods.
idelpivnitskiy added a commit to idelpivnitskiy/servicetalk that referenced this pull request Dec 11, 2021
Motivation:

Modifications:

- Swap default impl from new to deprecated method;

Result:

Users can remove usage of the deprecated methods.
@bondolo bondolo added the API PR with API changes (New or Deprecated) label Dec 13, 2021
@idelpivnitskiy idelpivnitskiy merged commit afbe03d into apple:main Dec 14, 2021
@idelpivnitskiy idelpivnitskiy deleted the items branch December 14, 2021 01:02
idelpivnitskiy added a commit that referenced this pull request Dec 14, 2021
Motivation:

Existing `ReadObserver` and `WriteObserver` API sends signals without
letting users know what exactly was read or written.

Modifications:

- Add `ReadObserver#itemRead(Object)`, deprecate `ReadObserver#itemRead()`;
- Add `WriteObserver#itemReceived(Object)`, deprecate `WriteObserver#itemReceived()`;
- Add `WriteObserver#itemWritten(Object)`, deprecate `WriteObserver#itemWritten()`;
- Add `WriteObserver#itemFlushed(Object)`;
- Update tests and implementations;

Result:

Users can see what items have been read or written at L4 level.
idelpivnitskiy added a commit that referenced this pull request Dec 14, 2021
Motivation:

#2013 deprecates some methods on `Read/WriteObserver`.

Modifications:

- Swap default impl from new to deprecated method;

Result:

Users can remove usage of the deprecated methods.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
API PR with API changes (New or Deprecated)
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants