From 2bf5ef54dabbbfc0881a4ef3122eabc1f6bdde5c Mon Sep 17 00:00:00 2001 From: wanyingd1996 <68657274+wanyingd1996@users.noreply.github.com> Date: Thu, 19 Nov 2020 12:45:16 -0800 Subject: [PATCH] api: Added documentation for Call onClose hanging problem --- api/src/main/java/io/grpc/ClientCall.java | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/api/src/main/java/io/grpc/ClientCall.java b/api/src/main/java/io/grpc/ClientCall.java index ac32dccda5..b572f1ee55 100644 --- a/api/src/main/java/io/grpc/ClientCall.java +++ b/api/src/main/java/io/grpc/ClientCall.java @@ -141,6 +141,10 @@ public abstract class ClientCall { * An additional block of trailer metadata may be received at the end of the call from the * server. An empty {@link Metadata} object is passed if no trailers are received. * + *

This method should not throw. If this method throws, there is no way to be notified of the + * exception. Implementations should therefore be careful of exceptions which can accidentally + * leak resources. + * * @param status the result of the remote call. * @param trailers metadata provided at call completion. */