Configures this server or client with given exception stats handler.
Configures this server or client with given label
(default: empty string).
Configures this server or client with given label
(default: empty string).
The label
value is used for stats reporting to scope stats reported
from different clients/servers to a single stats receiver.
Configures this server or client with given util.Monitor (default: com.twitter.finagle.util.DefaultMonitor).
Configures the Tunable request timeout
of this server or client (if applying the
Tunable produces a value of None
, an unbounded timeout is used for the request).
Configures the Tunable request timeout
of this server or client (if applying the
Tunable produces a value of None
, an unbounded timeout is used for the request).
If the request has not completed within the Duration resulting from timeout.apply()
,
the pending work will be interrupted via com.twitter.util.Future.raise.
The client request timeout is the maximum amount of time given to a single request (if there are retries, they each get a fresh request timeout). The timeout is applied only after a connection has been acquired. That is: it is applied to the interval between the dispatch of the request and the receipt of the response.
The server request timeout is the maximum amount of time, a server is allowed to spend handling the incoming request. Using the Finagle terminology, this is an amount of time after which a non-satisfied future returned from the user-defined service times out.
Configures the request timeout
of this server or client (default: unbounded).
Configures the request timeout
of this server or client (default: unbounded).
If the request has not completed within the given timeout
, the pending
work will be interrupted via com.twitter.util.Future.raise.
The client request timeout is the maximum amount of time given to a single request (if there are retries, they each get a fresh request timeout). The timeout is applied only after a connection has been acquired. That is: it is applied to the interval between the dispatch of the request and the receipt of the response.
The server request timeout is the maximum amount of time, a server is allowed to spend handling the incoming request. Using the Finagle terminology, this is an amount of time after which a non-satisfied future returned from the user-defined service times out.
Configure a com.twitter.finagle.service.ResponseClassifier which is used to determine the result of a request/response.
Configure a com.twitter.finagle.service.ResponseClassifier which is used to determine the result of a request/response.
This allows developers to give Finagle the additional application-specific knowledge necessary in order to properly classify responses. Without this, Finagle cannot make judgements about application-level failures as it only has a narrow understanding of failures (for example: transport level, timeouts, and nacks).
As an example take an HTTP server that returns a response with a 500 status code. To Finagle this is a successful request/response. However, the application developer may want to treat all 500 status codes as failures and can do so via setting a com.twitter.finagle.service.ResponseClassifier.
ResponseClassifier is a PartialFunction and as such multiple classifiers can be composed together via PartialFunction.orElse.
Response classification is independently configured on the client and server.
For client-side response classification using com.twitter.finagle.builder.ClientBuilder,
see com.twitter.finagle.builder.ClientBuilder.responseClassifier
If unspecified, the default classifier is com.twitter.finagle.service.ResponseClassifier.Default which is a total function fully covering the input domain.
com.twitter.finagle.http.service.HttpResponseClassifier
for some
HTTP classification tools.
Configures this server or client with given stats.StatsReceiver (default: stats.DefaultStatsReceiver).
Configures this server or client with given tracing.Tracer (default: com.twitter.finagle.tracing.DefaultTracer).
A collection of methods for configuring common parameters (labels, stats receivers, etc) shared between Finagle clients and servers.
a Stack.Parameterized server/client to configure