RxJava 操作符

创建操作

以下操作符用于创建Observable。
create：使用OnSubscribe从头创建一个Observable，这种方法比较简单。需要注意的是，使用该方法创建时，建议在OnSubscribe#call方法中检查订阅状态，以便及时停止发射数据或者运算。

      Observable.create(new Observable.OnSubscribe<String>() {

          @Override
          public void call(Subscriber<? super String> subscriber) {

              subscriber.onNext("item1");
              subscriber.onNext("item2");
              subscriber.onCompleted();
          }
      });

from：将一个Iterable, 一个Future, 或者一个数组，内部通过代理的方式转换成一个Observable。
Future转换为OnSubscribe是通过OnSubscribeToObservableFuture进行的，
Iterable转换通过OnSubscribeFromIterable进行。数组通过OnSubscribeFromArray转换。

      //Iterable
      List<String> list=new ArrayList<>();
      ...
      Observable.from(list)
              .subscribe(new Action1<String>() {
          @Override
          public void call(String s) {

          }
      });

      //Future
       Future<String> futrue= Executors.newSingleThreadExecutor().submit(new Callable<String>() {

          @Override
          public String call() throws Exception {
              Thread.sleep(1000);
              return "maplejaw";
          }
      });

      Observable.from(futrue)
                .subscribe(new Action1<String>() {
          @Override
          public void call(String s) {

          }
      });
;

just：将一个或多个对象转换成发射这个或这些对象的一个Observable。如果是单个对象，内部创建的是ScalarSynchronousObservable
对象。如果是多个对象，则是调用了from方法创建。

empty：创建一个什么都不做直接通知完成的Observable
error：创建一个什么都不做直接通知错误的Observable
never：创建一个什么都不做的Observable

      Observable observable1=Observable.empty();//直接调用onCompleted。
      Observable observable2=Observable.error(new RuntimeException());//直接调用onError。这里可以自定义异常
      Observable observable3=Observable.never();//啥都不做

timer：创建一个在给定的延时之后发射数据项为0的Observable<Long>,内部通过OnSubscribeTimerOnce工作

 Observable.timer(1000,TimeUnit.MILLISECONDS)
              .subscribe(new Action1<Long>() {
                  @Override
                  public void call(Long aLong) {
                      Log.d("JG",aLong.toString()); // 0
                  }
              });

interval：创建一个按照给定的时间间隔发射从0开始的整数序列的Observable<Long>，内部通过OnSubscribeTimerPeriodically工作。

Observable.interval(1, TimeUnit.SECONDS)
              .subscribe(new Action1<Long>() {
                  @Override
                  public void call(Long aLong) {
                       //每隔1秒发送数据项，从0开始计数
                       //0,1,2,3....
                  }
              });

range：创建一个发射指定范围的整数序列的Observable<Integer>

 Observable.range(2,5).subscribe(new Action1<Integer>() {
          @Override
          public void call(Integer integer) {
              Log.d("JG",integer.toString());// 2,3,4,5,6 从2开始发射5个数据
          }
      });

defer：只有当订阅者订阅才创建Observable，为每个订阅创建一个新的Observable。内部通过OnSubscribeDefer在订阅时调用Func0创建Observable。

Observable.defer(new Func0<Observable<String>>() {
          @Override
          public Observable<String> call() {
              return Observable.just("hello");
          }
      }).subscribe(new Action1<String>() {
          @Override
          public void call(String s) {
              Log.d("JG",s);
          }
      });

合并操作

以下操作符用于组合多个Observable。
注意，为了使结构更加清晰以及缩小代码量，之后的例子部分地方将会使用Lambda表达式书写，如果你对Lambda表达式不太熟悉的话，可以阅读JAVA8 Lambda表达式完全解析这篇文章。

concat：按顺序连接多个Observables。需要注意的是Observable.concat(a,b)等价于a.concatWith(b)。

  Observable<Integer> observable1=Observable.just(1,2,3,4);
  Observable<Integer>  observable2=Observable.just(4,5,6);

  Observable.concat(observable1,observable2)
              .subscribe(item->Log.d("JG",item.toString()));//1,2,3,4,4,5,6

startWith：在数据序列的开头增加一项数据。startWith
的内部也是调用了concat

 Observable.just(1,2,3,4,5)
              .startWith(6,7,8)
      .subscribe(item->Log.d("JG",item.toString()));//6,7,8,1,2,3,4,5

merge：将多个Observable合并为一个。不同于concat，merge不是按照添加顺序连接，而是按照时间线来连接。其中mergeDelayError
将异常延迟到其它没有错误的Observable发送完毕后才发射。而merge
则是一遇到异常将停止发射数据，发送onError通知。

zip：使用一个函数组合多个Observable发射的数据集合，然后再发射这个结果。如果多个Observable发射的数据量不一样，则以最少的Observable为标准进行压合。内部通过OperatorZip进行压合。

 Observable<Integer>  observable1=Observable.just(1,2,3,4);
  Observable<Integer>  observable2=Observable.just(4,5,6);
      Observable.zip(observable1, observable2, new Func2<Integer, Integer, String>() {
          @Override
          public String call(Integer item1, Integer item2) {
              return item1+"and"+item2;
          }
      })
      .subscribe(item->Log.d("JG",item)); //1and4,2and5,3and6

combineLatest：。当两个Observables中的任何一个发射了一个数据时，通过一个指定的函数组合每个Observable发射的最新数据（一共两个数据），然后发射这个函数的结果。类似于zip，但是，不同的是zip只有在每个Observable都发射了数据才工作，而combineLatest任何一个发射了数据都可以工作，每次与另一个Observable最近的数据压合。具体请看下面流程图。zip工作流程

zip流程图

combineLatest工作流程

combineLatest流程

过滤操作
filter：过滤数据。内部通过OnSubscribeFilter
过滤数据。

    Observable.just(3,4,5,6)
              .filter(new Func1<Integer, Boolean>() {
                  @Override
                  public Boolean call(Integer integer) {
                      return integer>4;
                  }
              })
      .subscribe(item->Log.d("JG",item.toString())); //5,6

ofType：过滤指定类型的数据，与filter类似，

Observable.just(1,2,"3")
              .ofType(Integer.class)
              .subscribe(item -> Log.d("JG",item.toString()));

take：只发射开始的N项数据或者一定时间内的数据。内部通过OperatorTake和OperatorTakeTimed过滤数据。

Observable.just(3,4,5,6)
              .take(3)//发射前三个数据项
              .take(100, TimeUnit.MILLISECONDS)//发射100ms内的数据

takeLast：只发射最后的N项数据或者一定时间内的数据。内部通过OperatorTakeLast和OperatorTakeLastTimed过滤数据。takeLastBuffer和takeLast类似，不同点在于takeLastBuffer会收集成List后发射。

 Observable.just(3,4,5,6)
              .takeLast(3)
              .subscribe(integer -> Log.d("JG",integer.toString()));//4,5,6

takeFirst：提取满足条件的第一项。内部实现源码如下：

public final Observable<T> takeFirst(Func1<? super T, Boolean> predicate) {
        return filter(predicate).take(1); //先过滤，后提取
  }

first/firstOrDefault：只发射第一项（或者满足某个条件的第一项）数据，可以指定默认值。

   Observable.just(3,4,5,6)
              .first()
              .subscribe(integer -> Log.d("JG",integer.toString()));//3

      Observable.just(3,4,5,6)
                 .first(new Func1<Integer, Boolean>() {
                     @Override
                     public Boolean call(Integer integer) {
                         return integer>3;
                     }
                 }) .subscribe(integer -> Log.d("JG",integer.toString()));//4

last/lastOrDefault：只发射最后一项（或者满足某个条件的最后一项）数据，可以指定默认值。

skip：跳过开始的N项数据或者一定时间内的数据。内部通过OperatorSkip和OperatorSkipTimed实现过滤。

  Observable.just(3,4,5,6)
                 .skip(1)
              .subscribe(integer -> Log.d("JG",integer.toString()));//4,5,6

skipLast：跳过最后的N项数据或者一定时间内的数据。内部通过OperatorSkipLast和OperatorSkipLastTimed实现过滤。

elementAt/elementAtOrDefault：发射某一项数据，如果超过了范围可以的指定默认值。内部通过OperatorElementAt过滤。

 Observable.just(3,4,5,6)
               .elementAt(2)
      .subscribe(item->Log.d("JG",item.toString())); //5

ignoreElements：丢弃所有数据，只发射错误或正常终止的通知。内部通过OperatorIgnoreElements实现。

distinct：过滤重复数据，内部通过OperatorDistinct
实现。

   Observable.just(3,4,5,6,3,3,4,9)
         .distinct()
        .subscribe(item->Log.d("JG",item.toString())); //3,4,5,6,9

distinctUntilChanged：过滤掉连续重复的数据。内部通过OperatorDistinctUntilChanged实现

Observable.just(3,4,5,6,3,3,4,9)
         .distinctUntilChanged()
        .subscribe(item->Log.d("JG",item.toString())); //3,4,5,6,3,4,9

throttleFirst：定期发射Observable发射的第一项数据。内部通过OperatorThrottleFirst实现。

Observable.create(subscriber -> {
          subscriber.onNext(1);
          try {
              Thread.sleep(500);
          } catch (InterruptedException e) {
              throw Exceptions.propagate(e);
          }
          subscriber.onNext(2);
          try {
              Thread.sleep(500);
          } catch (InterruptedException e) {
              throw Exceptions.propagate(e);
          }

          subscriber.onNext(3);
          try {
              Thread.sleep(1000);
          } catch (InterruptedException e) {
              throw Exceptions.propagate(e);
          }
          subscriber.onNext(4);
          subscriber.onNext(5);
          subscriber.onCompleted();

      }).throttleFirst(999, TimeUnit.MILLISECONDS)
              .subscribe(item-> Log.d("JG",item.toString())); //结果为1,3,4

throttleWithTimeout/debounce：发射数据时，如果两次数据的发射间隔小于指定时间，就会丢弃前一次的数据,直到指定时间内都没有新数据发射时才进行发射

Observable.create(subscriber -> {
          subscriber.onNext(1);
          try {
              Thread.sleep(500);
          } catch (InterruptedException e) {
              throw Exceptions.propagate(e);
          }
          subscriber.onNext(2);
          try {
              Thread.sleep(500);
          } catch (InterruptedException e) {
              throw Exceptions.propagate(e);
          }

          subscriber.onNext(3);
          try {
              Thread.sleep(1000);
          } catch (InterruptedException e) {
              throw Exceptions.propagate(e);
          }
          subscriber.onNext(4);
          subscriber.onNext(5);
          subscriber.onCompleted();

      }).debounce(999, TimeUnit.MILLISECONDS)//或者为throttleWithTimeout(1000, TimeUnit.MILLISECONDS)
              .subscribe(item-> Log.d("JG",item.toString())); //结果为3,5

sample/throttleLast：定期发射Observable最近的数据。内部通过OperatorSampleWithTime实现。

   Observable.create(subscriber -> {
          subscriber.onNext(1);
          try {
              Thread.sleep(500);
          } catch (InterruptedException e) {
              throw Exceptions.propagate(e);
          }
          subscriber.onNext(2);
          try {
              Thread.sleep(500);
          } catch (InterruptedException e) {
              throw Exceptions.propagate(e);
          }

          subscriber.onNext(3);
          try {
              Thread.sleep(1000);
          } catch (InterruptedException e) {
              throw Exceptions.propagate(e);
          }
          subscriber.onNext(4);
          subscriber.onNext(5);
          subscriber.onCompleted();

      }).sample(999, TimeUnit.MILLISECONDS)//或者为throttleLast(1000, TimeUnit.MILLISECONDS)
              .subscribe(item-> Log.d("JG",item.toString())); //结果为2,3,5

timeout：如果原始Observable过了指定的一段时长没有发射任何数据，就发射一个异常或者使用备用的Observable。

Observable.create(( subscriber) -> {
          subscriber.onNext(1);
          try {
              Thread.sleep(1000);
          } catch (InterruptedException e) {
              throw Exceptions.propagate(e);
          }
          subscriber.onNext(2);

          subscriber.onCompleted();

      }).timeout(999, TimeUnit.MILLISECONDS,Observable.just(99,100))//如果不指定备用Observable将会抛出异常
              .subscribe(item-> Log.d("JG",item.toString()),error->Log.d("JG","onError")); //结果为1,99,100  如果不指定备用Observable结果为1,onError
  }

条件/布尔操作

all：判断所有的数据项是否满足某个条件，内部通过OperatorAll
实现。

    Observable.just(2,3,4,5)
              .all(new Func1<Integer, Boolean>() {
                  @Override
                  public Boolean call(Integer integer) {
                      return integer>3;
                  }
              })
      .subscribe(new Action1<Boolean>() {
          @Override
          public void call(Boolean aBoolean) {
              Log.d("JG",aBoolean.toString()); //false
          }
      })
      ;

exists：判断是否存在数据项满足某个条件。内部通过OperatorAny
实现。

 Observable.just(2,3,4,5)
              .exists(integer -> integer>3)
              .subscribe(aBoolean -> Log.d("JG",aBoolean.toString())); //true

contains：判断在发射的所有数据项中是否包含指定的数据，内部调用的其实是exists

    Observable.just(2,3,4,5)
              .contains(3)
              .subscribe(aBoolean -> Log.d("JG",aBoolean.toString())); //true

sequenceEqual：用于判断两个Observable发射的数据是否相同（数据，发射顺序，终止状态）。

 Observable.sequenceEqual(Observable.just(2,3,4,5),Observable.just(2,3,4,5))
              .subscribe(aBoolean -> Log.d("JG",aBoolean.toString()));//true

isEmpty：用于判断Observable发射完毕时，有没有发射数据。有数据false，如果只收到了onComplete通知则为true。

 Observable.just(3,4,5,6)
                 .isEmpty()
                .subscribe(item -> Log.d("JG",item.toString()));//false

amb：给定多个Observable，只让第一个发射数据的Observable发射全部数据，其他Observable将会被忽略。

Observable<Integer> observable1=Observable.create(new Observable.OnSubscribe<Integer>() {
          @Override
          public void call(Subscriber<? super Integer> subscriber) {
              try {
                  Thread.sleep(1000);
              } catch (InterruptedException e) {
                  subscriber.onError(e);
              }
              subscriber.onNext(1);
              subscriber.onNext(2);
              subscriber.onCompleted();
          }
      }).subscribeOn(Schedulers.computation());

      Observable<Integer> observable2=Observable.create(subscriber -> {
          subscriber.onNext(3);
          subscriber.onNext(4);
          subscriber.onCompleted();
      });

      Observable.amb(observable1,observable2)
      .subscribe(integer -> Log.d("JG",integer.toString())); //3,4

switchIfEmpty：如果原始Observable正常终止后仍然没有发射任何数据，就使用备用的Observable。

Observable.empty()
             .switchIfEmpty(Observable.just(2,3,4))
     .subscribe(o -> Log.d("JG",o.toString())); //2,3,4

defaultIfEmpty：如果原始Observable正常终止后仍然没有发射任何数据，就发射一个默认值,内部调用的switchIfEmpty。

takeUntil：当发射的数据满足某个条件后（包含该数据），或者第二个Observable发送完毕，终止第一个Observable发送数据。

Observable.just(2,3,4,5)
              .takeUntil(new Func1<Integer, Boolean>() {
                  @Override
                  public Boolean call(Integer integer) {
                      return integer==4;
                  }
              }).subscribe(integer -> Log.d("JG",integer.toString())); //2,3,4

takeWhile：当发射的数据满足某个条件时（不包含该数据），Observable终止发送数据。

Observable.just(2,3,4,5)
              .takeWhile(new Func1<Integer, Boolean>() {
                  @Override
                  public Boolean call(Integer integer) {
                      return integer==4;
                  }
              })
              .subscribe(integer -> Log.d("JG",integer.toString())); //2,3

skipUntil：丢弃Observable发射的数据，直到第二个Observable发送数据。（丢弃条件数据）

skipWhile：丢弃Observable发射的数据，直到一个指定的条件不成立（不丢弃条件数据）

聚合操作

reduce：对序列使用reduce()函数并发射最终的结果,内部使用OnSubscribeReduce实现。

 Observable.just(2,3,4,5)
              .reduce(new Func2<Integer, Integer, Integer>() {
                  @Override
                  public Integer call(Integer sum, Integer item) {
                      return sum+item;
                  }
              })
              .subscribe(integer -> Log.d("JG",integer.toString()));//14

collect：使用collect
收集数据到一个可变的数据结构。

Observable.just(3,4,5,6)
                 .collect(new Func0<List<Integer>>() { //创建数据结构

                     @Override
                     public List<Integer> call() {
                         return new ArrayList<Integer>();
                     }
                 }, new Action2<List<Integer>, Integer>() { //收集器
                     @Override
                     public void call(List<Integer> integers, Integer integer) {
                         integers.add(integer);
                     }
                 })
                .subscribe(new Action1<List<Integer>>() {
                    @Override
                    public void call(List<Integer> integers) {

                    }
                });

count/countLong：计算发射的数量，内部调用的是reduce
.

转换操作

toList：收集原始Observable发射的所有数据到一个列表，然后返回这个列表.

      Observable.just(2,3,4,5)
              .toList()
              .subscribe(new Action1<List<Integer>>() {
                  @Override
                  public void call(List<Integer> integers) {

                  }
              });

toSortedList：收集原始Observable发射的所有数据到一个有序列表，然后返回这个列表。

     Observable.just(6,2,3,4,5)
              .toSortedList(new Func2<Integer, Integer, Integer>() {//自定义排序
                  @Override
                  public Integer call(Integer integer, Integer integer2) {
                      return integer-integer2; //>0 升序 ，<0 降序
                  }
              })
              .subscribe(new Action1<List<Integer>>() {
                  @Override
                  public void call(List<Integer> integers) {
                      Log.d("JG",integers.toString()); // [2, 3, 4, 5, 6]
                  }
              });

toMap：将序列数据转换为一个Map。我们可以根据数据项生成key和生成value。

 Observable.just(6,2,3,4,5)
          .toMap(new Func1<Integer, String>() {
              @Override
              public String call(Integer integer) {
                  return "key：" + integer; //根据数据项生成map的key
              }
          }, new Func1<Integer, String>() {
              @Override
              public String call(Integer integer) {
                  return "value："+integer; //根据数据项生成map的kvalue
              }
          }).subscribe(new Action1<Map<String, String>>() {
      @Override
      public void call(Map<String, String> stringStringMap) {
          Log.d("JG",stringStringMap.toString()); // {key：6=value：6, key：5=value：5, key：4=value：4, key：2=value：2, key：3=value：3}
      }
  });

toMultiMap：类似于toMap，不同的地方在于map的value是一个集合。变换操作

map：对Observable发射的每一项数据都应用一个函数来变换。

 Observable.just(6,2,3,4,5)
              .map(integer -> "item:"+integer)
              .subscribe(s -> Log.d("JG",s));//item:6,item:2....

cast：在发射之前强制将Observable发射的所有数据转换为指定类型
flatMap：将Observable发射的数据变换为Observables集合，然后将这些Observable发射的数据平坦化的放进一个单独的Observable，内部采用merge合并。

Observable.just(2,3,5)
              .flatMap(new Func1<Integer, Observable<String>>() {
                  @Override
                  public Observable<String> call(Integer integer) {
                      return Observable.create(subscriber -> {
                          subscriber.onNext(integer*10+"");
                          subscriber.onNext(integer*100+"");
                          subscriber.onCompleted();
                      });
                  }
              })
      .subscribe(o -> Log.d("JG",o)) //20,200,30,300,50,500

flatMapIterable：和flatMap的作用一样，只不过生成的是Iterable而不是Observable。

 Observable.just(2,3,5)
              .flatMapIterable(new Func1<Integer, Iterable<String>>() {
                  @Override
                  public Iterable<String> call(Integer integer) {
                      return Arrays.asList(integer*10+"",integer*100+"");
                  }
              }).subscribe(new Action1<String>() {
                @Override
                public void call(String s) {

                }
      });

concatMap：类似于flatMap，由于内部使用concat合并，所以是按照顺序连接发射。
switchMap：和flatMap很像，将Observable发射的数据变换为Observables集合，当原始Observable发射一个新的数据（Observable）时，它将取消订阅前一个Observable。

 Observable.create(new Observable.OnSubscribe<Integer>() {

          @Override
          public void call(Subscriber<? super Integer> subscriber) {
              for(int i=1;i<4;i++){
                  subscriber.onNext(i);
                  Utils.sleep(500,subscriber);//线程休眠500ms
              }

              subscriber.onCompleted();
          }
      }).subscribeOn(Schedulers.newThread())
        .switchMap(new Func1<Integer, Observable<Integer>>() {
               @Override
             public Observable<Integer> call(Integer integer) {
                     //每当接收到新的数据，之前的Observable将会被取消订阅
                      return Observable.create(new Observable.OnSubscribe<Integer>() {
                          @Override
                          public void call(Subscriber<? super Integer> subscriber) {
                              subscriber.onNext(integer*10);
                              Utils.sleep(500,subscriber);
                              subscriber.onNext(integer*100);
                              subscriber.onCompleted();
                          }
                      }).subscribeOn(Schedulers.newThread());
                  }
              })
              .subscribe(s -> Log.d("JG",s.toString()));//10,20,30,300

scan：与reduce很像，对Observable发射的每一项数据应用一个函数，然后按顺序依次发射每一个值。

Observable.just(2,3,5)
              .scan(new Func2<Integer, Integer, Integer>() {
                  @Override
                  public Integer call(Integer sum, Integer item) {
                      return sum+item;
                  }
              })
      .subscribe(integer -> Log.d("JG",integer.toString())) //2,5,10

groupBy：将Observable分拆为Observable集合，将原始Observable发射的数据按Key分组，每一个Observable发射一组不同的数据。

Observable.just(2,3,5,6)
              .groupBy(new Func1<Integer, String>() {
                  @Override
                  public String call(Integer integer) {//分组
                      return integer%2==0?"偶数":"奇数";
                  }
              })
      .subscribe(new Action1<GroupedObservable<String, Integer>>() {
          @Override
          public void call(GroupedObservable<String, Integer> o) {

              o.subscribe(new Action1<Integer>() {
                  @Override
                  public void call(Integer integer) {
                      Log.d("JG",o.getKey()+":"+integer.toString()); //偶数：2，奇数：3，...
                  }
              });
          }
      })

buffer：它定期从Observable收集数据到一个集合，然后把这些数据集合打包发射，而不是一次发射一个

 Observable.just(2,3,5,6)
              .buffer(3)
              .subscribe(new Action1<List<Integer>>() {
                  @Override
                  public void call(List<Integer> integers) {

                  }
              })

window：定期将来自Observable的数据分拆成一些Observable窗口，然后发射这些窗口，而不是每次发射一项。

 Observable.just(2,3,5,6)
              .window(3)
              .subscribe(new Action1<Observable<Integer>>() {
                  @Override
                  public void call(Observable<Integer> integerObservable) {
                      integerObservable.subscribe(new Action1<Integer>() {
                          @Override
                          public void call(Integer integer) {

                          }
                      });
                  }
              })

错误处理/重试机制
onErrorResumeNext：当原始Observable在遇到错误时，使用备用Observable。。

Observable.just(1,"2",3)
      .cast(Integer.class)
      .onErrorResumeNext(Observable.just(1,2,3))
      .subscribe(integer -> Log.d("JG",integer.toString())) //1,2,3
      ;

onExceptionResumeNext：当原始Observable在遇到异常时，使用备用的Observable。与onErrorResumeNext
类似，区别在于onErrorResumeNext
可以处理所有的错误，onExceptionResumeNext只能处理异常。
onErrorReturn：当原始Observable在遇到错误时发射一个特定的数据。

 Observable.just(1,"2",3)
              .cast(Integer.class)
              .onErrorReturn(new Func1<Throwable, Integer>() {
                  @Override
                  public Integer call(Throwable throwable) {
                      return 4;
                  }
              }).subscribe(new Action1<Integer>() {
          @Override
          public void call(Integer integer) {
              Log.d("JG",integer.toString());1,4
          }
      });

retry：当原始Observable在遇到错误时进行重试。

 Observable.just(1,"2",3)
      .cast(Integer.class)
      .retry(3)
      .subscribe(integer -> Log.d("JG",integer.toString()),throwable -> Log.d("JG","onError"))
      ;//1,1,1,1,onError

retryWhen：当原始Observable在遇到错误，将错误传递给另一个Observable来决定是否要重新订阅这个Observable,内部调用的是retry
。

Observable.just(1,"2",3)
      .cast(Integer.class)
      .retryWhen(new Func1<Observable<? extends Throwable>, Observable<Long>>() {
          @Override
          public Observable<Long> call(Observable<? extends Throwable> observable) {
              return Observable.timer(1, TimeUnit.SECONDS);
          }
      })
      .subscribe(integer -> Log.d("JG",integer.toString()),throwable -> Log.d("JG","onError"));
      //1,1

连接操作

ConnectableObservable与普通的Observable差不多，但是可连接的Observable在被订阅时并不开始发射数据，只有在它的connect()被调用时才开始。用这种方法，你可以等所有的潜在订阅者都订阅了这个Observable之后才开始发射数据。ConnectableObservable.connect()指示一个可连接的Observable开始发射数据.Observable.publish()将一个Observable转换为一个可连接的ObservableObservable.replay()确保所有的订阅者看到相同的数据序列的ConnectableObservable，即使它们在Observable开始发射数据之后才订阅
ConnectableObservable.refCount()
让一个可连接的Observable表现得像一个普通的Observable。

   ConnectableObservable<Integer> co= Observable.just(1,2,3)
                .publish();

        co .subscribe(integer -> Log.d("JG",integer.toString()) );
        co.connect();//此时开始发射数据

工具集

materialize：将Observable转换成一个通知列表。

   Observable.just(1,2,3)
             .materialize()
             .subscribe(new Action1<Notification<Integer>>() {
                 @Override
                 public void call(Notification<Integer> notification) {
                     Log.d("JG",notification.getKind()+" "+notification.getValue());
                     //OnNext 1
                     //OnNext 2
                     //OnNext 3
                     //OnCompleted null
                 }
             });

dematerialize：与上面的作用相反，将通知逆转回一个Observable。
timestamp：给Observable发射的每个数据项添加一个时间戳。

 Observable.just(1,2,3)
             .timestamp()
             .subscribe(new Action1<Timestamped<Integer>>() {
                 @Override
                 public void call(Timestamped<Integer> timestamped) {
                     Log.d("JG",timestamped.getTimestampMillis()+" "+timestamped.getValue());
                     //1472627510548 1
                     //1472627510549 2
                     //1472627510549 3
                 }
             });

timeInterval：给Observable发射的两个数据项间添加一个时间差，实现在OperatorTimeInterval
中

timeInterval

serialize：强制Observable按次序发射数据并且要求功能是完好的
cache：缓存Observable发射的数据序列并发射相同的数据序列给后续的订阅者
observeOn：指定观察者观察Observable的调度器
subscribeOn：指定Observable执行任务的调度器
doOnEach：注册一个动作，对Observable发射的每个数据项使用

 Observable.just(2,3)
              .doOnEach(new Action1<Notification<? super Integer>>() {
                  @Override
                  public void call(Notification<? super Integer> notification) {
                      Log.d("JG","--doOnEach--"+notification.toString());
                  }
              })
              .subscribe(integer -> Log.d("JG",integer.toString()));
  //结果为：            
   // --doOnEach--[rx.Notification@133c40b0 OnNext 2]
  // 2
   // --doOnEach--[rx.Notification@133c40b0 OnNext 3]
  // 3
 // --doOnEach--[rx.Notification@df4db0e OnCompleted]

doOnCompleted：注册一个动作，对正常完成的Observable使用

doOnError：注册一个动作，对发生错误的Observable使用
doOnTerminate：注册一个动作，对完成的Observable使用，无论是否发生错误

    Observable.just(2,3)
              .doOnTerminate(new Action0() {
                  @Override
                  public void call() {
                      Log.d("JG","--doOnTerminate--");
                  }
              })
              .subscribe(integer -> Log.d("JG",integer.toString()));
  // 2 , 3 , --doOnTerminate--

doOnSubscribe：注册一个动作，在观察者订阅时使用。内部由OperatorDoOnSubscribe实现

doOnUnsubscribe：注册一个动作，在观察者取消订阅时使用。内部由OperatorDoOnUnsubscribe实现，在call中加入一个解绑动作。

doOnUnsubscribe

finallyDo/doAfterTerminate：注册一个动作，在Observable完成时使用

 Observable.just(2,3)
              .doAfterTerminate(new Action0() {
                  @Override
                  public void call() {
                      Log.d("JG","--doAfterTerminate--");
                  }
              })
              .subscribe(integer -> Log.d("JG",integer.toString()));
  //2,3,  --doAfterTerminate--

delay：延时发射Observable的结果。即让原始Observable在发射每项数据之前都暂停一段指定的时间段。效果是Observable发射的数据项在时间上向前整体平移了一个增量（除了onError，它会即时通知）。

delaySubscription：延时处理订阅请求。实现在OnSubscribeDelaySubscription
中

delaySubscription

using：创建一个只在Observable生命周期存在的资源，当Observable终止时这个资源会被自动释放。

Observable.using(new Func0<File>() {//资源工厂
          @Override
          public File call() {

              File file = new File(getCacheDir(), "a.txt");
              if(!file.exists()){
                  try {
                      Log.d("JG","--create--");
                      file.createNewFile();
                  } catch (IOException e) {
                      e.printStackTrace();
                  }
              }
              return file;
          }
      }, new Func1<File, Observable<String>>() { //Observable
          @Override
          public Observable<String> call(File file) {
              return Observable.just(file.exists() ? "exist" : "no exist");
          }
      }, new Action1<File>() {//释放资源动作
          @Override
          public void call(File file) {
              if(file!=null&&file.exists()){
                  Log.d("JG","--delete--");
                  file.delete();
              }
          }
      })
      .subscribe(s -> Log.d("JG",s))
      ;
   //--create--
   //exist
   //--delete--

single/singleOrDefault：强制返回单个数据，否则抛出异常或默认数据。

最后编辑于：2017.12.07 04:55:06

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 194,319评论 5赞 459
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 81,801评论 2赞 371
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 141,567评论 0赞 319
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 52,156评论 1赞 263
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 61,019评论 4赞 355
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 46,090评论 1赞 272
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 36,500评论 3赞 381
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 35,192评论 0赞 253
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 39,474评论 1赞 290
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 34,566评论 2赞 309
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 36,338评论 1赞 326
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 32,212评论 3赞 312
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 37,572评论 3赞 298
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 28,890评论 0赞 17
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 30,169评论 1赞 250
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 41,478评论 2赞 341
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 40,661评论 2赞 335