## First
只發射第一項(或者滿足某個條件的第一項)數據

如果你只對Observable發射的第一項數據,或者滿足某個條件的第一項數據感興趣,你可以使用`First`操作符。
在某些實現中,`First`沒有實現為一個返回Observable的過濾操作符,而是實現為一個在當時就發射原始Observable指定數據項的阻塞函數。在這些實現中,如果你想要的是一個過濾操作符,最好使用` Take(1)`或者`ElementAt(0)`。
在一些實現中還有一個`Single`操作符。它的行為與`First`類似,但為了確保只發射單個值,它會等待原始Observable終止(否則,不是發射那個值,而是以一個錯誤通知終止)。你可以使用它從原始Observable獲取第一項數據,而且也確保只發射一項數據。
在RxJava中,這個操作符被實現為`first`,`firstOrDefault`和`takeFirst`。
可能容易混淆,`BlockingObservable`也有名叫`first`和`firstOrDefault`的操作符,它們會阻塞并返回值,不是立即返回一個Observable。
還有幾個其它的操作符執行類似的功能。
### 過濾操作符

只發射第一個數據,使用沒有參數的`first`操作符。
示例代碼
```java
Observable.just(1, 2, 3)
.first()
.subscribe(new Subscriber<Integer>() {
@Override
public void onNext(Integer item) {
System.out.println("Next: " + item);
}
@Override
public void onError(Throwable error) {
System.err.println("Error: " + error.getMessage());
}
@Override
public void onCompleted() {
System.out.println("Sequence complete.");
}
});
```
輸出
```
Next: 1
Sequence complete.
```
* Javadoc: [first()](http://reactivex.io/RxJava/javadoc/rx/Observable.html#first())
### first(Func1)

傳遞一個謂詞函數給`first`,然后發射這個函數判定為`true`的第一項數據。
* Javadoc: [first(Func1)](http://reactivex.io/RxJava/javadoc/rx/Observable.html#first(rx.functions.Func1))
### firstOrDefault

`firstOrDefault`與`first`類似,但是在Observagle沒有發射任何數據時發射一個你在參數中指定的默認值。
* Javadoc: [firstOrDefault(T)](http://reactivex.io/RxJava/javadoc/rx/Observable.html#firstOrDefault(T))
### firstOrDefault(Func1)

傳遞一個謂詞函數給`firstOrDefault `,然后發射這個函數判定為`true`的第一項數據,如果沒有數據通過了謂詞測試就發射一個默認值。
* Javadoc [firstOrDefault(T, Func1)](http://reactivex.io/RxJava/javadoc/rx/Observable.html#firstOrDefault(T, rx.functions.Func1))
### takeFirst

`takeFirst`與`first`類似,除了這一點:如果原始Observable沒有發射任何滿足條件的數據,`first`會拋出一個`NoSuchElementException`,`takeFist`會返回一個空的Observable(不調用`onNext()`但是會調用`onCompleted`)。
* Javadoc: [takeFirst(Func1)](http://reactivex.io/RxJava/javadoc/rx/Observable.html#takeFirst(rx.functions.Func1))
### single

`single`操作符也與`first`類似,但是如果原始Observable在完成之前不是正好發射一次數據,它會拋出一個`NoSuchElementException`。
* Javadoc: [single()](http://reactivex.io/RxJava/javadoc/rx/Observable.html#single())
### single(Func1)

`single`的變體接受一個謂詞函數,發射滿足條件的單個值,如果不是正好只有一個數據項滿足條件,會以錯誤通知終止。
* Javadoc: [single(Func1)](http://reactivex.io/RxJava/javadoc/rx/Observable.html#single(rx.functions.Func1))
### singleOrDefault

和`firstOrDefault`類似,但是如果原始Observable發射超過一個的數據,會以錯誤通知終止。
* Javadoc: [singleOrDefault(T)](http://reactivex.io/RxJava/javadoc/rx/Observable.html#singleOrDefault(T))
### singleOrDefault(T,Func1)

和`firstOrDefault(T, Func1)`類似,如果沒有數據滿足條件,返回默認值;如果有多個數據滿足條件,以錯誤通知終止。
* Javadoc: [singleOrDefault(Func1,T)](http://reactivex.io/RxJava/javadoc/rx/Observable.html#singleOrDefault(rx.functions.Func1,%20T))
first系列的這幾個操作符默認不在任何特定的調度器上執行。
- ReactiveX
- Observables
- Single
- Subject
- Scheduler
- Operators
- 創建操作
- Create
- Defer
- Empty/Never/Throw
- From
- Interval
- Just
- Range
- Repeat
- Start
- Timer
- 變換操作
- Buffer
- FlatMap
- GroupBy
- Map
- Scan
- Window
- 過濾操作
- Debounce
- Distinct
- ElementAt
- Filter
- First
- IgnoreElements
- Last
- Sample
- Skip
- SkipLast
- Take
- TakeLast
- 結合操作
- And/Then/When
- CombineLatest
- Join
- Merge
- StartWith
- Switch
- Zip
- 錯誤處理
- Catch
- Retry
- 輔助操作
- Delay
- Do
- Materialize/Dematerialize
- ObserveOn
- Serialize
- Subscribe
- SubscribeOn
- TimeInterval
- Timeout
- Timestamp
- Using
- To
- 條件和布爾操作
- All/Contains/Amb
- DefaultIfEmpty
- SequenceEqual
- SkipUntil/SkipWhile
- TakeUntil/TakeWhile
- 算術和聚合操作
- Average/Concat/Reduce
- Max/Min/Count/Sum
- 異步操作
- 連接操作
- Connect
- Publish
- RefCount
- Replay
- 轉換操作
- 阻塞操作
- 字符串操作
- 按字母順序的操作符列表
- RxJava文檔和教程
- RxJava入門指南
- RxJava使用示例
- 實現自定義操作符
- 自定義插件
- Backpressure
- 錯誤處理
- Android模塊
- 參與開發
- 補充閱讀材料