ServiceRequestContext (Armeria 0.55.0 API reference)

All Superinterfaces:

AttributeMap, 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 Instance Methods Abstract Methods Default Methods Deprecated Methods
Modifier and Type	Method and Description
`ExecutorService`	`blockingTaskExecutor()` Returns the `ExecutorService` that could be used for executing a potentially long-running task.
`Logger`	`logger()` Deprecated. Use a logging framework integration such as `RequestContextExportingAppender` in `armeria-logback`.
`String`	`mappedPath()` Returns the path with its context path removed.
`long`	`maxRequestLength()` Returns the maximum length of the current `Request`.
`MediaType`	`negotiatedProduceType()` Returns the negotiated producible media type.
`PathMapping`	`pathMapping()` Returns the `PathMapping` associated with the `Service` that is handling the current `Request`.
`PathMappingContext`	`pathMappingContext()` Returns the `PathMappingContext` used to find the `Service`.
`default String`	`pathParam(String name)` Returns the value of the specified path parameter.
`Map<String,String>`	`pathParams()` Returns the path parameters mapped by the `PathMapping` associated with the `Service` that is handling the current `Request`.
`long`	`requestTimeoutMillis()` Returns the amount of time allowed until receiving the current `Request` completely.
`Server`	`server()` Returns the `Server` that is handling the current `Request`.
`<T extends Service<HttpRequest,HttpResponse>> T`	`service()` Returns the `Service` that is handling the current `Request`.
`void`	`setMaxRequestLength(long maxRequestLength)` Sets the maximum length of the current `Request`.
`void`	`setRequestTimeout(Duration requestTimeout)` Sets the amount of time allowed until receiving the current `Request` completely.
`void`	`setRequestTimeoutHandler(Runnable requestTimeoutHandler)` Sets a handler to run when the request times out.
`void`	`setRequestTimeoutMillis(long requestTimeoutMillis)` Sets the amount of time allowed until receiving the current `Request` completely.
`VirtualHost`	`virtualHost()` Returns the `VirtualHost` that is handling the current `Request`.

Methods inherited from interface com.linecorp.armeria.common.RequestContext
alloc, attrs, contextAwareEventLoop, current, eventLoop, invokeOnChildCallbacks, invokeOnEnterCallbacks, invokeOnExitCallbacks, isTimedOut, localAddress, log, logBuilder, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, mapCurrent, meterRegistry, method, onChild, onEnter, onEnter, onExit, onExit, path, push, push, query, rejectPromise, remoteAddress, request, resolvePromise, sessionProtocol, sslSession

Methods inherited from interface io.netty.util.AttributeMap
attr, hasAttr

- Method Detail
  - server
```
Server server()
```
    Returns the Server that is handling the current Request.
  - virtualHost
```
VirtualHost virtualHost()
```
    Returns the VirtualHost that is handling the current Request.
  - pathMapping
```
PathMapping pathMapping()
```
    Returns the PathMapping associated with the Service that is handling the current Request.
  - pathMappingContext
```
PathMappingContext pathMappingContext()
```
    Returns the PathMappingContext used to find the Service.
  - pathParams
```
Map<String,String> pathParams()
```
    Returns the path parameters mapped by the PathMapping 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
```
<T extends Service<HttpRequest,HttpResponse>> T service()
```
    Returns the Service that is handling the current Request.
  - blockingTaskExecutor
```
ExecutorService blockingTaskExecutor()
```
    Returns the ExecutorService that could be used for executing a potentially long-running task. The ExecutorService 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 path with its context path removed. This method can be useful for a reusable service bound at various path prefixes.
  - negotiatedProduceType
```
@Nullable
MediaType negotiatedProduceType()
```
    Returns the negotiated producible media type. If the media type negotiation is not used for the Service, null would be returned.
  - logger
```
@Deprecated
Logger logger()
```
    Deprecated. Use a logging framework integration such as RequestContextExportingAppender in armeria-logback.
    
    Returns the Logger of the Service.
  - requestTimeoutMillis
```
long requestTimeoutMillis()
```
    Returns the amount of time allowed until receiving the current Request completely. This value is initially set from ServerConfig.defaultRequestTimeoutMillis().
  - setRequestTimeoutMillis
```
void setRequestTimeoutMillis(long requestTimeoutMillis)
```
    Sets the amount of time allowed until receiving the current Request completely. This value is initially set from ServerConfig.defaultRequestTimeoutMillis().
  - setRequestTimeout
```
void setRequestTimeout(Duration requestTimeout)
```
    Sets the amount of time allowed until receiving the current Request completely. This value is initially set from ServerConfig.defaultRequestTimeoutMillis().
  - setRequestTimeoutHandler
```
void setRequestTimeoutHandler(Runnable requestTimeoutHandler)
```
    Sets a handler to run when the request times out. requestTimeoutHandler must close the response, e.g., by calling HttpResponseWriter.respond(int). If not set, the response will be closed with HttpStatus.SERVICE_UNAVAILABLE.
    For example,
```
   DefaultHttpResponse res = new DefaultHttpResponse();
   ctx.setRequestTimeoutHandler(() -> {
      res.respond(HttpStatus.OK, MediaType.PLAIN_TEXT_UTF_8, "Request timed out.");
   });
   ...
 
```
  - maxRequestLength
```
long maxRequestLength()
```
    Returns the maximum length of the current Request. This value is initially set from ServerConfig.defaultMaxRequestLength().
    
    See Also:
    
    ContentTooLargeException
  - setMaxRequestLength
```
void setMaxRequestLength(long maxRequestLength)
```
    Sets the maximum length of the current Request. This value is initially set from ServerConfig.defaultMaxRequestLength().
    
    See Also:
    
    ContentTooLargeException

Interface ServiceRequestContext

Method Summary

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

Methods inherited from interface io.netty.util.AttributeMap

Method Detail

server

virtualHost

pathMapping

pathMappingContext

pathParams

pathParam

service

blockingTaskExecutor

mappedPath

negotiatedProduceType

logger

requestTimeoutMillis

setRequestTimeoutMillis

setRequestTimeout

setRequestTimeoutHandler

maxRequestLength

setMaxRequestLength