diff --git a/stub/src/main/java/io/grpc/stub/ServerCallStreamObserver.java b/stub/src/main/java/io/grpc/stub/ServerCallStreamObserver.java index a4d4564a46..2ac008b269 100644 --- a/stub/src/main/java/io/grpc/stub/ServerCallStreamObserver.java +++ b/stub/src/main/java/io/grpc/stub/ServerCallStreamObserver.java @@ -54,7 +54,9 @@ public abstract class ServerCallStreamObserver extends CallStreamObserver * service returns its {@code StreamObserver}. * *

Setting the onCancelHandler will suppress the on-cancel exception thrown by - * {@link #onNext}. + * {@link #onNext}. If the caller is already handling cancellation via polling or cannot + * substantially benefit from observing cancellation, using a no-op {@code onCancelHandler} is + * useful just to suppress the {@code onNext()} exception. * * @param onCancelHandler to call when client has cancelled the call. */