RxJava入门指南

RxJava是 ReactiveX 在JVM上的一个实现,ReactiveX使用Observable序列组合异步和基于事件的程序。更多关于ReactiveX的资料,可以查看 ReactiveX 介绍 页面。

RxJava介绍

RxJava 是轻量级的

RxJava尽力做到非常轻巧。它仅关注Observable的抽象和与之相关的高层函数,实现为一个单独的JAR文件。

RxJava 是一个多语言实现

RxJava 支持Java 6或者更新的版本,以及其它的JVM语言如 Groovy, Clojure, JRuby, Kotlin 和 Scala。RxJava 可用于更多的语言环境,而不仅仅是Java和Scala,而且它致力于尊重每一种JVM语言的习惯。

RxJava 第三方库

下面是可与RxJava协作的第三方库:

Hystrix - 用于分布式系统的一个延时和容错处理框架

Camel RX - 一个用于Apache Camel 的 RxJava 兼容层

rxjava-http-tail - 让你可以跟踪HTTP日志,就像使用 tail -f 一样

mod-rxvertx - Extension for VertX - 使用 RxJava 封装的VertX库

rxjava-jdbc - 使用RxJava流式处理JDBC连接,还支持语句的函数式组合

rtree - 使用RxJava实现的一个纯内存的可变的R-tree和R*-tree

使用指南

你可以在Maven Central http://search.maven.org 找到用于Maven, Ivy, Gradle, SBT和其它构建工具需要的二进制文件和依赖信息.

Maven示例:

io.reactivex

rxjava

1.0.10

Ivy示例:

SBT示例:

libraryDependencies += "com.netflix.rxjava" % "rxjava-scala" % "1.0.10"

Gradle示例:

compile 'io.reactivex:rxjava:1.0.10'

如果你没有使用构建系统,想直接下载JAR文件的话可以在这里找到:

https://repo1.maven.org/maven2/io/reactivex/

编译构建

检出和构建RxJava的源码,使用以下命令:

$ git clone [email protected]:ReactiveX/RxJava.git

$ cd RxJava/

$ ./gradlew build

要执行一个完整的构建,使用这个命令:

$ ./gradlew clean build

构建命令的输出大概是这样的:

$ ./gradlew build

:rxjava:compileJava

:rxjava:processResources UP-TO-DATE

:rxjava:classes

:rxjava:jar

:rxjava:sourcesJar

:rxjava:signArchives SKIPPED

:rxjava:assemble

:rxjava:licenseMain UP-TO-DATE

:rxjava:licenseTest UP-TO-DATE

:rxjava:compileTestJava

:rxjava:processTestResources UP-TO-DATE

:rxjava:testClasses

:rxjava:test

:rxjava:check

:rxjava:build

BUILD SUCCESSFUL

Total time: 30.758 secs

执行完整的构建的话,你会看到单元测试的执行,输出类似于这样:

> Building > :rxjava:test > 91 tests completed

故障排除

有一位开发者上报了下面这个错误:

Could not resolve all dependencies for configuration ':language-adaptors:rxjava-scala:provided'

他在从.gradle/caches和.m2/repository/org/scala-lang/移除了旧版本的 scala-library之后解决了这个问题,然后执行了一次完整构建。(查看详细信息)

在构建RxJava时你可能会遇到下面的错误:

Failed to apply plugin [id 'java']

Could not generate a proxy class for class nebula.core.NamedContainerProperOrder.

这是JVM的问题,详细信息可以参考 GROOVY-6951 。如果遇到这个问题,可以在构建RxJava之前执行 export GRADLE_OPTS=-noverify,或者升级你机器上的JDK。

Top