An interceptor for poisoning connections in response to certain events.
This interceptor, when paired with a compatible connection, allows the connection to be
poisoned in reaction to certain events (like receiving a transient error.) This allows users
to avoid sending requests to a server that isn’t responding. This can increase the load on a
server, because more connections will be made overall.
In order for this interceptor to work, the configured connection must interact with the
“connection retriever” stored in an HTTP request’s extensions map. For an example of this,
see HyperConnector. When a connection is made available to the retriever, this interceptor
will call a .poison method on it, signalling that the connection should be dropped. It is
up to the connection implementer to handle this.
A hook called before the transport request message is sent to the
service. This method has the ability to modify and return
a new transport request message of the same type. Read more
A hook called before the input message is marshalled into a
transport message.
This method has the ability to modify and return a new
request message of the same type. Read more
A hook called before the retry loop is entered. This method
has the ability to modify and return a new transport request
message of the same type, except when a failure occurs earlier in the request pipeline. Read more
A hook called before the transport request message is signed.
This method has the ability to modify and return a new transport
request message of the same type. Read more
A hook called before the transport response message is unmarshalled.
This method has the ability to modify and return a new transport
response message of the same type. Read more
A hook called when an attempt is completed. This method has the
ability to modify and return a new output message or error
matching the currently-executing operation. Read more
A hook called when an execution is completed.
This method has the ability to modify and return a new
output message or error matching the currently - executing
operation. Read more