CKTIS / Java
Flow.Subscriber — prijímanie položiek s riadením dopytu
Flow.Subscriber<T> prijíma položky a koncové signály od vydavateľa. Pomocou subscription môže vyjadriť dopyt volaním request(n), a riadiť tak počet doručených položiek.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
class Receiver<T> implements Flow.Subscriber<T> {
public void onSubscribe(Flow.Subscription subscription) { }
public void onNext(T item) { }
public void onError(Throwable throwable) { }
public void onComplete() { }
}Flow.Subscriber<T> z java.util.concurrent je rozhranie prijímateľa. T určuje typ položky. Volania pre jednu Flow.Subscription prebiehajú striktne sekvenčne; neznamená to, že sú naviazané na jedno vlákno.
Flow.Subscriber.onSubscribe(Flow.Subscription subscription) dostane subscription pred ostatnými metódami. Uložte si ju a vyžiadajte položky. Flow.Subscriber.onNext(T item) spracuje jednu položku. request(n) pridáva dopyt namiesto toho, aby nahradilo predchádzajúci. Pri aktívnej subscription vyvolá volanie request(n) s n <= 0 signál onError s IllegalArgumentException. Po zrušení subscription alebo po terminálnom signáli už volanie request(n) nevyvolá nový signál onError. Bez dopytu sa položky nedoručujú. Ide o riadenie toku, čiže backpressure.
Flow.Subscriber.onError(Throwable throwable) signalizuje neobnoviteľnú chybu, zatiaľ čo Flow.Subscriber.onComplete() signalizuje normálne dokončenie. Oba signály sú terminálne: po ktoromkoľvek z nich subscription už nevolá ďalšie metódy prijímateľa. Výnimky vyhodené z metód prijímateľa nepoužívajte ako chybový protokol: rozhranie potom nezaručuje správne ďalšie správanie. cancel() funguje podľa najlepšieho úsilia: správy môžu stále prísť a terminálny signál nie je zaručený.
Príklad používa SubmissionPublisher a ďalšiu položku vyžiada až po spracovaní aktuálnej. close() ukončí publikovanie, ale nenahrádza čakanie na doručenie; done.join() čaká na dokončenie prijímateľa. Príklad ukazuje bežný priebeh; pri chybe sa done dokončí výnimočne.
Príklady
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Flow;
import java.util.concurrent.SubmissionPublisher;
public class Main {
static final class Receiver implements Flow.Subscriber<Integer> {
private Flow.Subscription subscription;
final CompletableFuture<Void> done = new CompletableFuture<>();
@Override
public void onSubscribe(Flow.Subscription subscription) {
this.subscription = subscription;
subscription.request(1);
}
@Override
public void onNext(Integer item) {
System.out.println("item=" + item);
subscription.request(1);
}
@Override
public void onError(Throwable throwable) {
done.completeExceptionally(throwable);
}
@Override
public void onComplete() {
System.out.println("complete");
done.complete(null);
}
}
public static void main(String[] args) {
Receiver receiver = new Receiver();
try (SubmissionPublisher<Integer> publisher = new SubmissionPublisher<>()) {
publisher.subscribe(receiver);
publisher.submit(10);
publisher.submit(20);
}
receiver.done.join();
}
}Výsledok
item=10 item=20 complete
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.