RxJava2.0 操作符（3）—— Filter 过滤转换符

这个页面展示的操作符可用于过滤和选择Observable发射的数据序列。
Debounce — 仅在过了一段指定的时间还没发射数据时才发射一个数据。
Distinct — 过滤掉重复数据。
ElementAt — 发射第 N 项数据。
Filter — 过滤数据。
First 只发射第一项数据。
IgnoreElements — 丢弃所有的正常数据，只发射错误或完成通知。
Last — 只发射最后的一项数据。
Sample 定期发射 Observable 最近的数据。
Skip — 跳过开始的 N 项数据。
SkipLast — 跳过最后的 N 项数据。
Take — 只发射开始的 N 项数据。
TakeLast — 只发射最后的 N 项数据。

3.1 Debounce

仅在过了一段指定的时间还没发射数据时才发射一个数据，过滤掉发射速率过快的数据项。
通俗一点来说，N 个事件的结点发生的时间太接近，debounce 过滤掉前 N-1 个事件。
实践：常用于过滤实时的搜索、防止按钮重复点击。

debounce

示例代码：

Observable.create(new ObservableOnSubscribe() {
        @Override
        public void subscribe(@NonNull ObservableEmitter emitter) throws Exception {
            for (int i = 0; i < 7; i++) {
                emitter.onNext(i);
                Thread.sleep(i * 100);
            }
            emitter.onComplete();

        }
    }).debounce(300, TimeUnit.MILLISECONDS).subscribe(new Consumer() {
        @Override
        public void accept(@NonNull Integer integer) throws Exception {
            Log.e(TAG, integer + "");
        }
    });

输出结果：

4
5
6

next 发送时与上一个 next 间隔少于 300 毫秒所以不发送0，1，2，3。
操作符 throttleWithTimeout 和 debounce 效果一致。

3.1 Distinct

过滤掉重复数据,只允许还没有发射过的数据项通过。

distinct

示例代码1：

Observable.just(1, 2, 1, 1, 2, 3)
    .distinct()
    .subscribe(new Consumer() {
        @Override
        public void accept(@NonNull Integer integer) throws Exception {
            Log.e(TAG, integer + "");
        }
    });

输出结果：

1 2 3

3.1.1 Distinct(Function)

distinct

这个操作符有一个变体接受一个函数。这个函数根据原始 Observable 发射的数据项产生一个 Key，然后，比较这些 Key 而不是数据本身，来判定两个数据是否是不同的。
示例代码：

Observable.just(-1, -2, 0, 1, 2, 1).distinct(new Function() {
        @Override
        public Integer apply(@NonNull Integer integer) throws Exception {
            return Math.abs(integer);
        }
    }).subscribe(new Consumer() {
        @Override
        public void accept(@NonNull Integer integer) throws Exception {
            Log.e(TAG, integer + "");
        }
    });

输出结果：

-1 ， -2 ， 0

3.1.2 DistinctUntilChanged

过滤掉连续重复的数据，判定一个数据和它的直接前驱(相邻)是否是不同的。

distinctUntilChanged

示例代码：

  Observable.just(-1, 1, 1, 2, 1, 2, 2)
      .distinctUntilChanged()
      .subscribe(new Consumer() {
            @Override
            public void accept(@NonNull Integer integer) throws Exception {
                Log.e(TAG, integer + "");
            }
        });

输出结果：

-1，1，2，1，2

3.1.3 DistinctUntilChanged(Function)

过滤掉连续重复的数据，通过一个 key 判定一个数据和它的直接前驱(相邻)是否是不同的。

distinctUntilChanged(Function)

示例代码：

Observable.just(-1, -2, -1, 1, 2, 1).distinctUntilChanged(new Function() {
        @Override
        public Integer apply(@NonNull Integer integer) throws Exception {
            return Math.abs(integer);
        }
    }).subscribe(new Consumer() {
        @Override
        public void accept(@NonNull Integer integer) throws Exception {
            Log.e(TAG, integer + "");
        }
    });

输出结果：

-1 , -2 , -1 , 2 , 1

3.3 ElementAt

发射第 N 项数据,操作符获取原始 Observable 发射的数据序列指定索引位置的数据项，然后当做自己的唯一数据发射。

elementAt1

示例代码：

Observable.just(2,3,4,5).elementAt(2).subscribe(new Consumer() {
    @Override
    public void accept(@NonNull Integer integer) throws Exception {
        Log.e(TAG, integer + "");
    }
});

输出结果：

4

ElementAt(long index, T defaultItem)
发射第 N 项数据，如果 Observable 数据少于N项就发射默认值，原始 Observable 的数据项数小于 index，使用默认的 defaultItem 数据。

elementAt2

示例代码：

Observable.just("h", "e", "l", "l", "0")
    .elementAt(6, "dafalut")
    .subscribe(new Consumer() {
            @Override
            public void accept(@NonNull String s) throws Exception {
                Log.e(TAG, "");
            }
        });

输出结果：

dafalut

3.4 Filter

Filter 操作符使用你指定的一个函数过滤数据项，只有满足条件的数据才会被发射。

Filter

示例代码：

 Observable.just(1,2,3,4,5,6,7)
    .filter(new Predicate() {
        @Override
        public boolean test(@NonNull Integer integer) throws Exception {
            return integer > 2 && integer < 6;
        }
    }).subscribe(new Consumer() {
        @Override
        public void accept(@NonNull Integer integer) throws Exception {
            Log.e(TAG, integer+"");
        }
    });

输出结果：

3，4，5

3.5 First

返回一个 Single，它仅发出 Observable 发出的第一个项目，或者如果 Observable 不发送任何项目，则返回一个默认项目。first = elementAt(0L, defaultItem);

First

示例代码1：

Observable.just(1,2).first(100).subscribe(new Consumer() {
    @Override
    public void accept(@NonNull Integer integer) throws Exception {
        Log.e(TAG, integer+"");
    }
});

输出结果：

1

示例代码2：

//创建一个不发射任何数据但是正常终止的 Observable ,则返回默认的字符“ empty default ”
Observable.empty().first("empty default").subscribe(new Consumer