FilesExpand file tree

 2.x

/

AsyncEmitter.java

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

101 lines (85 loc) · 2.63 KB

 2.x

/

AsyncEmitter.java

Copy path

Top

File metadata and controls

• Code
• Blame

101 lines (85 loc) · 2.63 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

/**

* Copyright 2016 Netflix, Inc.

*

* Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in

* compliance with the License. You may obtain a copy of the License at

*

* http://www.apache.org/licenses/LICENSE-2.0

*

* Unless required by applicable law or agreed to in writing, software distributed under the License is

* distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See

* the License for the specific language governing permissions and limitations under the License.

*/

package io.reactivex;

import io.reactivex.disposables.Disposable;

/**

* Abstraction over a RxJava Subscriber that allows associating

* a resource with it and exposes the current number of downstream

* requested amount.

* <p>

* The onNext, onError and onComplete methods should be called

* in a sequential manner, just like the Subscriber's methods. The

* other methods are threadsafe.

*

* @param <T> the value type to emit

*/

public interface AsyncEmitter<T> {

/**

* Signal a value.

* @param t the value, not null

*/

void onNext(T t);

/**

* Signal an exception.

* @param t the exception, not null

*/

void onError(Throwable t);

/**

* Signal the completion.

*/

void onComplete();

/**

* Sets a Disposable on this emitter; any previous Disposable

* or Cancellation will be unsubscribed/cancelled.

* @param s the disposable, null is allowed

*/

void setDisposable(Disposable s);

/**

* Sets a Cancellable on this emitter; any previous Disposable

* or Cancellation will be unsubscribed/cancelled.

* @param c the cancellable resource, null is allowed

*/

void setCancellation(Cancellable c);

/**

* The current outstanding request amount.

* <p>This method it threadsafe.

* @return the current outstanding request amount

*/

long requested();

/**

* Returns true if the downstream cancelled the sequence.

* @return true if the downstream cancelled the sequence

*/

boolean isCancelled();

/**

* A functional interface that has a single close method

* that can throw.

*/

interface Cancellable {

/**

* Cancel the action or free a resource.

* @throws Exception on error

*/

void cancel() throws Exception;

}

/**

* Options to handle backpressure in the emitter.

*/

enum BackpressureMode {

NONE,

ERROR,

BUFFER,

DROP,

LATEST

}

}