3.0.0-RC0

Maven

This is an early release for 3.0.0 to verify the release process still works for the new artifact location.

This release note does not detail the changes since 2.2.x. Please check out the wiki page What's different in 3.0 from time to time for the details and migration guide.

API changes

• Add eager truncation to bounded replay() to avoid item retention (#6532)
• Add X.fromSupplier() (#6529)
• Add concatMap with Scheduler guaranteeing where the mapper function runs (#6538)
• Add startWithItem & startWithIterable (#6530)
• ConnectableFlowable/ConnetableFlowable redesign (#6519)
• Merge as() into to() (#6514)
• Change Maybe.defaultIfEmpty() to return Single (#6517)
• Widen functional interface throws, replace Callable with Supplier in operator signatures (#6511)
• Promote Beta/Experimental operators to Standard (#6537)
• Remove getValues() from some subjects/processors (#6516)
• Remove methods from test consumers, make internal versions (#6526)
• Remove replay(Scheduler) and its overloads (#6539)
• Remove dematerialize() (#6539)
• Remove startWith(T|Iterable) (#6530)
• Remove as() (#6514)
• Remove Maybe.toSingle(T) (#6517)
• Remove Flowable.subscribe(4 args) (#6517)
• Remove Observable.subscribe(4 args) (#6517)
• Remove Single.toCompletable() (#6517)
• Remove Completable.blockingGet() (#6517)

Behavior changes

• Make using() resource disposal order consistent with eager-mode (#6534)
• ConnectableFlowable/ConnetableFlowable redesign (#6519)
• Add eager truncation to bounded replay() to avoid item retention (#6532)

Bugfixes

• Fix concatMapDelayError not continuing on fused inner source crash (#6523)
• Sync up with 2.2.10 snapshot (#6507)
• Merge in changes from 2.x since the initial branching (#6498)

Documentation enhancements

• Clarify create emitters are per consumer (#6535)
• Add marbles to X.fromSupplier (#6531)
• Sync up with 2.2.10 snapshot (#6507)
• Merge in changes from 2.x since the initial branching (#6498)

Other

• Remove Changes.md (#6533)
• Remove test from testXXX method names, create a validator (#6525)
• Sync up with 2.2.10 snapshot (#6507)
• Merge in changes from 2.x since the initial branching (#6498)

2.2.10

Maven

Bugfixes

• Pull 6499: Add missing null check to BufferExactBoundedObserver.
• Pull 6505: Fix publish().refCount() hang due to race.
• Pull 6522: Fix concatMapDelayError not continuing on fused inner source crash.

Documentation changes

• Pull 6496: Fix outdated links in Additional-Reading.md.
• Pull 6497: Fix links in Alphabetical-List-of-Observable-Operators.md.
• Pull 6504: Fix various Javadocs & imports.
• Pull 6506: Expand the Javadoc of Flowable.
• Pull 6510: Correct "Reactive-Streams" to "Reactive Streams" in documentation.

2.2.9

Maven

Bugfixes

• Pull 6488: Fix zip not stopping the subscription upon eager error.

Documentation changes

• Pull 6453: Fixed wrong type referenced in Maybe and Single JavaDocs.
• Pull 6458: Update the Javadoc of the retry operator.

Other

• Pull 6452: Remove dependency of Schedulers from ObservableRefCount.
• Pull 6461: Change error message in ObservableFromArray.
• Pull 6469: Remove redundant methods from sample(Observable).
• Pull 6470: Remove unused import from Flowable.java.
• Pull 6485: Remove unused else from the Observable.

2.2.8

Maven

Bugfixes

• Pull 6442: Add missing undeliverable error handling logic for Completable.fromRunnable & fromAction operators.

Documentation changes

• Pull 6432: Improve the docs of CompositeDisposable.
• Pull 6434: Improve subjects and processors package doc.
• Pull 6436: Improve Creating-Observables wiki doc.

Other

• Pull 6433: Make error messages of parameter checks consistent.

2.2.7

Maven

API enhancements

• Pull 6386: Add doOnTerminate to Single/Maybe for consistency.

Bugfixes

• Pull 6405: Fix concatEager to dispose sources & clean up properly.
• Pull 6398: Fix window() with start/end selector not disposing/cancelling properly.

Documentation changes

• Pull 6377: Expand Observable#debounce and Flowable#debounce javadoc.
• Pull 6408: Improving Javadoc of flattenAsFlowable and flattenAsObservable methods.

2.2.6

Maven

API enhancements

• Pull 6370: Add interruptible mode via the new Schedulers.from(Executor, boolean) overload.

Bugfixes

• Pull 6359: Fix the error/race in Observable.repeatWhen due to flooding repeat signal.
• Pull 6362 : Fix Completable.andThen(Completable) not running on observeOn's Scheduler.
• Pull 6364: Fix Flowable.publish not requesting upon client change.
• Pull 6371: Fix bounded replay() memory leak due to bad node retention.
• Pull 6375: Don't dispose the winner of {Single|Maybe|Completable}.amb().
• Pull 6380: Fix CompositeException.getRootCause() detecting loops in the cause graph.

Documentation changes

• Pull 6365: Indicate source disposal in timeout(fallback).

Other changes

• Pull 6353: Use ignoreElement to convert Single to Completable in the README.md.

2.2.5

Maven

Documentation changes

• Pull 6344: Use correct return type in JavaDocs documentation in elementAtOrDefault.
• Pull 6346: Fix JavaDoc examples using markdown instead of @code.

Wiki changes

• Pull 6324: Java 8 version for Problem-Solving-Examples-in-RxJava.
• Pull 6343: Update Filtering Observables docs.
• Pull 6351: Updated java example in How-To-Use-RxJava.md file with java 8 version.

Other changes

• Pull 6313: Adding @NonNull annotation factory methods.
• Pull 6335: Replace indexed loop with for-each java5 syntax.

2.2.4

Maven

API changes

• Pull 6278: Add Maybe/Single/Completable materialize operator,
• Pull 6278: Add Single.dematerialize(selector) operator.
• Pull 6281: Add Flowable/Observable dematerialize(selector) operator.

Bugfixes

• Pull 6258: Fix cancel/dispose upon upstream switch for some operators.
• Pull 6269: Call the doOn{Dispose|Cancel} handler at most once.
• Pull 6283: Fix Observable.flatMap to sustain concurrency level.
• Pull 6297: Fix refCount eager disconnect not resetting the connection.

Documentation changes

• Pull 6280: Improve the package docs of io.reactivex.schedulers.
• Pull 6301: Add missing onSubscribe null-checks to NPE docs on Flowable/Observable subscribe.
• Pull 6303: Fix incorrect image placement in Flowable.zip docs.
• Pull 6305: Explain the non-concurrency requirement of the Emitter interface methods.
• Pull 6308: Explain the need to consume both the group sequence and each group specifically with Flowable.groupBy.
• Pull 6311: Explain that distinctUntilChanged requires non-mutating data to work as expected.

Wiki changes

• Pull 6260: Add generate examples to Creating-Observables.md.
• Pull 6267: Fix Creating-Observables.md docs stlye mistake.
• Pull 6273: Fix broken markdown of How-to-Contribute.md.
• Pull 6266: Update Error Handling Operators docs.
• Pull 6291: Update Transforming Observables docs.

Other changes

• Pull 6262: Use JUnit's assert format for assert messages for better IDE interoperation.
• Pull 6263: Inline SubscriptionHelper.isCancelled().
• Pull 6275: Improve the Observable/Flowable cache() operators.
• Pull 6287: Expose the Keep-Alive value of the IO Scheduler as System property.
• Pull 6321: Fix Flowable.toObservable backpressure annotation.

2.2.3

Maven

API changes

• Pull 6242: Add timed Completable.delaySubscription() operator.

Documentation changes

• Pull 6220: Remove unnecessary 's' from ConnectableObservable.
• Pull 6241: Remove mention of io.reactivex.functions.Functions nonexistent utility class.

Other changes

• Pull 6232: Cleanup Observable.flatMap drain logic.
• Pull 6234: Add timeout and unit to TimeoutException message in the timeout operators.
• Pull 6236: Adjust UndeliverableException and OnErrorNotImplementedException message to use the full inner exception.
• Pull 6244: Add @Nullable annotations for blocking methods in Completable.

2.2.2

Maven

Bugfixes

• Pull 6187: Fix refCount termination-reconnect race.

Documentation changes

• Pull 6171: Add explanation text to Undeliverable & OnErrorNotImplemented exceptions.
• Pull 6174: Auto-clean up RxJavaPlugins JavaDocs HTML.
• Pull 6175: Explain null observer/subscriber return errors from RxJavaPlugins in detail.
• Pull 6180: Update Additional-Reading.md.
• Pull 6180: Fix Flowable.reduce(BiFunction) JavaDoc; the operator does not signal NoSuchElementException.
• Pull 6193: Add "error handling" java docs section to fromCallable & co.
• Pull 6199: Fix terminology of cancel/dispose in the JavaDocs.
• Pull 6200: Fix toFuture marbles and descriptions.