Getting Started

Getting Binaries

You can find binaries and dependency information for Maven, Ivy, Gradle, and others at http://search.maven.org.

Example for Maven:

<dependency>
<groupId>com.netflix.rxjava</groupId>
<artifactId>rxjava-core</artifactId>
<version>0.5.0</version>
</dependency>

and for Ivy:

<dependencyorg="com.netflix.rxjava"name="rxjava-core"rev="0.5.0" />

If you need to download the jars instead of using a build system, create a Maven pom file like this with the desired version:

<?xml version="1.0"?>
<projectxmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.netflix.rxjava.download</groupId>
<artifactId>rxjava-download</artifactId>
<version>1.0-SNAPSHOT</version>
<name>Simple POM to download rxjava-core and dependencies</name>
<url>http://github.com/Netflix/RxJava</url>
<dependencies>
<dependency>
<groupId>com.netflix.rxjava</groupId>
<artifactId>rxjava-core</artifactId>
<version>0.5.0</version>
<scope/>
</dependency>
</dependencies>
</project>

Then execute:

$ mvn -f download-rxjava-pom.xml dependency:copy-dependencies

That command downloads rxjava-core-*.jar and its dependencies into ./target/dependency/.

You need Java 6 or later.

Hello World!

The following are RxJava implementations of “Hello World” in Java, Groovy, and Clojure:

In Java =>

publicstaticvoidhello(String... names) {
Observable.toObservable(names).subscribe(newAction1<String>() {
@Overridepublicvoidcall(Strings) {
System.out.println("Hello " + s + "!");
}
});
}

In Groovy =>

defhello(String[] names) {
Observable.toObservable(names)
.subscribe({ println"Hello "+ it +"!"})
}

In Clojure =>

(defnhello
[&rest]
(-> (Observable/toObservable &rest)
(.subscribe #(println (str"Hello " % "!")))))

You can find more examples and information in the How To Use section.

You can find example source code in the rxjava-examples module.

Building

To check out and build the RxJava source, issue the following commands:

$ git clone git@github.com:Netflix/RxJava.git
$ cd RxJava/
$ ./gradlew build

To do a clean build, issue the following command:

$ ./gradlew clean build

A build should look similar to this:

$ ./gradlew build
:rxjava-core:compileJava
:rxjava-core:processResources UP-TO-DATE
:rxjava-core:classes
:rxjava-core:jar
:rxjava-core:sourcesJar
:rxjava-core:signArchives SKIPPED
:rxjava-core:assemble
:rxjava-core:licenseMain UP-TO-DATE
:rxjava-core:licenseTest UP-TO-DATE
:rxjava-core:compileTestJava
:rxjava-core:processTestResources UP-TO-DATE
:rxjava-core:testClasses
:rxjava-core:test
:rxjava-core:check
:rxjava-core:build
BUILD SUCCESSFUL
Total time: 30.758 secs

On a clean build you will see the unit tests run. They will look something like this:

> Building > :rxjava-core:test > 91 tests completed