[jax-rs-spec users] [jsr339-experts] Need clarification on InvocationCallback.completed()

From: Bill Burke <>
Date: Sat, 11 May 2013 19:28:34 -0400

 From the javadoc:

      * Called when the invocation was successfully completed. Note that
this does
      * not necessarily mean the response has bean fully read, which
depends on the
      * parameterized invocation callback response type.
      * <p>
      * Once this invocation callback method returns, the underlying
      * instance will be automatically closed by the runtime.
      * </p>
      * @param response response data.
     public void completed(RESPONSE response);

What does "Note this does not mecessarily mean the response has been
fully read."?

One of the TCK tests assumes that completed() is called pretty much
immediately after the request is sent over the wire and before even one
byte is sent back to the client socket. Am I correct in assuming Jersey
calls completed() before even a status type is sent back to the client?
  So, if the server side processing of the rqeuest is blocked for any
amount of time, completed() will be called pretty much immediately for
Jersey? The TCK shouldn't assume this behavior. For one, the request
certainly isn't completed if a status hasn't been sent back to the
client yet.
Bill Burke
JBoss, a division of Red Hat