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

2.x: Improve BehaviorSubject JavaDoc + related clarifications #5780

Merged
merged 2 commits into from
Jan 3, 2018

Conversation

akarnokd
Copy link
Member

This PR adds detailed behavior and feature description to the BehaviorSubject JavaDoc.

In addition, small mistakes in the BehaviorProcessor JavaDoc have also been fixed and both received an extra section: Error handling that points at the global error handler for undeliverable errors. Due to this link, the RxJavaPlugins.onError JavaDoc has been also expanded.

@codecov
Copy link

codecov bot commented Dec 27, 2017

Codecov Report

Merging #5780 into 2.x will decrease coverage by 0.06%.
The diff coverage is n/a.

Impacted file tree graph

@@             Coverage Diff              @@
##                2.x    #5780      +/-   ##
============================================
- Coverage     96.27%   96.21%   -0.07%     
- Complexity     5807     5809       +2     
============================================
  Files           634      634              
  Lines         41607    41607              
  Branches       5770     5770              
============================================
- Hits          40057    40031      -26     
- Misses          611      634      +23     
- Partials        939      942       +3
Impacted Files Coverage Δ Complexity Δ
...ava/io/reactivex/processors/BehaviorProcessor.java 91.03% <ø> (-4.04%) 60 <0> (+1)
...in/java/io/reactivex/subjects/BehaviorSubject.java 86.24% <ø> (-5.83%) 54 <0> (ø)
.../main/java/io/reactivex/plugins/RxJavaPlugins.java 100% <ø> (ø) 146 <0> (ø) ⬇️
.../operators/observable/ObservableFlatMapSingle.java 88.8% <0%> (-6.72%) 2% <0%> (ø)
...erators/flowable/FlowableOnBackpressureLatest.java 94.59% <0%> (-5.41%) 2% <0%> (ø)
...ernal/operators/flowable/FlowableFlatMapMaybe.java 91.3% <0%> (-3.39%) 2% <0%> (ø)
...rnal/operators/flowable/FlowableFlatMapSingle.java 92.39% <0%> (-2.72%) 2% <0%> (ø)
...ain/java/io/reactivex/subjects/PublishSubject.java 97.8% <0%> (-2.2%) 38% <0%> (-1%)
... and 28 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 7e503f0...a62d63a. Read the comment docs.

* @param error the error to report
* @see #getErrorHandler()
* @see #setErrorHandler(Consumer)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@akarnokd
Do you think it makes sense to reference
https://github.com/ReactiveX/RxJava/wiki/What's-different-in-2.0#error-handling
here?
Is it acceptable to reference Wiki from javadoc?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated.

@@ -337,7 +337,23 @@ public static Scheduler onComputationScheduler(@NonNull Scheduler defaultSchedul

/**
* Called when an undeliverable error occurs.
* <p>
* Undeliverable errors are those {@code Observer.onError()} invocations that are not allowed happen to

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit:
.. that are not allowed to happen to ...
?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated.

@akarnokd akarnokd merged commit 8b11ea8 into ReactiveX:2.x Jan 3, 2018
@akarnokd akarnokd deleted the BehaviorSubjectBetterJavaDoc branch January 3, 2018 11:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants