Uses of Interface
org.microproxy.ProxyFailure

Packages that use ProxyFailure

Package	Description
org.microproxy

Uses of ProxyFailure in org.microproxy

Classes in org.microproxy that implement ProxyFailure

Modifier and Type	Class	Description
static final record	ProxyFailure.BadRequest	The proxy refuses the request: an origin-form request without HttpProxyServerBootstrap.withAllowRequestToOriginServer(boolean), an https:// request without HttpProxyServerBootstrap.withTlsOrigination(boolean), or a CONNECT target that is not host:port.
static final record	ProxyFailure.BadServerResponse	The server's response was malformed, or the server closed the connection or failed before the response head (or a body the filters asked to buffer) was complete.
static final record	ProxyFailure.ConnectFailed	No connection could be made to the server or any chained proxy offered for it: refused, unreachable, timed out, a chained proxy whose own name did not resolve, or a chained proxy that refused the CONNECT or SOCKS request.
static final record	ProxyFailure.NoConnectionAvailable	The shared connection pool had no connection to spare within the connect timeout.
static final record	ProxyFailure.NoRoute	There is nowhere to send the request: it names no host (hostAndPort is null), or the ChainedProxyManager offered no route.
static final record	ProxyFailure.RequestTooLarge	The request body is larger than the filters asked to buffer (maxBytes).
static final record	ProxyFailure.ServerTimeout	The server did not answer within the idle timeout.
static final record	ProxyFailure.TlsFailed	The TLS handshake with the server (when intercepting) or with a TLS chained proxy failed or did not finish within HttpProxyServerBootstrap.withTlsHandshakeTimeout(java.time.Duration) (or the request's HttpFilters.proxyToServerTlsHandshakeTimeout()), e.g. because its certificate is not trusted.
static final record	ProxyFailure.UnresolvedHost	The server's name did not resolve (direct connections).

Methods in org.microproxy that return types with arguments of type ProxyFailure

Modifier and Type	Method	Description
Optional<ProxyFailure>	FlowContext.failure()	Why the proxy had to answer the exchange in progress on this connection (or the last one) itself, or abandon it: the failure handed to HttpFilters.proxyToServerFailure(org.microproxy.ProxyFailure), set before the filters see it.
Optional<ProxyFailure>	FlowRecord.failure()	Returns why the proxy had to answer itself (see FlowContext.failure()), or empty.

Methods in org.microproxy with parameters of type ProxyFailure

Modifier and Type	Method	Description
FlowRecord.Builder	FlowRecord.Builder.outcome(Set<ResponseFlag> flags, ProxyFailure failure, String details)	Sets the outcome: flags, failure and details.
default HttpResponse	HttpFilters.proxyToServerFailure(ProxyFailure failure)	Called when the proxy is about to answer this request itself because of failure (the server could not be reached, timed out or answered badly, the request was refused, ...).
HttpResponse	HttpFiltersBuilder.Built.proxyToServerFailure(ProxyFailure failure)
HttpResponse	HttpFiltersChain.Chained.proxyToServerFailure(ProxyFailure failure)
HttpResponse	FailureResponder.respond(HttpRequest request, ProxyFailure failure)	Returns the response for failure, or null for the proxy's default.

Method parameters in org.microproxy with type arguments of type ProxyFailure

Modifier and Type	Method	Description
HttpFiltersBuilder	HttpFiltersBuilder.onFailure(Function<ProxyFailure,HttpResponse> hook)	The proxy's own answer when the request fails (proxyToServerFailure): return a response to send instead of the default, or null.