com.linecorp.armeria.server

Class DefaultServiceRequestContext

java.lang.Object

com.linecorp.armeria.common.AbstractRequestContext

com.linecorp.armeria.common.NonWrappingRequestContext

com.linecorp.armeria.server.DefaultServiceRequestContext

All Implemented Interfaces:

RequestContext, ServiceRequestContext, io.netty.util.AttributeMap

public class DefaultServiceRequestContext
extends NonWrappingRequestContext
implements ServiceRequestContext

Default ServiceRequestContext implementation.

Constructor Summary

Constructors

Constructor and Description
DefaultServiceRequestContext(ServiceConfig cfg, io.netty.channel.Channel ch, SessionProtocol sessionProtocol, java.lang.String method, java.lang.String path, java.lang.String mappedPath, java.lang.Object request, javax.net.ssl.SSLSession sslSession) Creates a new instance.

Method Summary

Modifier and Type	Method and Description
java.util.concurrent.ExecutorService	blockingTaskExecutor() Returns the ExecutorService that could be used for executing a potentially long-running task.
protected io.netty.channel.Channel	channel() Returns the Channel that is handling this request, or null if the connection is not established yet.
io.netty.channel.EventLoop	eventLoop() Returns the EventLoop that is handling the current Request.
RequestLog	log() Returns the RequestLog that contains the information about the current Request.
RequestLogBuilder	logBuilder() Returns the RequestLogBuilder that collects the information about the current Request.
org.slf4j.Logger	logger()
java.lang.String	mappedPath() Returns the path with its context path removed.
long	maxRequestLength() Returns the maximum length of the current Request.
PathMapping	pathMapping() Returns 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<?,?>> 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(java.time.Duration requestTimeout) Sets the amount of time allowed until receiving the current Request completely.
void	setRequestTimeoutChangeListener(RequestTimeoutChangeListener listener) Sets the listener that is notified when the requestTimeoutMillis() request timeout} of the request is changed.
void	setRequestTimeoutMillis(long requestTimeoutMillis) Sets the amount of time allowed until receiving the current Request completely.
javax.net.ssl.SSLSession	sslSession() The SSLSession for this request if the connection is made over TLS, or null if the connection is not established yet or the connection is not a TLS connection.
java.lang.String	toString()
VirtualHost	virtualHost() Returns the VirtualHost that is handling the current Request.

Methods inherited from class com.linecorp.armeria.common.NonWrappingRequestContext

attr, attrs, hasAttr, invokeOnEnterCallbacks, invokeOnExitCallbacks, localAddress, method, onEnter, onExit, path, remoteAddress, request, sessionProtocol

Methods inherited from class com.linecorp.armeria.common.AbstractRequestContext

contextAwareEventLoop, equals, hashCode, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, rejectPromise, resolvePromise

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

attrs, contextAwareEventLoop, current, invokeOnEnterCallbacks, invokeOnExitCallbacks, localAddress, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, makeContextAware, mapCurrent, method, onEnter, onExit, path, push, push, rejectPromise, remoteAddress, request, resolvePromise, sessionProtocol

Methods inherited from interface io.netty.util.AttributeMap

attr, hasAttr

Constructor Detail

DefaultServiceRequestContext

public DefaultServiceRequestContext(ServiceConfig cfg,
                                    io.netty.channel.Channel ch,
                                    SessionProtocol sessionProtocol,
                                    java.lang.String method,
                                    java.lang.String path,
                                    java.lang.String mappedPath,
                                    java.lang.Object request,
                                    @Nullable
                                    javax.net.ssl.SSLSession sslSession)

Creates a new instance.

Parameters:

ch - the Channel that handles the invocation

sessionProtocol - the SessionProtocol of the invocation

request - the request associated with this context

sslSession - the SSLSession for this invocation if it is over TLS

Method Detail

channel

protected io.netty.channel.Channel channel()

Description copied from class: NonWrappingRequestContext

Returns the Channel that is handling this request, or null if the connection is not established yet.

Specified by:

channel in class NonWrappingRequestContext

server

public Server server()

Description copied from interface: ServiceRequestContext

Returns the Server that is handling the current Request.

Specified by:

server in interface ServiceRequestContext

virtualHost

public VirtualHost virtualHost()

Description copied from interface: ServiceRequestContext

Returns the VirtualHost that is handling the current Request.

Specified by:

virtualHost in interface ServiceRequestContext

pathMapping

public PathMapping pathMapping()

Description copied from interface: ServiceRequestContext

Returns the PathMapping associated with the Service that is handling the current Request.

Specified by:

pathMapping in interface ServiceRequestContext

service

public <T extends Service<?,?>> T service()

Description copied from interface: ServiceRequestContext

Returns the Service that is handling the current Request.

Specified by:

service in interface ServiceRequestContext

blockingTaskExecutor

public java.util.concurrent.ExecutorService blockingTaskExecutor()

Description copied from interface: ServiceRequestContext

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.

Specified by:

blockingTaskExecutor in interface ServiceRequestContext

eventLoop

public io.netty.channel.EventLoop eventLoop()

Description copied from interface: RequestContext

Returns the EventLoop that is handling the current Request.

Specified by:

eventLoop in interface RequestContext

mappedPath

public java.lang.String mappedPath()

Description copied from interface: ServiceRequestContext

Returns the path with its context path removed. This method can be useful for a reusable service bound at various path prefixes. For client side invocations, this method always returns the same value as RequestContext.path().

Specified by:

mappedPath in interface ServiceRequestContext

logger

public org.slf4j.Logger logger()

Specified by:

logger in interface ServiceRequestContext

sslSession

@Nullable
public javax.net.ssl.SSLSession sslSession()

Description copied from interface: RequestContext

The SSLSession for this request if the connection is made over TLS, or null if the connection is not established yet or the connection is not a TLS connection.

Specified by:

sslSession in interface RequestContext

Overrides:

sslSession in class NonWrappingRequestContext

requestTimeoutMillis

public long requestTimeoutMillis()

Description copied from interface: ServiceRequestContext

Returns the amount of time allowed until receiving the current Request completely. This value is initially set from ServerConfig.defaultRequestTimeoutMillis().

Specified by:

requestTimeoutMillis in interface ServiceRequestContext

setRequestTimeoutMillis

public void setRequestTimeoutMillis(long requestTimeoutMillis)

Description copied from interface: ServiceRequestContext

Sets the amount of time allowed until receiving the current Request completely. This value is initially set from ServerConfig.defaultRequestTimeoutMillis().

Specified by:

setRequestTimeoutMillis in interface ServiceRequestContext

setRequestTimeout

public void setRequestTimeout(java.time.Duration requestTimeout)

Description copied from interface: ServiceRequestContext

Sets the amount of time allowed until receiving the current Request completely. This value is initially set from ServerConfig.defaultRequestTimeoutMillis().

Specified by:

setRequestTimeout in interface ServiceRequestContext

maxRequestLength

public long maxRequestLength()

Description copied from interface: ServiceRequestContext

Returns the maximum length of the current Request. This value is initially set from ServerConfig.defaultMaxRequestLength().

Specified by:

maxRequestLength in interface ServiceRequestContext

See Also:

ContentTooLargeException

setMaxRequestLength

public void setMaxRequestLength(long maxRequestLength)

Description copied from interface: ServiceRequestContext

Sets the maximum length of the current Request. This value is initially set from ServerConfig.defaultMaxRequestLength().

Specified by:

setMaxRequestLength in interface ServiceRequestContext

See Also:

ContentTooLargeException

log

public RequestLog log()

Description copied from interface: RequestContext

Returns the RequestLog that contains the information about the current Request.

Specified by:

log in interface RequestContext

logBuilder

public RequestLogBuilder logBuilder()

Description copied from interface: RequestContext

Returns the RequestLogBuilder that collects the information about the current Request.

Specified by:

logBuilder in interface RequestContext

setRequestTimeoutChangeListener

public void setRequestTimeoutChangeListener(RequestTimeoutChangeListener listener)

Sets the listener that is notified when the requestTimeoutMillis() request timeout} of the request is changed.

Note: This method is meant for internal use by server-side protocol implementation to reschedule a timeout task when a user updates the request timeout configuration.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object