FilesExpand file tree

 1.x

/

Producer.java

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

42 lines (39 loc) · 1.58 KB

 1.x

/

Producer.java

Copy path

Top

File metadata and controls

• Code
• Blame

42 lines (39 loc) · 1.58 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

/**

* Copyright 2014 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 rx;

/**

* @warn javadoc description missing

*/

public interface Producer {

/**

* Request a certain maximum number of items from this Producer. This is a way of requesting backpressure.

* To disable backpressure, pass {@code Long.MAX_VALUE} to this method.

* <p>

* Requests are additive but if a sequence of requests totals more than {@code Long.MAX_VALUE} then

* {@code Long.MAX_VALUE} requests will be actioned and the extras <i>may</i> be ignored. Arriving at

* {@code Long.MAX_VALUE} by addition of requests cannot be assumed to disable backpressure. For example,

* the code below may result in {@code Long.MAX_VALUE} requests being actioned only.

*

* <pre>

* request(100);

* request(Long.MAX_VALUE-1);

* </pre>

*

* @param n the maximum number of items you want this Producer to produce, or {@code Long.MAX_VALUE} if you

* want the Producer to produce items at its own pace

*/

void request(long n);

}