NotRxJava懒人专用指南

NotRxJava懒人专用指南

如果你是一位 Android 开发者,那么这些天你可能已经听到或看到一些关于 RxJava 满天飞的宣传了。RxJava 是一个能让你摆脱编写一些复杂繁琐的代码去处理异步事件的库。一旦开始在你的项目中使用,你会对它爱不释手的。

然而,RxJava 有个缺陷,它需要一个陡峭的学习过程。对于一个从未接触使用过 RxJava 的人来说,是很难一次就领会到它的精髓所在的,对于它的一些使用方法你也可能会很迷惑。在项目中使用它意味着你需要稍微地改变一下你的代码编写思路,另外,这样的学习曲线会使得在项目中因为大规模的使用RxJava而引发一些问题。

当然,关于如何去使用 RxJava 已经有许多的教程和代码范例了。感兴趣的开发者可以访问 RxJava 的官方 Wiki,里面有关于什么是 Observable 以及它和 Iterable、Future 之间关系的很好的解释。Wiki 里有一篇很有用的文章:How To Use RxJava,这篇文章包含怎么去发送事件流并且打印出它们的介绍以及它的样例代码。

但我们要明确的是在还没有学习什么是 Observable 的前提下了解 RxJava 用来解决什么问题以及它是怎么帮助我们组织起异步代码的。

我这篇文章的定位就是 RxJava 官方文档的“前篇”,读完这篇文章能更好地去理解 RxJava 所解决的问题。文章中也有一个小 Demo,就是自己怎么去整理那些凌乱的代码,然后看看我们在没有使用 RxJava 的情况下是怎么去遵循 RxJava 基本原则的。

所以,如果你仍有足够的好奇的话就让我们开始吧!

Cat 应用程序

让我们来创建一个真实世界的例子。我们都知道猫是我们技术发展的引擎,所以就让我们也来创建这么一个用来下载猫图片的典型应用吧。

任务描述

我们有个 Web API,能根据给定的查询请求搜索到整个互联网上猫的图片。每个图片包含可爱指数的参数(描述图片可爱度的整型值)。我们的任务将会下载到一个猫列表的集合,选择最可爱的那个,然后把它保存到本地。

我们只关心下载、处理和保存猫的数据。

我们开始吧~

模型和 API

下面是描述“猫”的简单数据结构:

public class Cat implements Comparable<Cat>{
    Bitmap image;
    int cuteness;

    @Override
    public int compareTo(Cat another) {
        return Integer.compare(cuteness, another.cuteness);
    }
}

还有我们传统阻塞式风格的 API,它被打包进 cat-sdk.jar 中了:

public interface Api {
    List<Cat> queryCats(String query);
    Uri store(Cat cat);
}

这足够清楚了吗?当然!那就让我们开始编写业务逻辑吧:

public class CatsHelper {

    Api api;

    public Uri saveTheCutestCat(String query){
        List<Cat> cats = api.queryCats(query);
        Cat cutest = findCutest(cats);
        Uri savedUri = api.store(cutest);
        return savedUri;
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

唉,这样清晰简单的代码帅到让我窒息啊。来理清一下代码的炫酷之处吧。主方法 saveTheCutestCat 只包含了 3 个其它方法,然后花个几分钟来看看代码和思考这些方法。你给方法提供了输入参数然后就能得到结果返回了,在这个方法工作的时候我们需要等待它的完成。

简洁而有用,让我们再看看组合方法的其它优势:

组合

正如我们看到的,根据其它 3 个方法而新创建了一个方法(saveTheCutestCat),因此我们组合了它们。像乐高积木那样,我们把方法之间连接起来组成了乐高积木(实际上可以在之后组合起来)。组合方法是很简单的,从一个方法得到返回结果然后再把它传递给另外的方法做为输入参数,这不简单吗?

错误的传递

另外一个好处就是我们处理错误的方式了。任何一个方法都可能因执行时发生错误而被终止,这个错误能在任何层次上被处理掉,Java 中我们叫它抛出了异常,然后这个错误在 try/catch 代码块中做处理。这里的关键点是我们不需要为组合方法里的每个方法都做异常处理,仅需要对这些组合起来的方法做统一处理,像下面这样:

try{
    List<Cat> cats = api.queryCats(query);
    Cat cutest = findCutest(cats);
    Uri savedUri = api.store(cutest);
    return savedUri;
} catch (Exception e) {
    e.printStackTrace()
    return someDefaultValue;
}

这个情况下,我们处理了所有执行时的错误,或者说如果我们没有使用 try/catch 代码块我们能够把错误传递到下一个层次上。

走向异步

要知道我们身在一个对等待很敏感的世界里,我们也知道不可能只有阻塞式的调用。在 Android 中我们也总需要处理异步代码。

拿 Android 的 OnClickListener 举个例子,当你需要处理一个控件的点击事件时,你必须提供一个监听器(回调)以供在用户点击控件时被调用。这没有理由使用阻塞的方式去接受点击事件的回调,所以对点击来说总是异步的。现在,让我们也使用异步编程吧。

异步的网络调用

开始想象下使用没有阻塞的 HTTP client(例如Ion),还有就是我们的cats-sdk.jar已经更新。它的 API 也换成了异步的方式调用。

新 API 的接口:

public interface Api {
    interface CatsQueryCallback {
        void onCatListReceived(List<Cat> cats);
        void onError(Exception e);
    }

    void queryCats(String query, CatsQueryCallback catsQueryCallback);

    Uri store(Cat cat);
}

所以现在我们能异步的获取猫的信息集合列表了,返回正确或错误的结果时都会通过 CatsQueryCallback回调接口。

因为 API 改变了所以我们也不得不改变我们的CatsHelper:

public class CatsHelper {

    public interface CutestCatCallback {
        void onCutestCatSaved(Uri uri);
        void onQueryFailed(Exception e);
    }

    Api api;

    public void saveTheCutestCat(String query, CutestCatCallback cutestCatCallback){
        api.queryCats(query, new Api.CatsQueryCallback() {
            @Override
            public void onCatListReceived(List<Cat> cats) {
                Cat cutest = findCutest(cats);
                Uri savedUri = api.store(cutest);
                cutestCatCallback.onCutestCatSaved(savedUri);
            }

            @Override
            public void onQueryFailed(Exception e) {
                cutestCatCallback.onError(e);
            }
        });
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

现在我们已经不能使用阻塞的 API 了,我们也不能把我们的客户端上写成阻塞式的调用(实际上是可以的,但需要明确的在线程中使用synchronizedCountdownLatch、等等,也需要在下层中使用异步处理)。所以我们不能在 saveTheCutestCat方法中直接返回一个值,我们需要对它进行异步回调处理。

让我们再深入一点,如果我们 API 的两个方法调用都是异步的,举个例子,我们正在使用非阻塞IO去写进一个文件。

public interface Api {
    interface CatsQueryCallback {
        void onCatListReceived(List<Cat> cats);
        void onQueryFailed(Exception e);
    }

    interface StoreCallback{
        void onCatStored(Uri uri);
        void onStoreFailed(Exception e);
    }

    void queryCats(String query, CatsQueryCallback catsQueryCallback);

    void store(Cat cat, StoreCallback storeCallback);
}

还有我们的 helper:

public class CatsHelper {

    public interface CutestCatCallback {
        void onCutestCatSaved(Uri uri);
        void onError(Exception e);
    }

    Api api;

    public void saveTheCutestCat(String query, CutestCatCallback cutestCatCallback){
        api.queryCats(query, new Api.CatsQueryCallback() {
            @Override
            public void onCatListReceived(List<Cat> cats) {
                Cat cutest = findCutest(cats);
                api.store(cutest, new Api.StoreCallback() {
                    @Override
                    public void onCatStored(Uri uri) {
                        cutestCatCallback.onCutestCatSaved(uri);
                    }

                    @Override
                    public void onStoreFailed(Exception e) {
                        cutestCatCallback.onError(e);
                    }
                });
            }

            @Override
            public void onQueryFailed(Exception e) {
                cutestCatCallback.onError(e);
            }
        });
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

现在再来看看代码,跟之前一样优雅吗?明显不是了,这很糟糕!现在它有了更多无关代码和花括号,但是逻辑是一样的。

那么组合在哪呢?他已经不见了!现在你不能像之前那样组合操作了。对于每一个异步操作你都必须创建出回调接口并在代码中插入它们,每一次都需要手动地加入!

错误传递又在哪?又是一个否定!在这样的代码中错误不会自动地传递,我们需要在更深一层上通过自己手动地再让它传递下去(请看onStoreFailedonQueryFailed方法)。

我们很难对这样的代码进行阅读和找出潜在的 bugs。

结束了?

结束了又怎样?我们能拿它来干嘛?我们被困在这个没有组合回调的地狱里了吗?前方高能,请抓紧你的安全带哦,我们将努力的去把这些干掉!

更美好的世界!

泛型回调

可以从我们的回调接口中找到共同的模式:

  • 都有一个分发结果的方法(onCutestCatSaved,onCatListReceived,onCatStored
  • 它们中大多数(在我们的例子中是全部)有一个用于错误处理的方法(onError,onQueryFailed,onStoreFailed

所以我们可以创建一个泛型回调接口去替代原来所有的接口。但是我们不能去改变 API 的调用方法的签名,我们必须创建包装类来间接调用。

所以我们的泛型回调接口看起来是这样的:

public interface Callback<T> {
    void onResult(T result);
    void onError(Exception e);
}

然后我们来创建ApiWrapper来改变一下调用方法的签名:

public class ApiWrapper {
    Api api;

    public void queryCats(String query, Callback<List<Cat>> catsCallback){
        api.queryCats(query, new Api.CatsQueryCallback() {
            @Override
            public void onCatListReceived(List<Cat> cats) {
                catsCallback.onResult(cats);
            }

            @Override
            public void onQueryFailed(Exception e) {
                catsCallback.onError(e);
            }
        });
    }

    public void store(Cat cat, Callback<Uri> uriCallback){
        api.store(cat, new Api.StoreCallback() {
            @Override
            public void onCatStored(Uri uri) {
                uriCallback.onResult(uri);
            }

            @Override
            public void onStoreFailed(Exception e) {
                uriCallback.onError(e);
            }
        });
    }
}

所以这仅仅是对于Callback的一些传递 resuts/errors 的调用转发逻辑。

最后我们的CatsHelper

public class CatsHelper{

    ApiWrapper apiWrapper;

    public void saveTheCutestCat(String query, Callback<Uri> cutestCatCallback){
        apiWrapper.queryCats(query, new Callback<List<Cat>>() {
            @Override
            public void onResult(List<Cat> cats) {
                Cat cutest = findCutest(cats);
                apiWrapper.store(cutest, cutestCatCallback);
            }

            @Override
            public void onError(Exception e) {
                cutestCatCallback.onError(e);
            }
        });
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

可以看到比之前的简明了一些。我们可以通过直接传递一个顶级的cutestCatCallback回调接口给apiWrapper.store来减少回调间的层级调用,此外作为回调方法的签名是一样的。

但是我们可以做的更好!

你必须把它分开

让我们来看看我们的异步操作(queryCatsqueryCats,还有saveTheCutestCat),它们都遵循了相同的模式。调用它们的方法有一些参数(querycat)也包括一个回调对象。再次说明:任何异步操作需要携带所需的常规参数和一个回调实例对象。如果我们试图去分开这几个阶段,每个异步操作仅仅将会携带一个参数对象,然后返回一些携带着回调(信息)的临时对象。

我们来应用下这样的模式,看看是否对我们有所帮助。

如果在异步操作中返回一些临时对象,我们需要定义一个出来。这样的一个对象需要包括常见的行为(以回调为单一参数),我们将定义这样的类给所有的异步操作使用,这个类就叫它AsyncJob

P.S. 称之为AsyncTask更合适一点,但是我不希望你混淆了异步操作跟另外一个存在的抽象概念之间的关系(这是不好的一点)。

所以:

public abstract class AsyncJob<T> {
    public abstract void start(Callback<T> callback);
}

非常的简单,Callback传进方法后就会开始它的工作任务。

然后更改包装 API 的调用:

public class ApiWrapper {
    Api api;

    public AsyncJob<List<Cat>> queryCats(String query) {
        return new AsyncJob<List<Cat>>() {
            @Override
            public void start(Callback<List<Cat>> catsCallback) {
                api.queryCats(query, new Api.CatsQueryCallback() {
                    @Override
                    public void onCatListReceived(List<Cat> cats) {
                        catsCallback.onResult(cats);
                    }

                    @Override
                    public void onQueryFailed(Exception e) {
                        catsCallback.onError(e);
                    }
                });
            }
        };
    }

    public AsyncJob<Uri> store(Cat cat) {
        return new AsyncJob<Uri>() {
            @Override
            public void start(Callback<Uri> uriCallback) {
                api.store(cat, new Api.StoreCallback() {
                    @Override
                    public void onCatStored(Uri uri) {
                        uriCallback.onResult(uri);
                    }

                    @Override
                    public void onStoreFailed(Exception e) {
                        uriCallback.onError(e);
                    }
                });
            }
        };
    }
}

目前一切顺利,我们只是部分运用我们的包装过的 API 调用在程序之中。现在我们可以开始使用AsyncJob去做我们想要的了,当然也到更改CatsHelper的时间了。

public class CatsHelper {

    ApiWrapper apiWrapper;

    public AsyncJob<Uri> saveTheCutestCat(String query) {
        return new AsyncJob<Uri>() {
            @Override
            public void start(Callback<Uri> cutestCatCallback) {
                apiWrapper.queryCats(query)
                        .start(new Callback<List<Cat>>() {
                            @Override
                            public void onResult(List<Cat> cats) {
                                Cat cutest = findCutest(cats);
                                apiWrapper.store(cutest)
                                        .start(new Callback<Uri>() {
                                            @Override
                                            public void onResult(Uri result) {
                                                cutestCatCallback.onResult(result);
                                            }

                                            @Override
                                            public void onError(Exception e) {
                                                cutestCatCallback.onError(e);
                                            }
                                        });
                            }

                            @Override
                            public void onError(Exception e) {
                                cutestCatCallback.onError(e);
                            }
                        });
            }
        };
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

哇,之前的版本更简单些啊,我们现在的优势是什么?答案就是现在我们可以给客户端返回“组合”操作的AsyncJob<Uri>。所以一个客户端(在 activity 或者 fragment 处)可以用组合起来的工作来操作。

Breaking things

这是我们的逻辑数据流:

         (async)                 (sync)           (async)
query ===========> List<Cat> -------------> Cat ==========> Uri
       queryCats              findCutest           store

为了让我们的代码拥有之前的可读性,我们从这个事件流中强行进入到里面的操作里。但有件事需要注意,如果某些操作(方法)是异步的,然后调用它的操作(方法)又是异步的,就比如,查询猫的操作是异步的,然后寻找出最可爱的猫(即使有一个阻塞调用)也是一个异步操作(客户端希望接收的结果)。

所以我们可以使用 AsyncJobs 把我们的方法分解成更小的操作:

public class CatsHelper {

    ApiWrapper apiWrapper;

    public AsyncJob<Uri> saveTheCutestCat(String query) {
        AsyncJob<List<Cat>> catsListAsyncJob = apiWrapper.queryCats(query);
        AsyncJob<Cat> cutestCatAsyncJob = new AsyncJob<Cat>() {
            @Override
            public void start(Callback<Cat> callback) {
                catsListAsyncJob.start(new Callback<List<Cat>>() {
                    @Override
                    public void onResult(List<Cat> result) {
                        callback.onResult(findCutest(result));
                    }

                    @Override
                    public void onError(Exception e) {
                        callback.onError(e);
                    }
                });
            }
        };

        AsyncJob<Uri> storedUriAsyncJob = new AsyncJob<Uri>() {
            @Override
            public void start(Callback<Uri> cutestCatCallback) {
                cutestCatAsyncJob.start(new Callback<Cat>() {
                    @Override
                    public void onResult(Cat cutest) {
                        apiWrapper.store(cutest)
                                .start(new Callback<Uri>() {
                                    @Override
                                    public void onResult(Uri result) {
                                        cutestCatCallback.onResult(result);
                                    }

                                    @Override
                                    public void onError(Exception e) {
                                        cutestCatCallback.onError(e);
                                    }
                                });
                    }

                    @Override
                    public void onError(Exception e) {
                        cutestCatCallback.onError(e);
                    }
                });
            }
        };
        return storedUriAsyncJob;
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

代码量多了许多,但是更加清晰了。低层次嵌套的回调,利于理解的变量名(catsListAsyncJobcutestCatAsyncJobstoredUriAsyncJob)。

看起来好了许多,但我们要再做一些事情:

简单映射

现在看看 AsyncJob<Cat> cutestCatAsyncJob的部分:

AsyncJob<Cat> cutestCatAsyncJob = new AsyncJob<Cat>() {
            @Override
            public void start(Callback<Cat> callback) {
                catsListAsyncJob.start(new Callback<List<Cat>>() {
                    @Override
                    public void onResult(List<Cat> result) {
                        callback.onResult(findCutest(result));
                    }

                    @Override
                    public void onError(Exception e) {
                        callback.onError(e);
                    }
                });
            }
        };

这 16 行代码只有一行是对我们有用(对于逻辑来说)的操作:

findCutest(result)

剩下的仅仅是开启另外一个AsyncJob和传递结果与错误的样板代码。此外,这些代码并不用于特定的任务,我们可以把其移动到其它地方而不影响编写我们真正需要的业务代码。

我们该怎么写呢?我们必须做下面的两件事情:

  • AsyncJob是我们转换的结果
  • 转换方法

这又有另外一个问题,因为在 Java 中不能直接传递方法(函数)所以我们需要通过类(和接口)来间接实现这样的功能,然后我们就来定义这个 “方法”:

public interface Func<T, R> {
    R call(T t);
}

相当简单,Func接口有两个类型成员,T对应于参数类型而R对应于返回类型。

当我们从一个AsyncJob中装换处结果后我们就需要做一些值之间的映射,这样的方法我们就叫它map。定义这个方法实例(Func 类型)最好的地方就在AsyncJob类中,所以AsyncJob代码里看起来就是这样了:

public abstract class AsyncJob<T> {
    public abstract void start(Callback<T> callback);

    public <R> AsyncJob<R> map(Func<T, R> func){
        final AsyncJob<T> source = this;
        return new AsyncJob<R>() {
            @Override
            public void start(Callback<R> callback) {
                source.start(new Callback<T>() {
                    @Override
                    public void onResult(T result) {
                        R mapped = func.call(result);
                        callback.onResult(mapped);
                    }

                    @Override
                    public void onError(Exception e) {
                        callback.onError(e);
                    }
                });
            }
        };
    }
}

赞,这时CatsHelper就是下面这样了:

public class CatsHelper {

    ApiWrapper apiWrapper;

    public AsyncJob<Uri> saveTheCutestCat(String query) {
        AsyncJob<List<Cat>> catsListAsyncJob = apiWrapper.queryCats(query);
        AsyncJob<Cat> cutestCatAsyncJob = catsListAsyncJob.map(new Func<List<Cat>, Cat>() {
            @Override
            public Cat call(List<Cat> cats) {
                return findCutest(cats);
            }
        });

        AsyncJob<Uri> storedUriAsyncJob = new AsyncJob<Uri>() {
            @Override
            public void start(Callback<Uri> cutestCatCallback) {
                cutestCatAsyncJob.start(new Callback<Cat>() {
                    @Override
                    public void onResult(Cat cutest) {
                        apiWrapper.store(cutest)
                                .start(new Callback<Uri>() {
                                    @Override
                                    public void onResult(Uri result) {
                                        cutestCatCallback.onResult(result);
                                    }

                                    @Override
                                    public void onError(Exception e) {
                                        cutestCatCallback.onError(e);
                                    }
                                });
                    }

                    @Override
                    public void onError(Exception e) {
                        cutestCatCallback.onError(e);
                    }
                });
            }
        };
        return storedUriAsyncJob;
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

现在好多了,创建AsyncJob<Cat> cutestCatAsyncJob只需要 6 行代码而回调也只有一个层级了。

高级映射

前面的那些已经很赞了,但是创建AsyncJob<Uri> storedUriAsyncJob的部分还有些不忍直视。能在这里创建映射吗?我们来试试吧:

public class CatsHelper {

    ApiWrapper apiWrapper;

    public AsyncJob<Uri> saveTheCutestCat(String query) {
        AsyncJob<List<Cat>> catsListAsyncJob = apiWrapper.queryCats(query);
        AsyncJob<Cat> cutestCatAsyncJob = catsListAsyncJob.map(new Func<List<Cat>, Cat>() {
            @Override
            public Cat call(List<Cat> cats) {
                return findCutest(cats);
            }
        });

        AsyncJob<Uri> storedUriAsyncJob = cutestCatAsyncJob.map(new Func<Cat, Uri>() {
            @Override
            public Uri call(Cat cat) {
                return apiWrapper.store(cat);
        //      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ will not compile
        //      Incompatible types:
        //      Required: Uri
        //      Found: AsyncJob<Uri>
            }
        });
        return storedUriAsyncJob;
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

呃呃。。。并不容易哦,我们来修改下结果的类型变量,试下其它方法:

public class CatsHelper {

    ApiWrapper apiWrapper;

    public AsyncJob<Uri> saveTheCutestCat(String query) {
        AsyncJob<List<Cat>> catsListAsyncJob = apiWrapper.queryCats(query);
        AsyncJob<Cat> cutestCatAsyncJob = catsListAsyncJob.map(new Func<List<Cat>, Cat>() {
            @Override
            public Cat call(List<Cat> cats) {
                return findCutest(cats);
            }
        });

        AsyncJob<AsyncJob<Uri>> storedUriAsyncJob = cutestCatAsyncJob.map(new Func<Cat, AsyncJob<Uri>>() {
            @Override
            public AsyncJob<Uri> call(Cat cat) {
                return apiWrapper.store(cat);
            }
        });
        return storedUriAsyncJob;
        //^^^^^^^^^^^^^^^^^^^^^^^ will not compile
        //      Incompatible types:
        //      Required: AsyncJob<Uri>
        //      Found: AsyncJob<AsyncJob<Uri>>
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

在目前这点上我们只能有AsyncJob<AsyncJob<Uri>>。我们需要往更深处挖吗?我们希望的是,去把AsyncJob在一个级别上的两个异步操作扁平化成一个单一的异步操作。

现在我们需要的是得到能使方法返回映射成R类型也是AsyncJob<R>类型的操作。这个操作应该像map,但在最后应该flatten我们嵌套的AsyncJob。我们叫它为flatMap吧,然后就是来实现它:

public abstract class AsyncJob<T> {
    public abstract void start(Callback<T> callback);

    public <R> AsyncJob<R> map(Func<T, R> func){
        final AsyncJob<T> source = this;
        return new AsyncJob<R>() {
            @Override
            public void start(Callback<R> callback) {
                source.start(new Callback<T>() {
                    @Override
                    public void onResult(T result) {
                        R mapped = func.call(result);
                        callback.onResult(mapped);
                    }

                    @Override
                    public void onError(Exception e) {
                        callback.onError(e);
                    }
                });
            }
        };
    }

    public <R> AsyncJob<R> flatMap(Func<T, AsyncJob<R>> func){
        final AsyncJob<T> source = this;
        return new AsyncJob<R>() {
            @Override
            public void start(Callback<R> callback) {
                source.start(new Callback<T>() {
                    @Override
                    public void onResult(T result) {
                        AsyncJob<R> mapped = func.call(result);
                        mapped.start(new Callback<R>() {
                            @Override
                            public void onResult(R result) {
                                callback.onResult(result);
                            }

                            @Override
                            public void onError(Exception e) {
                                callback.onError(e);
                            }
                        });
                    }

                    @Override
                    public void onError(Exception e) {
                        callback.onError(e);
                    }
                });
            }
        };
    }
}

FlatMap 的粗略实现,但这些东西的实现都在一个地方了,在客户端的业务代码中不会再见到它。接下来我们修复下CatsHelper:

public class CatsHelper {

    ApiWrapper apiWrapper;

    public AsyncJob<Uri> saveTheCutestCat(String query) {
        AsyncJob<List<Cat>> catsListAsyncJob = apiWrapper.queryCats(query);
        AsyncJob<Cat> cutestCatAsyncJob = catsListAsyncJob.map(new Func<List<Cat>, Cat>() {
            @Override
            public Cat call(List<Cat> cats) {
                return findCutest(cats);
            }
        });

        AsyncJob<Uri> storedUriAsyncJob = cutestCatAsyncJob.flatMap(new Func<Cat, AsyncJob<Uri>>() {
            @Override
            public AsyncJob<Uri> call(Cat cat) {
                return apiWrapper.store(cat);
            }
        });
        return storedUriAsyncJob;
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

哈哈!它能用了,读和写也简单了不少。

最后的要点

再来看看我们编写的代码,眼熟吗?如果我们使用 Java 8 的 lambdas(逻辑是一样的但是看起来更爽一些) 代码会更加地简洁。

public class CatsHelper {

    ApiWrapper apiWrapper;

    public AsyncJob<Uri> saveTheCutestCat(String query) {
        AsyncJob<List<Cat>> catsListAsyncJob = apiWrapper.queryCats(query);
        AsyncJob<Cat> cutestCatAsyncJob = catsListAsyncJob.map(cats -> findCutest(cats));
        AsyncJob<Uri> storedUriAsyncJob = cutestCatAsyncJob.flatMap(cat -> apiWrapper.store(cat));
        return storedUriAsyncJob;
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

它看起来会更好吗?我认为这样的代码跟我们第一次阻塞的版本差不多:

public class CatsHelper {

    Api api;

    public Uri saveTheCutestCat(String query){
        List<Cat> cats = api.queryCats(query);
        Cat cutest = findCutest(cats);
        Uri savedUri = api.store(cutest);
        return savedUri;
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

是的,就是这样,逻辑是相似的!也有可能会复杂些(语义是一样的)。

我们这样的代码有组合性吗?请大声的说有!我们组合了所有的异步操作然后作为返回结果我们仅需一个组合后的结果对象而已。

错误传递呢?当然也有!所有的错误都会传递到最后的回调中。

接下来的最后呢。。。

RxJava

嘿,你不需要把那些代码拷到你的项目中,因为我们还是实现地不够完全的,仅仅算是非线程安全的 RxJava 的一小部分而已。

它们之间只有一些差异:

  • AsyncJob<T> 就是实际上的 Observable,它不仅可以只分发一个单一的结果也可以是一个序列(可以为空)。
  • Callback<T> 就是 Observer,除了 Callback 少了onNext(T t)方法。Observer 中在onError(Throwable t)方法被调用后,会继而调用onCompleted(),然后 Observer 会包装好并发送出事件流(因为它能发送一个序列)。
  • abstract void start(Callback<T> callback)对应 Subscription subscribe(final Observer
public class ApiWrapper {
    Api api;

    public Observable<List<Cat>> queryCats(final String query) {
        return Observable.create(new Observable.OnSubscribe<List<Cat>>() {
            @Override
            public void call(final Subscriber<? super List<Cat>> subscriber) {
                api.queryCats(query, new Api.CatsQueryCallback() {
                    @Override
                    public void onCatListReceived(List<Cat> cats) {
                        subscriber.onNext(cats);
                    }

                    @Override
                    public void onQueryFailed(Exception e) {
                        subscriber.onError(e);
                    }
                });
            }
        });
    }

    public Observable<Uri> store(final Cat cat) {
        return Observable.create(new Observable.OnSubscribe<Uri>() {
            @Override
            public void call(final Subscriber<? super Uri> subscriber) {
                api.store(cat, new Api.StoreCallback() {
                    @Override
                    public void onCatStored(Uri uri) {
                        subscriber.onNext(uri);
                    }

                    @Override
                    public void onStoreFailed(Exception e) {
                        subscriber.onError(e);
                    }
                });
            }
        });
    }
}

public class CatsHelper {

    ApiWrapper apiWrapper;

    public Observable<Uri> saveTheCutestCat(String query) {
        Observable<List<Cat>> catsListObservable = apiWrapper.queryCats(query);
        Observable<Cat> cutestCatObservable = catsListObservable.map(new Func1<List<Cat>, Cat>() {
            @Override
            public Cat call(List<Cat> cats) {
                return CatsHelper.this.findCutest(cats);
            }
        });
        Observable<Uri> storedUriObservable = cutestCatObservable.flatMap(new Func1<Cat, Observable<? extends Uri>>() {
            @Override
            public Observable<? extends Uri> call(Cat cat) {
                return apiWrapper.store(cat);
            }
        });
        return storedUriObservable;
    }

    private Cat findCutest(List<Cat> cats) {
        return Collections.max(cats);
    }
}

你可以看到代码是相同的,除了使用Observable来替代AsyncJob

总结

我们看到,通过简单的转化我们可以把异步操作给抽象出来。这个抽象出来的东西可以被用来操作和组合异步操作就像简单的方法那样。通过这种方法我们可以摆脱嵌套的回调,在处理异步结果时也能手动处理错误的传递。

如果你看到了这里的话建议你放松下,思考下 sync/async 之间的二元关系,然后看看这个很棒的来自Erik Meijer视频

一些有用的链接

感谢

感谢我的朋友 Alexander Yakushev 帮忙翻译。

时间: 2024-11-05 18:56:54

NotRxJava懒人专用指南的相关文章

懒人专用快捷键----&gt;MyEclipse

ctrl + / ctrl + shift + c 以下是myeclipse中的所有快捷键列表:Ctrl+1 快速修复(最经典的快捷键,就不用多说了) Ctrl+D: 删除当前行 Ctrl+Alt+↓ 复制当前行到下一行(复制增加) Ctrl+Alt+↑ 复制当前行到上一行(复制增加) Alt+↓ 当前行和下面一行交互位置(特别实用,可以省去先剪切,再粘贴了) Alt+↑ 当前行和上面一行交互位置(同上) Alt+← 前一个编辑的页面 Alt+→ 下一个编辑的页面(当然是针对上面那条来说了) A

懒人专用SSH框架下的基本配置

项目结束,马上就要出去找工作了,这段时间也不用写项目,就整理了一些以后可能会用的到的配置,还有一个原因就是我不想去记忆......... SSH下application.xml的基本配置,应该满足一般的开发需求 <?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans"     xmlns:xs

网络编程懒人入门(九):通俗讲解,有了IP地址,为何还要用MAC地址?

1.前言 标题虽然是为了解释有了 IP 地址,为什么还要用 MAC 地址,但是本文的重点在于理解为什么要有 IP 这样的东西.本文对读者的定位是知道 MAC 地址是什么,IP 地址是什么. (本文同步发布于:http://www.52im.net/thread-2067-1-1.html) 2.关于作者 翟志军,个人博客地址:https://showme.codes/,Github:https://github.com/zacker330.感谢作者的原创分享. 作者的另一篇<即时通讯安全篇(七)

大道至简第二章—懒人的方法

大道至简第二章—懒人的方法 僰道有故蜀王兵阑亦有神,作大滩江中.其崖崭峻,不可凿:乃积薪烧之.故其处悬崖有赤白五色. ----华阳国志卷三-蜀志 在第一章中作者引用愚公移山的典故向我们介绍了编程的精义,以愚公为例向我们介绍了个编程人员应具备的素质.而在第二章,作者通过蜀郡太守李冰烧石破山建造都江堰的故事告诉我们我们只是勤奋是不够的.如果李冰像愚公那样日复一日的敲石碎山,就不会有空闲时间去观察,去思考了.那也不会有“积薪烧之”的事情了.所以李冰乃是闲人一枚. 人的精力是有限的.愚公而愚公可以多吃点

懒人日记 之 自己到底有多懒

一:起因 0 之前写过类似的关于懒人与智能化的关系的博文,不善于学习,不善于发现问题,解决问题的根源 -- 懒: 1 过去的一年,变化最大的是:每当遇到一个问题,及时的记录下来,并自行的分析并解决掉,而不是让问题躺在那里或者等着别人来解决 -- 依赖: 2 遇到问题之时,方是增长知识的最佳时刻:遇到的问题就像一个人的灵感,需要及时的记录下来,因为一生中能有几回灵感 -- 灵感: 3 盗版的office word,每次打开都会遇到讨厌的提示框 -- 下载一个注册机即可: 4 盗版的win7系统,整

大道至简——做个懒人

懒人有懒法 ——读<大道至简>第二章“是懒人创造了方法”有感 愚公移山靠的是坚持不懈,然而随着事物的进化,李冰凿山也不再是坚持不懈的凿山了,而是选择“积薪烧之”了.李冰会烧而不是凿原因是什么呢?如果他和愚公一样一味的督促团队凿石开山,那他就没有时间学习观察了,就一定不会发现烧的这种方法.他却不是这样的,他应该是个闲人,有时间看火烧石头的闲人.而闲人懒人也一定有自己的懒方法,愚公可以拼命努力,让今天的工作量超出一倍,但是毕竟人的精力有限,再怎么努力也不可能很快完成,有个好方法就可以事半功倍.所以

读《大道至简-- 第二章 是懒人造就了方法》 有感

社会的进步.科学的发展,无不是靠这些“懒人”. 懒人造就了方法,这句话一点也没错.突然间想想那些聪明的人,大多都是懒人.因为想得多,所以做得少.因为想得多,所以思维得到了锻炼,变得越来越聪明.懒人造就了方法,当一件事情需要很大功夫才能做完时,勤快人想得是马上去做,尽快完成,而懒人想得是怎样做省力,怎样做最节省时间,此时懒人创造了一系列的方法.越勤快,越没有机会找到更快的方法.因为勤快人的脑子里想的并不是方法相关的东西.很多时候,做一个懒人还是很有必要的. 愚公和李冰同样是在凿山,但是愚公每天都在

懒人天气小项目

懒人天气小项目主要实现了城市地理定位,显示当地天气,根据你的喜好选择不同类型的生活小控件获取生活建议.显示七天天气实时天气情况. 效果图如下: 用到的主要内容有: 1.通过第三方类库MMDrawerController 来实现左右侧边栏,左侧边栏显示七天天气情况,难右侧边栏显示当前位置.MMDrawerController的使用方法我在MMDrawerController介绍里有详细说明. 2.使用CoreLocation地理定位,将获得的城市编码,将城市编码设置为字典的value,传送到网络请

是懒人创造了方法

“僰蘭道有蜀王兵 ,亦有神作大滩江中.其崖崭峻不可破,(冰)乃积薪烧之.李冰一定是一个闲人,可以闲到去看火能不能把石头烧爆.结果不可置疑,这种方法加快了工程进度,使得一座大山短时间内就被哗啦哗啦的“碎”掉了.正是一个懒人造就了“烧石头”这个“碎石”的方法.有时候人还是回心有余而力不足.所以就更有必要“懒一懒”!提出新的“方法”,解决的将是影响做事成效的根本问题. 联系生活实际,无论做啥,都是讲究方法.就像打篮球,球进了就是硬道理.运用假动作,找好自己的节奏,以让自己身心都舒服的方法进球,何乐而不