861 * A subscriber for response bodies. |
861 * A subscriber for response bodies. |
862 * {@Incubating} |
862 * {@Incubating} |
863 * |
863 * |
864 * <p> The object acts as a {@link Flow.Subscriber}<{@link List}<{@link |
864 * <p> The object acts as a {@link Flow.Subscriber}<{@link List}<{@link |
865 * ByteBuffer}>> to the HTTP client implementation, which publishes |
865 * ByteBuffer}>> to the HTTP client implementation, which publishes |
866 * unmodifiable lists of ByteBuffers containing the response body. The Flow |
866 * unmodifiable lists of read-only ByteBuffers containing the response body. |
867 * of data, as well as the order of ByteBuffers in the Flow lists, is a |
867 * The Flow of data, as well as the order of ByteBuffers in the Flow lists, |
868 * strictly ordered representation of the response body. Both the Lists and |
868 * is a strictly ordered representation of the response body. Both the Lists |
869 * the ByteBuffers, once passed to the subscriber, are no longer used by the |
869 * and the ByteBuffers, once passed to the subscriber, are no longer used by |
870 * HTTP client. The subscriber converts the incoming buffers of data to some |
870 * the HTTP client. The subscriber converts the incoming buffers of data to |
871 * user-defined object type {@code T}. |
871 * some user-defined object type {@code T}. |
872 * |
872 * |
873 * <p> The {@link #getBody()} method returns a {@link CompletionStage}{@code |
873 * <p> The {@link #getBody()} method returns a {@link CompletionStage}{@code |
874 * <T>} that provides the response body object. The {@code CompletionStage} |
874 * <T>} that provides the response body object. The {@code CompletionStage} |
875 * must be obtainable at any time. When it completes depends on the nature |
875 * must be obtainable at any time. When it completes depends on the nature |
876 * of type {@code T}. In many cases, when {@code T} represents the entire |
876 * of type {@code T}. In many cases, when {@code T} represents the entire |