Sets or clears the accumulate flag on this.
(The default value is true
.) If set to false
, this's data
field
will not be filled in after the body is fully sent/received, and the chunks that make up this may be
discarded when they are no longer needed.
In particular, if you set this flag to false
on an "incoming" message body (that is, the SoupMessage:response_body
of a client-side message, or SoupMessage:request_body
of a server-side message), this will cause each chunk of the
body to be discarded after its corresponding got_chunk signal is emitted. (This
is equivalent to setting the deprecated OVERWRITE_CHUNKS flag on
the message.)
If you set this flag to false
on the SoupMessage:response_body
of a server-side message, it will cause each
chunk of the body to be discarded after its corresponding wrote_chunk signal is
emitted.
If you set the flag to false
on the SoupMessage:request_body
of a client-side message, it will block the
accumulation of chunks into this's data
field, but it will not normally cause the chunks to
be discarded after being written like in the server-side SoupMessage:response_body
case, because the request body needs to be
kept around in case the request needs to be sent a second time due to redirection or authentication. However, if you set the
CAN_REBUILD flag on the message, then the chunks will be discarded, and
you will be responsible for recreating the request body after the restarted
signal is emitted.
this | |
accumulate |
whether or not to accumulate body chunks in this |