request_queued
Description:
Emitted when a request is queued on session
.
When sending a request, first [signal@Session:SoupSession:request-queued
] is emitted, indicating that the session has become aware
of the request.
After a connection is available to send the request various [class@Message] signals are emitted as the message is processed. If the message is
requeued, it will emit [signal@Message:SoupSession:restarted
], which will then be followed by other [class@Message] signals when
the message is re-sent.
Eventually, the message will emit [signal@Message:SoupSession:finished
]. Normally, this signals the completion of message
processing. However, it is possible that the application will requeue the message from the "finished" handler. In that case the process will
loop back.
Eventually, a message will reach "finished" and not be requeued. At that point, the session will emit [signal@Session:
SoupSession:request-unqueued
] to indicate that it is done with the message.
To sum up: [signal@Session:SoupSession:request-queued
] and [signal@Session:SoupSession:request-unqueued
] are
guaranteed to be emitted exactly once, but [signal@Message:SoupSession:finished
] (and all of the other [class@Message] signals) may
be invoked multiple times for a given message.
Parameters:
msg |
the request that was queued |