ServiceRequestContext (filter-service-metrics 1.13 1.13 API)

All Superinterfaces:

RequestContext

All Known Implementing Classes:

DefaultServiceRequestContext, ServiceRequestContextWrapper
```
public interface ServiceRequestContext
extends RequestContext
```
Provides information about an invocation and related utilities. Every request being handled has its own ServiceRequestContext instance.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`AccessLogWriter`	`accessLogWriter()` Returns the `AccessLogWriter`.
`void`	`addAdditionalResponseHeader(CharSequence name, Object value)` Adds a header with the specified `name` and `value`.
`void`	`addAdditionalResponseHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)` Adds the specified `HttpHeaders` which is included when a `Service` sends an `HttpResponse`.
`void`	`addAdditionalResponseTrailer(CharSequence name, Object value)` Adds a trailer with the specified `name` and `value`.
`void`	`addAdditionalResponseTrailers(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)` Adds the specified `HttpHeaders` which is included when a `Service` completes an `HttpResponse`.
`HttpHeaders`	`additionalResponseHeaders()` Returns an immutable `HttpHeaders` which is included when a `Service` sends an `HttpResponse`.
`HttpHeaders`	`additionalResponseTrailers()` Returns the `HttpHeaders` which is returned along with any other trailers when a `Service` completes an `HttpResponse`.
`ScheduledExecutorService`	`blockingTaskExecutor()` Returns the `ScheduledExecutorService` that could be used for executing a potentially long-running task.
`static ServiceRequestContextBuilder`	`builder(HttpRequest request)` Returns a new `ServiceRequestContextBuilder` created from the specified `HttpRequest`.
`void`	`clearRequestTimeout()` Clears the previously scheduled request timeout, if any.
`default InetAddress`	`clientAddress()` Returns the address of the client who initiated this request.
`static ServiceRequestContext`	`current()` Returns the server-side context of the `Request` that is being handled in the current thread.
`static ServiceRequestContext`	`currentOrNull()` Returns the server-side context of the `Request` that is being handled in the current thread.
`String`	`decodedMappedPath()` Returns the `RequestContext.decodedPath()` with its context path removed.
`void`	`extendRequestTimeout(Duration adjustment)` Extends the previously scheduled request timeout by the specified amount of `adjustment`.
`void`	`extendRequestTimeoutMillis(long adjustmentMillis)` Extends the previously scheduled request timeout by the specified amount of `adjustmentMillis`.
`boolean`	`isTimedOut()` Returns whether this `ServiceRequestContext` has been timed-out (e.g., when the corresponding request passes a deadline).
`<A extends SocketAddress> A`	`localAddress()` Returns the local address of this request.
`static <T> T`	`mapCurrent(Function<? super ServiceRequestContext,T> mapper, Supplier<T> defaultValueSupplier)` Maps the server-side context of the `Request` that is being handled in the current thread.
`String`	`mappedPath()` Returns the `RequestContext.path()` with its context path removed.
`long`	`maxRequestLength()` Returns the maximum length of the current `Request`.
`default MediaType`	`negotiatedProduceType()` Deprecated. Use `negotiatedResponseMediaType()`.
`MediaType`	`negotiatedResponseMediaType()` Returns the negotiated producible media type.
`ServiceRequestContext`	`newDerivedContext(RequestId id, HttpRequest req, RpcRequest rpcReq)` Creates a new `RequestContext` whose properties and `RequestContext.attrs()` are copied from this `RequestContext`, except having a different pair of `HttpRequest` and `RpcRequest` and its own `RequestLog`.
`static ServiceRequestContext`	`of(HttpRequest request)` Returns a new `ServiceRequestContext` created from the specified `HttpRequest`.
`default String`	`pathParam(String name)` Returns the value of the specified path parameter.
`Map<String,String>`	`pathParams()` Returns the path parameters mapped by the `route()` associated with the `Service` that is handling the current `Request`.
`ProxiedAddresses`	`proxiedAddresses()` Returns the proxied addresses of the current `Request`.
`default SafeCloseable`	`push()` Pushes this context to the thread-local stack.
`<A extends SocketAddress> A`	`remoteAddress()` Returns the remote address of this request.
`boolean`	`removeAdditionalResponseHeader(CharSequence name)` Removes all headers with the specified `name`.
`boolean`	`removeAdditionalResponseTrailer(CharSequence name)` Removes all trailers with the specified `name`.
`HttpRequest`	`request()` Returns the `HttpRequest` associated with this context.
`Runnable`	`requestTimeoutHandler()` Returns `Request` timeout handler which is executed when receiving the current `Request` and sending the corresponding `Response` is not completely received within the allowed `requestTimeoutMillis()`.
`long`	`requestTimeoutMillis()` Returns the amount of time allowed from the start time of the `Request` until receiving the current `Request` and sending the corresponding `Response` completely.
`Route`	`route()` Returns the `Route` associated with the `Service` that is handling the current `Request`.
`RoutingContext`	`routingContext()` Returns the `RoutingContext` used to find the `Service`.
`RpcRequest`	`rpcRequest()` Returns the `RpcRequest` associated with this context, or `null` if there's no `RpcRequest` associated with this context.
`Server`	`server()` Returns the `Server` that is handling the current `Request`.
`HttpService`	`service()` Returns the `HttpService` that is handling the current `Request`.
`void`	`setAdditionalResponseHeader(CharSequence name, Object value)` Sets a header with the specified `name` and `value`.
`void`	`setAdditionalResponseHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)` Clears the current header and sets the specified `HttpHeaders` which is included when a `Service` sends an `HttpResponse`.
`void`	`setAdditionalResponseTrailer(CharSequence name, Object value)` Sets a trailer with the specified `name` and `value`.
`void`	`setAdditionalResponseTrailers(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)` Clears the current trailer and sets the specified `HttpHeaders` which is included when a `Service` completes an `HttpResponse`.
`void`	`setMaxRequestLength(long maxRequestLength)` Sets the maximum length of the current `Request`.
`void`	`setRequestTimeout(Duration requestTimeout)` Deprecated. Use `extendRequestTimeout(Duration)`, `setRequestTimeoutAfter(Duration)`, `setRequestTimeoutAt(Instant)` or `clearRequestTimeout()`
`void`	`setRequestTimeoutAfter(Duration requestTimeout)` Schedules the request timeout that is triggered when the `Request` is not fully received or the corresponding `Response` is not sent completely within the specified amount time from now.
`void`	`setRequestTimeoutAfterMillis(long requestTimeoutMillis)` Schedules the request timeout that is triggered when the `Request` is not fully received or the corresponding `Response` is not sent completely within the specified amount of time from now.
`void`	`setRequestTimeoutAt(Instant requestTimeoutAt)` Schedules the request timeout that is triggered at the specified time represented as the number since the epoch (`1970-01-01T00:00:00Z`).
`void`	`setRequestTimeoutAtMillis(long requestTimeoutAtMillis)` Schedules the request timeout that is triggered at the specified time represented as the number since the epoch (`1970-01-01T00:00:00Z`).
`void`	`setRequestTimeoutHandler(Runnable requestTimeoutHandler)` Sets a handler to run when the request times out.
`void`	`setRequestTimeoutMillis(long requestTimeoutMillis)` Deprecated. Use `extendRequestTimeoutMillis(long)`)}, `setRequestTimeoutAfterMillis(long)`, `setRequestTimeoutAtMillis(long)` or `clearRequestTimeout()`
`boolean`	`verboseResponses()` Returns whether the verbose response mode is enabled.
`VirtualHost`	`virtualHost()` Returns the `VirtualHost` that is handling the current `Request`.

Methods inherited from interface com.linecorp.armeria.common.RequestContext
alloc, attr, attrs, computeAttrIfAbsent, contextAwareEventLoop, contextAwareExecutor, decodedPath, eventLoop, executor, id, log, logBuilder, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, mapCurrent, meterRegistry, method, path, push, push, push, pushIfAbsent, query, rejectPromise, replace, resolvePromise, sessionProtocol, setAttr, setAttrIfAbsent, sslSession, updateRequest, updateRpcRequest

- Method Detail
  - current
```
static ServiceRequestContext current()
```
    Returns the server-side context of the Request that is being handled in the current thread. If the context is a ClientRequestContext, ClientRequestContext.root() is returned.
    
    Specified by:
    
    current in interface RequestContext
    
    Throws:
    
    IllegalStateException - if the context is unavailable in the current thread or the current context is a ClientRequestContext and ClientRequestContext.root() is null
  - currentOrNull
```
static ServiceRequestContext currentOrNull()
```
    Returns the server-side context of the Request that is being handled in the current thread. If the context is a ClientRequestContext, ClientRequestContext.root() is returned.
    
    Specified by:
    
    currentOrNull in interface RequestContext
    
    Returns:
    
    the ServiceRequestContext available in the current thread, or null if unavailable.
  - mapCurrent
```
static <T> T mapCurrent(Function<? super ServiceRequestContext,T> mapper,
                        Supplier<T> defaultValueSupplier)
```
    Maps the server-side context of the Request that is being handled in the current thread.
    
    Parameters:
    
    mapper - the Function that maps the ServiceRequestContext
    
    defaultValueSupplier - the Supplier that provides the value when the context is unavailable in the current thread. If null, the null will be returned when the context is unavailable in the current thread.
    
    Throws:
    
    IllegalStateException - if the current context is not a ServiceRequestContext.
  - of
```
static ServiceRequestContext of(HttpRequest request)
```
    Returns a new ServiceRequestContext created from the specified HttpRequest. Note that it is not usually required to create a new context by yourself, because Armeria will always provide a context object for you. However, it may be useful in some cases such as unit testing.
    
    See Also:
    
    ServiceRequestContextBuilder
  - builder
```
static ServiceRequestContextBuilder builder(HttpRequest request)
```
    Returns a new ServiceRequestContextBuilder created from the specified HttpRequest.
  - request
```
HttpRequest request()
```
    Returns the HttpRequest associated with this context.
    
    Specified by:
    
    request in interface RequestContext
  - rpcRequest
```
RpcRequest rpcRequest()
```
    Returns the RpcRequest associated with this context, or null if there's no RpcRequest associated with this context. For example, this method will return null when the request being handled is 1) not an RPC request or 2) not decoded into an RPC request yet.
    
    Specified by:
    
    rpcRequest in interface RequestContext
  - remoteAddress
```
<A extends SocketAddress> A remoteAddress()
```
    Returns the remote address of this request.
    
    Specified by:
    
    remoteAddress in interface RequestContext
  - localAddress
```
<A extends SocketAddress> A localAddress()
```
    Returns the local address of this request.
    
    Specified by:
    
    localAddress in interface RequestContext
  - clientAddress
```
default InetAddress clientAddress()
```
    Returns the address of the client who initiated this request.
  - push
```
default SafeCloseable push()
```
    Pushes this context to the thread-local stack. To pop the context from the stack, call SafeCloseable.close(), which can be done using a try-with-resources block:
```
 try (SafeCloseable ignored = ctx.push()) {
     ...
 }
 
```
    In order to call this method, the current thread-local state must meet one of the following conditions:
    - the thread-local does not have any RequestContext in it
    - the thread-local has the same ServiceRequestContext as this - reentrance
    - the thread-local has the ClientRequestContext whose ClientRequestContext.root() is the same ServiceRequestContext as this
    Otherwise, this method will throw an IllegalStateException.
    Specified by:
    
    push in interface RequestContext
  - newDerivedContext
```
ServiceRequestContext newDerivedContext(RequestId id,
                                        HttpRequest req,
                                        RpcRequest rpcReq)
```
    Description copied from interface: RequestContext
    
    Creates a new RequestContext whose properties and RequestContext.attrs() are copied from this RequestContext, except having a different pair of HttpRequest and RpcRequest and its own RequestLog.
    
    Specified by:
    
    newDerivedContext in interface RequestContext
  - server
```
Server server()
```
    Returns the Server that is handling the current Request.
  - virtualHost
```
VirtualHost virtualHost()
```
    Returns the VirtualHost that is handling the current Request.
  - route
```
Route route()
```
    Returns the Route associated with the Service that is handling the current Request.
  - routingContext
```
RoutingContext routingContext()
```
    Returns the RoutingContext used to find the Service.
  - pathParams
```
Map<String,String> pathParams()
```
    Returns the path parameters mapped by the route() associated with the Service that is handling the current Request.
  - pathParam
```
default String pathParam(String name)
```
    Returns the value of the specified path parameter.
  - service
```
HttpService service()
```
    Returns the HttpService that is handling the current Request.
  - blockingTaskExecutor
```
ScheduledExecutorService blockingTaskExecutor()
```
    Returns the ScheduledExecutorService that could be used for executing a potentially long-running task. The ScheduledExecutorService will propagate the ServiceRequestContext automatically when running a task.
    Note that performing a long-running task in Service.serve(ServiceRequestContext, Request) may block the Server's I/O event loop and thus should be executed in other threads.
  - mappedPath
```
String mappedPath()
```
    Returns the RequestContext.path() with its context path removed. This method can be useful for a reusable service bound at various path prefixes.
  - decodedMappedPath
```
String decodedMappedPath()
```
    Returns the RequestContext.decodedPath() with its context path removed. This method can be useful for a reusable service bound at various path prefixes.
  - negotiatedResponseMediaType
```
MediaType negotiatedResponseMediaType()
```
    Returns the negotiated producible media type. If the media type negotiation is not used for the Service, null would be returned.
  - negotiatedProduceType
```
@Deprecated
default MediaType negotiatedProduceType()
```
    Deprecated. Use negotiatedResponseMediaType().
    
    Returns the negotiated producible media type. If the media type negotiation is not used for the Service, null would be returned.
  - requestTimeoutMillis
```
long requestTimeoutMillis()
```
    Returns the amount of time allowed from the start time of the Request until receiving the current Request and sending the corresponding Response completely. This value is initially set from ServiceConfig.requestTimeoutMillis().
  - clearRequestTimeout
```
void clearRequestTimeout()
```
    Clears the previously scheduled request timeout, if any. Note that calling this will prevent the request from ever being timed out.
  - setRequestTimeoutMillis
```
@Deprecated
void setRequestTimeoutMillis(long requestTimeoutMillis)
```
    Deprecated. Use extendRequestTimeoutMillis(long))}, setRequestTimeoutAfterMillis(long), setRequestTimeoutAtMillis(long) or clearRequestTimeout()
    Schedules the request timeout that is triggered when the Request is not fully received or the corresponding Response is not sent completely since the Request started. This value is initially set from ServiceConfig.requestTimeoutMillis().
    For example:
```
 ServiceRequestContext ctx = ...;
 ctx.setRequestTimeoutMillis(1000);
 assert ctx.requestTimeoutMillis() == 1000;
 ctx.setRequestTimeoutMillis(2000);
 assert ctx.requestTimeoutMillis() == 2000;
 
```
    Parameters:
    
    requestTimeoutMillis - the amount of time in milliseconds from the start time of the request
  - setRequestTimeout
```
@Deprecated
void setRequestTimeout(Duration requestTimeout)
```
    Deprecated. Use extendRequestTimeout(Duration), setRequestTimeoutAfter(Duration), setRequestTimeoutAt(Instant) or clearRequestTimeout()
    Schedules the request timeout that is triggered when the Request is not fully received or the corresponding Response is not sent completely since the Request started. This value is initially set from ServiceConfig.requestTimeoutMillis().
    For example:
```
 ServiceRequestContext ctx = ...;
 ctx.setRequestTimeout(Duration.ofSeconds(1));
 assert ctx.requestTimeoutMillis() == 1000;
 ctx.setRequestTimeout(Duration.ofSeconds(2));
 assert ctx.requestTimeoutMillis() == 2000;
 
```
    Parameters:
    
    requestTimeout - the amount of time from the start time of the request
  - extendRequestTimeoutMillis
```
void extendRequestTimeoutMillis(long adjustmentMillis)
```
    Extends the previously scheduled request timeout by the specified amount of adjustmentMillis. This method does nothing if no request timeout was scheduled previously. Note that a negative adjustment reduces the current timeout. The initial timeout is set from ServiceConfig.requestTimeoutMillis().
    For example:
```
 ServiceRequestContext ctx = ...;
 long oldRequestTimeoutMillis = ctx.requestTimeoutMillis();
 ctx.extendRequestTimeoutMillis(1000);
 assert ctx.requestTimeoutMillis() == oldRequestTimeoutMillis + 1000;
 ctx.extendRequestTimeoutMillis(-500);
 assert ctx.requestTimeoutMillis() == oldRequestTimeoutMillis + 500;
 
```
    Parameters:
    
    adjustmentMillis - the amount of time in milliseconds to extend the current timeout by
  - extendRequestTimeout
```
void extendRequestTimeout(Duration adjustment)
```
    Extends the previously scheduled request timeout by the specified amount of adjustment. This method does nothing if no response timeout was scheduled previously. Note that a negative adjustment reduces the current timeout. The initial timeout is set from ServiceConfig.requestTimeoutMillis().
    For example:
```
 ServiceRequestContext ctx = ...;
 long oldRequestTimeoutMillis = ctx.requestTimeoutMillis();
 ctx.extendRequestTimeout(Duration.ofSeconds(1));
 assert ctx.requestTimeoutMillis() == oldRequestTimeoutMillis + 1000;
 ctx.extendRequestTimeout(Duration.ofMillis(-500));
 assert ctx.requestTimeoutMillis() == oldRequestTimeoutMillis + 500;
 
```
    Parameters:
    
    adjustment - the amount of time to extend the current timeout by
  - setRequestTimeoutAfterMillis
```
void setRequestTimeoutAfterMillis(long requestTimeoutMillis)
```
    Schedules the request timeout that is triggered when the Request is not fully received or the corresponding Response is not sent completely within the specified amount of time from now. Note that the specified requestTimeoutMillis must be positive. The initial timeout is set from ServiceConfig.requestTimeoutMillis().
    For example:
```
 ServiceRequestContext ctx = ...;
 // Schedules timeout after 1 seconds from now.
 ctx.setRequestTimeoutAfterMillis(1000);
 
```
    Parameters:
    
    requestTimeoutMillis - the amount of time allowed in milliseconds from now
  - setRequestTimeoutAfter
```
void setRequestTimeoutAfter(Duration requestTimeout)
```
    Schedules the request timeout that is triggered when the Request is not fully received or the corresponding Response is not sent completely within the specified amount time from now. Note that the specified requestTimeout must be positive. The initial timeout is set from ServiceConfig.requestTimeoutMillis().
    For example:
```
 ServiceRequestContext ctx = ...;
 // Schedules timeout after 1 seconds from now.
 ctx.setRequestTimeoutAfter(Duration.ofSeconds(1));
 
```
    Parameters:
    
    requestTimeout - the amount of time allowed from now
  - setRequestTimeoutAtMillis
```
void setRequestTimeoutAtMillis(long requestTimeoutAtMillis)
```
    Schedules the request timeout that is triggered at the specified time represented as the number since the epoch (1970-01-01T00:00:00Z). Note that the request will be timed out immediately if the specified time is before now. The initial timeout is set from ServiceConfig.requestTimeoutMillis().
    For example:
```
 ServiceRequestContext ctx = ...;
 // Schedules timeout after 1 seconds from now.
 long responseTimeoutAt = Instant.now().plus(1, ChronoUnit.SECONDS).toEpochMilli();
 ctx.setRequestTimeoutAtMillis(responseTimeoutAt);
 
```
    Parameters:
    
    requestTimeoutAtMillis - the request timeout represented as the number of milliseconds since the epoch (1970-01-01T00:00:00Z)
  - setRequestTimeoutAt
```
void setRequestTimeoutAt(Instant requestTimeoutAt)
```
    Schedules the request timeout that is triggered at the specified time represented as the number since the epoch (1970-01-01T00:00:00Z). Note that the request will be timed out immediately if the specified time is before now. The initial timeout is set from ServiceConfig.requestTimeoutMillis().
    For example:
```
 ServiceRequestContext ctx = ...;
 // Schedules timeout after 1 seconds from now.
 ctx.setRequestTimeoutAt(Instant.now().plus(1, ChronoUnit.SECONDS));
 
```
    Parameters:
    
    requestTimeoutAt - the request timeout represented as the number of milliseconds since the epoch (1970-01-01T00:00:00Z)
  - requestTimeoutHandler
```
Runnable requestTimeoutHandler()
```
    Returns Request timeout handler which is executed when receiving the current Request and sending the corresponding Response is not completely received within the allowed requestTimeoutMillis().
  - setRequestTimeoutHandler
```
void setRequestTimeoutHandler(Runnable requestTimeoutHandler)
```
    Sets a handler to run when the request times out. requestTimeoutHandler must close the response, e.g., by calling StreamWriter.close(). If not set, the response will be closed with HttpStatus.SERVICE_UNAVAILABLE.
    For example,
```
   HttpResponseWriter res = HttpResponse.streaming();
   ctx.setRequestTimeoutHandler(() -> {
      res.write(ResponseHeaders.of(HttpStatus.OK,
                                   HttpHeaderNames.CONTENT_TYPE, MediaType.PLAIN_TEXT_UTF_8));
      res.write(HttpData.ofUtf8("Request timed out."));
      res.close();
   });
   ...
 
```
  - isTimedOut
```
boolean isTimedOut()
```
    Returns whether this ServiceRequestContext has been timed-out (e.g., when the corresponding request passes a deadline).
  - maxRequestLength
```
long maxRequestLength()
```
    Returns the maximum length of the current Request. This value is initially set from ServiceConfig.maxRequestLength(). If 0, there is no limit on the request size.
    
    See Also:
    
    ContentTooLargeException
  - setMaxRequestLength
```
void setMaxRequestLength(long maxRequestLength)
```
    Sets the maximum length of the current Request. This value is initially set from ServiceConfig.maxRequestLength(). If 0, there is no limit on the request size.
    
    See Also:
    
    ContentTooLargeException
  - verboseResponses
```
boolean verboseResponses()
```
    Returns whether the verbose response mode is enabled. When enabled, the service responses will contain the exception type and its full stack trace, which may be useful for debugging while potentially insecure. When disabled, the service responses will not expose such server-side details to the client.
  - accessLogWriter
```
AccessLogWriter accessLogWriter()
```
    Returns the AccessLogWriter.
  - additionalResponseHeaders
```
HttpHeaders additionalResponseHeaders()
```
    Returns an immutable HttpHeaders which is included when a Service sends an HttpResponse.
  - setAdditionalResponseHeader
```
void setAdditionalResponseHeader(CharSequence name,
                                 Object value)
```
    Sets a header with the specified name and value. This will remove all previous values associated with the specified name. The header will be included when a Service sends an HttpResponse.
  - setAdditionalResponseHeaders
```
void setAdditionalResponseHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)
```
    Clears the current header and sets the specified HttpHeaders which is included when a Service sends an HttpResponse.
  - addAdditionalResponseHeader
```
void addAdditionalResponseHeader(CharSequence name,
                                 Object value)
```
    Adds a header with the specified name and value. The header will be included when a Service sends an HttpResponse.
  - addAdditionalResponseHeaders
```
void addAdditionalResponseHeaders(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)
```
    Adds the specified HttpHeaders which is included when a Service sends an HttpResponse.
  - removeAdditionalResponseHeader
```
boolean removeAdditionalResponseHeader(CharSequence name)
```
    Removes all headers with the specified name.
    
    Returns:
    
    true if at least one entry has been removed
  - additionalResponseTrailers
```
HttpHeaders additionalResponseTrailers()
```
    Returns the HttpHeaders which is returned along with any other trailers when a Service completes an HttpResponse.
  - setAdditionalResponseTrailer
```
void setAdditionalResponseTrailer(CharSequence name,
                                  Object value)
```
    Sets a trailer with the specified name and value. This will remove all previous values associated with the specified name. The trailer will be included when a Service completes an HttpResponse.
  - setAdditionalResponseTrailers
```
void setAdditionalResponseTrailers(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)
```
    Clears the current trailer and sets the specified HttpHeaders which is included when a Service completes an HttpResponse.
  - addAdditionalResponseTrailer
```
void addAdditionalResponseTrailer(CharSequence name,
                                  Object value)
```
    Adds a trailer with the specified name and value. The trailer will be included when a Service completes an HttpResponse.
  - addAdditionalResponseTrailers
```
void addAdditionalResponseTrailers(Iterable<? extends Map.Entry<? extends CharSequence,?>> headers)
```
    Adds the specified HttpHeaders which is included when a Service completes an HttpResponse.
  - removeAdditionalResponseTrailer
```
boolean removeAdditionalResponseTrailer(CharSequence name)
```
    Removes all trailers with the specified name.
    
    Returns:
    
    true if at least one entry has been removed
  - proxiedAddresses
```
ProxiedAddresses proxiedAddresses()
```
    Returns the proxied addresses of the current Request.

Interface ServiceRequestContext

Method Summary

Methods inherited from interface com.linecorp.armeria.common.RequestContext

Method Detail

current

currentOrNull

mapCurrent

of

builder

request

rpcRequest

remoteAddress

localAddress

clientAddress

push

newDerivedContext

server

virtualHost

route

routingContext

pathParams

pathParam

service

blockingTaskExecutor

mappedPath

decodedMappedPath

negotiatedResponseMediaType

negotiatedProduceType

requestTimeoutMillis

clearRequestTimeout

setRequestTimeoutMillis

setRequestTimeout

extendRequestTimeoutMillis

extendRequestTimeout

setRequestTimeoutAfterMillis

setRequestTimeoutAfter

setRequestTimeoutAtMillis

setRequestTimeoutAt

requestTimeoutHandler

setRequestTimeoutHandler

isTimedOut

maxRequestLength

setMaxRequestLength

verboseResponses

accessLogWriter

additionalResponseHeaders

setAdditionalResponseHeader

setAdditionalResponseHeaders

addAdditionalResponseHeader

addAdditionalResponseHeaders

removeAdditionalResponseHeader

additionalResponseTrailers

setAdditionalResponseTrailer

setAdditionalResponseTrailers

addAdditionalResponseTrailer

addAdditionalResponseTrailers

removeAdditionalResponseTrailer

proxiedAddresses