RxJava makes it easy to write asynchronous and concurrent applications. To be able to do that you will have to write programs that get executed on multiple threads. In this article I will show how RxJava helps in writing multithreaded programs using Scheduler and Observable’s subscribeOn() and observeOn() methods.

The code samples for this article can be found here. This article is third in the series of RxJava articles that I am writing. Part 1 can be found here and Part 2 can be found here.

Default Threading Behaviour of RxJava

An RxJava construct is composed of one Observable followed by zero or more Operators followed by one Subscriber. The default threading behavior for such a construct can be described as below:

  • The computation declared as part of an Observable gets executed on the thread from where the subscribe() method is called.
  • The computation declared as part of an Operator gets executed on the thread where the computation of previous Operator is executed. If there is no Operator declared before the current Operator, it gets executed on the thread where the computation of the Observable is executed.
  • The computation declared as part of a Subscriber gets executed on the thread where the computation of previous Operator is executed. If there is no Operator declared before the Subscriber, it gets executed on the thread where the computation of the Observable is executed.

From the code sample below the default behaviour becomes evident. Notice the names of threads printed in the output. All the three, the Observable, the Operator and the Subscriber get executed on the main thread. Hence we can say that by default the execution of RxJava is blocking.

public static void main(String[] args) {
    Observable.fromCallable(thatReturnsNumberOne())     // the Observable
            .map(numberToString())                      // the Operator
            .subscribe(printResult());                  // the Subscriber
}

/*
    Output of the above program:
    ---------------------------
    Observable thread: main
    Operator thread: main
    Subscriber thread: main
    Result: 1
*/

        
private Callable<Integer> thatReturnsNumberOne() {
    return () -> {
        System.out.println("Observable thread: " + Thread.currentThread().getName());
        return 1;
    };
}

private Func1<Integer, String> numberToString() {
    return number -> {
        System.out.println("Operator thread: " + Thread.currentThread().getName());
        return String.valueOf(number);
    };
}

private Action1<String> printResult() {
    return result -> {
        System.out.println("Subscriber thread: " + Thread.currentThread().getName());
        System.out.println("Result: " + result);
    };
}

Scheduler

Scheduler in RxJava defines the thread on which a unit of work will be performed. RxJava provides a few Schedulers out of the box. Some of them are Schedulers.newThread(), Schedulers.computation(), Schedulers.io() and Schedulers.from(Executor). I will be showing the usage of Scheduler in the upcoming sections.

Changing execution thread using SubscribeOn

The subscribeOn method tells the RxJava library to perform the computation, declared as part of the Observable, on a thread provided by the Scheduler. In the example below the subscribeOn(Schedulers.newThread()) instructs RxJava to do the computation on a new thread. Check the output of code below to see this behaviour in action. Notice the names of the threads printed in the output.

As defined by the default behaviour, the computations as part of Operator and the Subscriber run on the thread which Observable runs, which in this case is a new thread. The output below also shows this behaviour.

What happens if I have multiple subscribeOn declarations?

In case of multiple declaration of subscribeOns, only the first declaration takes preference. This is because the Observable computation can be executed only on one thread.

Why the name subscribeOn?

This is because the computation as part of Observable gets executed only when the subscribe() method is called on the Observable.

public static void main(String[] args) {
    Observable.fromCallable(thatReturnsNumberOne())
            .subscribeOn(Schedulers.newThread())    // <<<<
            .map(numberToString())
            .subscribe(printResult());
}
/*
    Output of the above program:
    ---------------------------
    Observable thread: RxNewThreadScheduler-1
    Operator thread: RxNewThreadScheduler-1
    Subscriber thread: RxNewThreadScheduler-1
    Result: 1
*/

Changing execution thread using ObserveOn

The observeOn method tells RxJava library to perform the computation, as part of Operator or Subscriber declared after its definition, on a thread provided by the Scheduler.

What happens if I have multiple observeOn declarations?

If multiple observeOns are declared then computation declared after each of them gets performed on different threads defined by Scheduler.

Why the name observeOn?

This is because both the Operators and Subscriber observe the events/data emitted by Observable. Operators, after observing events/data, transmits them to subsequent Operators, if any, or transmits them to a Subscriber.

Below are code samples for the usage of observeOn. Notice the names of the threads printed in the output.

public static void main(String[] args) {
    Observable.fromCallable(thatReturnsNumberOne())
            .map(numberToString())
            .observeOn(Schedulers.newThread())      // subscriber on different thread
            .subscribe(printResult());
}
/*
    Output of the above program:
    ---------------------------
    Observable thread: main
    Operator thread: main
    Subscriber thread: RxNewThreadScheduler-1
    Result: 1
*/

public static void main(String[] args) {
    Observable.fromCallable(thatReturnsNumberOne())
            .observeOn(Schedulers.newThread())      // operator on different thread
            .map(numberToString())
            .subscribe(printResult());
}
/*
    Output of the above program:
    ---------------------------
    Observable thread: main
    Operator thread: RxNewThreadScheduler-1
    Subscriber thread: RxNewThreadScheduler-1
    Result: 1
*/

public static void main(String[] args) {
    Observable.fromCallable(thatReturnsNumberOne())
            .observeOn(Schedulers.newThread())      // operator on different thread
            .map(numberToString())
            .observeOn(Schedulers.newThread())      // subscriber on different thread
            .subscribe(printResult());
}
/*
    Output of the above program:
    ---------------------------
    Observable thread: main
    Operator thread: RxNewThreadScheduler-2
    Subscriber thread: RxNewThreadScheduler-1
    Result: 1
*/

Summary

RxJava makes it very easy to write multithreaded code using simple declarations as part of subscribeOn and observerOn in combination with Scheduler. If none of these threading utilities are declared then RxJava is by default blocking i.e. the computation gets done on the same thread where the declaration is done.


Update: In May 2016, I had done a talk on RxJava, where I had explained on how to think in RxJava. As this was an introductory talk on RxJava, it serves as a good addition to this blog post.

GeeCON 2016: Praveer Gupta - How to Think, in RxJava, Before Reacting from GeeCON Conference on Vimeo.