This library is a Java implementation of Rx Observables.
Some of the goals of RxJava are:
- Stay close to the original Rx.Net implementation while adjusting naming conventions and idioms to Java
- All contracts of Rx should be the same
- Target the JVM not a language. The first languages supported (beyond Java itself) are Groovy, Clojure, and Scala. New language adapters can be contributed.
- Support Java 6+ (to include Android support)
Learn more about Rx on the Wiki Home and the Netflix TechBlog post where RxJava was introduced.
- Google Group: RxJava
- Twitter: @RxJava
- GitHub Issues
RxJava is working towards a 1.0 release which will be reached once it "more or less" becomes feature complete with the Rx.Net version. The backlog of features needed to accomplish this are documented in the project issues.
In short, once the current issue list hits 0 open we will bump to version 1.0.
Until that time the "semantic versioning" will be prefixed with the 0.* and breaking changes will be done such as 0.5.x -> 0.6.x All incremental non-breaking changes with additive functionality will be done like 0.5.1 -> 0.5.2.
Once we hit 1.0 it will follow the normal major.minor.patch semantic versioning approach.
Binaries and dependency information for Maven, Ivy, Gradle and others can be found at http://search.maven.org.
Example for Maven:
<dependency>
<groupId>com.netflix.rxjava</groupId>
<artifactId>rxjava-core</artifactId>
<version>x.y.z</version>
</dependency>
and for Ivy:
<dependency org="com.netflix.rxjava" name="rxjava-core" rev="x.y.z" />
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"?>
<project xmlns="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>x.y.z</version>
<scope/>
</dependency>
</dependencies>
</project>
Then execute:
mvn -f download-rxjava-pom.xml dependency:copy-dependencies
It will download rxjava-core-*.jar and its dependencies into ./target/dependency/.
You need Java 6 or later.
To build:
$ git clone git@github.com:Netflix/RxJava.git
$ cd RxJava/
$ ./gradlew build
Futher details on building can be found on the Getting Started page of the wiki.
For bugs, questions and discussions please use the Github Issues.
Copyright 2013 Netflix, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.