vertx 异步编程指南 step8-使用RxJava进行反应式编程
到目前为止,我们已经使用基于回调的API探索了Vert.x堆栈的各个领域。它只是起作用,并且这种编程模型在很多语言的开发人员中都是众所周知的。然而,它可能会变得有点乏味,特别是当你结合几个事件源或处理复杂的数据流时。
这正是RxJava发挥的作用,Vert.x可以无缝集成它。
注意
|
在本指南中,使用了RxJava 2.x,但Vert.x也适用于RxJava 1.x. RxJava 2.x在Reactive-Streams规范的基础上完全重写。在2.0 wiki页面的不同之处了解更多信息。 |
启用RxJava API
除了基于回调的API之外,Vert.x模块还提供了“Rxified” API。要启用它,首先将vertx-rx-java2
模块添加到Maven POM文件中:
<dependency> <groupId>io.vertx</groupId> <artifactId>vertx-rx-java2</artifactId> </dependency>
Verticle必须进行修改,以便扩展io.vertx.reactivex.core.AbstractVerticle
而不是io.vertx.core.AbstractVerticle
。这有什么不同?前一类扩展后者并暴露一个io.vertx.reactivex.core.Vertx
领域。
io.vertx.reactivex.core.Vertx
定义rxSomething(…)
与基于回调的对应方法等效的额外方法。
让我们来看看MainVerticle
如何更好地了解它在实践中的工作原理:
Single<String> dbVerticleDeployment = vertx.rxDeployVerticle(
"io.vertx.guides.wiki.database.WikiDatabaseVerticle");
该rxDeploy
方法不会将Handler<AsyncResult<String>>
最终参数作为参数。相反,它返回一个Single<String>
。
此外,调用该方法时操作不会启动。它在你订阅时开始Single
。操作完成后,它会发出部署id
或使用a指示问题的原因Throwable
。
按顺序部署Verticle
要最终确定MainVerticle
重构,我们必须确保部署操作按顺序触发并发生:
dbVerticleDeployment .flatMap(id -> { (1) Single<String> httpVerticleDeployment = vertx.rxDeployVerticle( "io.vertx.guides.wiki.http.HttpServerVerticle", new DeploymentOptions().setInstances(2)); return httpVerticleDeployment; }) .subscribe(id -> startFuture.complete(), startFuture::fail); (2)
-
该
flatMap
运营商应用功能的结果dbVerticleDeployment
。它在这里安排的部署HttpServerVerticle
。 -
订阅时开始操作。在成功或错误时,
MainVerticle
开始未来可能完成或失败。
部分“Rxifying” HttpServerVerticle
如果按顺序跟随指南,随时编辑代码,那么HttpServerVerticle
类仍然使用基于回调的API。在您可以使用RxJava API 自然执行异步操作之前,即 同时需要重构HttpServerVerticle
。
导入Vert.x类的RxJava版本
import io.vertx.reactivex.core.AbstractVerticle; import io.vertx.reactivex.core.http.HttpServer; import io.vertx.reactivex.ext.auth.AuthProvider; import io.vertx.reactivex.ext.auth.User; import io.vertx.reactivex.ext.auth.jwt.JWTAuth; import io.vertx.reactivex.ext.auth.shiro.ShiroAuth; import io.vertx.reactivex.ext.web.Router; import io.vertx.reactivex.ext.web.RoutingContext; import io.vertx.reactivex.ext.web.client.WebClient; import io.vertx.reactivex.ext.web.client.HttpResponse; (1) import io.vertx.reactivex.ext.web.codec.BodyCodec; import io.vertx.reactivex.ext.web.handler.*; import io.vertx.reactivex.ext.web.sstore.LocalSessionStore; import io.vertx.reactivex.ext.web.templ.FreeMarkerTemplateEngine; import org.slf4j.Logger; import org.slf4j.LoggerFactory;
-
我们的
backupHandler()
方法仍然使用HttpResponse
类,所以它必须导入。事实证明,HttpResponse
Vert.x提供的RxJava版本可以作为这种特定情况下的替代品。所述“Rxified”在代码step-8
作为响应类型由lambda表达式推断引导库的文件夹不导入此类。
在“Rxified” vertx
实例上使用委托
要调用一个方法,io.vertx.core.Vertx
当你有一个方法时io.vertx.reactivex.core.Vertx
,调用该getDelegate()
方法。start()
在创建以下实例时需要调整Verticle的方法 WikiDatabaseService
:
-
-
public void start(Future<Void> startFuture) throws Exception {
-
-
String wikiDbQueue = config().getString(CONFIG_WIKIDB_QUEUE, "wikidb.queue");
-
dbService = io.vertx.guides.wiki.database.WikiDatabaseService.createProxy(vertx.getDelegate(), wikiDbQueue);
同时执行授权查询
在前面的例子中,我们看到了如何使用RxJava操作符和Rxified Vert.x API按顺序执行异步操作。但有时候这种担保不是必需的,或者您只是希望它们为了性能原因而同时运行。
JWT令牌生成过程HttpServerVerticle
就是这种情况的一个很好的例子。要创建令牌,我们需要完成所有授权查询,但查询彼此独立:
-
auth.rxAuthenticate(creds).flatMap(user -> {
-
Single<Boolean> create = user.rxIsAuthorised("create"); (1)
-
Single<Boolean> delete = user.rxIsAuthorised("delete");
-
Single<Boolean> update = user.rxIsAuthorised("update");
-
-
return Single.zip(create, delete, update, (canCreate, canDelete, canUpdate) -> { (2)
-
return jwtAuth.generateToken(
-
new JsonObject()
-
.put("username", context.request().getHeader("login"))
-
.put("canCreate", canCreate)
-
.put("canDelete", canDelete)
-
.put("canUpdate", canUpdate),
-
new JWTOptions()
-
.setSubject("Wiki API")
-
.setIssuer("Vert.x"));
-
});
-
}).subscribe(token -> {
-
context.response().putHeader("Content-Type", "text/plain").end(token);
-
}, t -> context.fail(401));
-
Single
创建三个对象,表示不同的授权查询。 -
当三个操作成功完成时,
zip
运算符回调将与结果一起调用。
-
String query = sqlQueries.get(SqlQuery.GET_PAGE_BY_ID);
-
JsonArray params = new JsonArray().add(id);
-
Single<ResultSet> resultSet = dbClient.rxQueryWithParams(query, params);
使用数据库连接
当直接查询不适合时(例如,当多个查询必须参与相同的事务时),您可以从池中获取数据库连接。所有你需要做的是呼吁rxGetConnection
的JDBCClient
:
Single<SQLConnection> connection = dbClient.rxGetConnection();
该方法返回一个Single<Connection>
您可以轻松转换flatMapXXX
以执行SQL查询的方法:
-
connection
-
.flatMapCompletable(conn -> conn.rxExecute(sqlQueries.get(SqlQuery.CREATE_PAGES_TABLE)))
但是如果SQLConnection
参考不再可达,我们怎么能释放连接呢?一个简单而方便的方法是close
在doFinally
回调中调用:
-
private Single<SQLConnection> getConnection() {
-
return dbClient.rxGetConnection().flatMap(conn -> {
-
Single<SQLConnection> connectionSingle = Single.just(conn); (1)
-
return connectionSingle.doFinally(conn::close); (2)
-
});
-
}
-
在获得连接后,我们将其包装成一个
Single
-
将
Single
被修改,以调用close
一个doFinally
回调
现在我们将getConnection
随时使用我们需要的数据库连接。
缩小回调和RxJava之间的差距
有时,您可能必须将RxJava代码与基于回调的API混合使用。例如,服务代理接口只能用回调来定义,但实现使用Vert.x Rxified API。
在这种情况下,io.vertx.reactivex.SingleHelper.toObserver
类可以适应Handler<AsyncResult<T>>
RxJava SingleObserver<T>
:
-
-
public WikiDatabaseService fetchAllPagesData(Handler<AsyncResult<List<JsonObject>>> resultHandler) { (1)
-
dbClient.rxQuery(sqlQueries.get(SqlQuery.ALL_PAGES_DATA))
-
.map(ResultSet::getRows)
-
.subscribe(SingleHelper.toObserver(resultHandler)); (2)
-
return this;
-
}
-
fetchAllPagesData
是一种异步服务代理操作,用Handler<AsyncResult<List<JsonObject>>>
回调定义。 -
该
toObserver
方法适用resultHandler
于aSingleObserver<List<JsonObject>>
,以便在发布行列表时调用处理程序。
注意
|
io.vertx.reactivex.CompletableHelper 并io.vertx.reactivex.MaybeHelper 提供适配器Completable 和Maybe 。 |
数据流
RxJava不仅善于组合不同的事件源,而且对数据流也非常有帮助。与Vert.x或JDK未来不同,a Flowable
不仅发布一个事件流,而且还发布一系列事件。它配备了大量的数据操作操作符。
我们可以使用其中的一些来重构fetchAllPages
数据库垂直方法:
-
public WikiDatabaseService fetchAllPages(Handler<AsyncResult<JsonArray>> resultHandler) {
-
dbClient.rxQuery(sqlQueries.get(SqlQuery.ALL_PAGES))
-
.flatMapPublisher(res -> { (1)
-
List<JsonArray> results = res.getResults();
-
return Flowable.fromIterable(results); (2)
-
})
-
.map(json -> json.getString(0)) (3)
-
.sorted() (4)
-
.collect(JsonArray::new, JsonArray::add) (5)
-
.subscribe(SingleHelper.toObserver(resultHandler));
-
return this;
-
}
-
与
flatMapPublisher
我们将创建一个Flowable
从发射的项目Single<Result>
。 -
fromIterable
将数据库结果Iterable
转换为Flowable
发出数据库行项目。 -
由于我们只需要页面名称,我们可以将
map
每一JsonObject
行记录到第一列。 -
客户希望数据
sorted
按字母顺序排列。 -
事件巴士服务答复包含在一个单一的
JsonArray
。collect
创建一个新的JsonArray::new
项目,随后添加项目JsonArray::add
。