com.linecorp.armeria.server

Interface Service<I extends Request,O extends Response>

Type Parameters:

I - the type of incoming Request. Must be HttpRequest or RpcRequest.

O - the type of outgoing Response. Must be HttpResponse or RpcResponse.

All Superinterfaces:

Unwrappable

All Known Subinterfaces:

HttpService, HttpServiceWithRoutes, RpcService, RpcServiceWithRoutes, ServiceWithRoutes<I,O>, TransientHttpService, TransientRpcService, TransientService<I,O>

All Known Implementing Classes:

AbstractCompositeService, AbstractHttpService, AbstractThrottlingService, AnnotatedService, AuthService, ContentPreviewingService, CorsService, DecoratingService, DocService, EncodingService, FileService, HealthCheckService, HttpAuthService, HttpFileService, HttpHealthCheckService, LoggingService, ManagedHttpHealthCheckService, MetricCollectingService, PrometheusExpositionService, RedirectService, SimpleCompositeRpcService, SimpleCompositeService, SimpleDecoratingHttpService, SimpleDecoratingRpcService, SimpleDecoratingService, ThrottlingRpcService, ThrottlingService

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface Service<I extends Request,O extends Response>
extends Unwrappable

Handles a Request received by a Server.

Method Summary

Modifier and Type	Method and Description
default <T> T	as(Class<T> type) Unwraps this Service into the object of the specified type.
default <R extends Service<?,?>> R	decorate(Class<R> serviceType) Deprecated. Use HttpService.decorate(Function), HttpService.decorate(DecoratingHttpServiceFunction), RpcService.decorate(Function) and RpcService.decorate(DecoratingRpcServiceFunction).
O	serve(ServiceRequestContext ctx, I req) Serves an incoming Request.
default void	serviceAdded(ServiceConfig cfg) Invoked when this service has been added to a Server with the specified configuration.
default boolean	shouldCachePath(String path, String query, Route route) Returns whether the given path and query should be cached if the service's result is successful.

Method Detail

serviceAdded

default void serviceAdded(ServiceConfig cfg)
                   throws Exception

Invoked when this service has been added to a Server with the specified configuration. Please note that this method can be invoked more than once if this service has been added more than once.

Throws:

Exception

serve

O serve(ServiceRequestContext ctx,
        I req)
 throws Exception

Serves an incoming Request.

Parameters:

ctx - the context of the received Request

req - the received Request

Returns:

the Response

Throws:

Exception

as

default <T> T as(Class<T> type)

Unwraps this Service into the object of the specified type. Use this method instead of an explicit downcast. For example:

 HttpService s = new MyService().decorate(LoggingService.newDecorator())
                                .decorate(AuthService.newDecorator());
 MyService s1 = s.as(MyService.class);
 LoggingService s2 = s.as(LoggingService.class);
 AuthService s3 = s.as(AuthService.class);
 

Specified by:

as in interface Unwrappable

Parameters:

type - the type of the object to return

Returns:

the object of the specified type if found, or null if not found.

See Also:

Unwrappable

decorate

@Deprecated
default <R extends Service<?,?>> R decorate(Class<R> serviceType)

Deprecated. Use HttpService.decorate(Function), HttpService.decorate(DecoratingHttpServiceFunction), RpcService.decorate(Function) and RpcService.decorate(DecoratingRpcServiceFunction).

Creates a new Service that decorates this Service with a new Service instance of the specified serviceType. The specified Class must have a single-parameter constructor which accepts this Service.

shouldCachePath

default boolean shouldCachePath(String path,
                                String query,
                                Route route)

Returns whether the given path and query should be cached if the service's result is successful. By default, exact path mappings with no input query are cached.