com.linecorp.armeria.server

Interface Service<I extends Request,O extends Response>

Type Parameters:

I - the type of incoming Request

O - the type of outgoing Response

All Known Subinterfaces:

HttpService

All Known Implementing Classes:

AbstractCompositeService, AbstractHttpService, CorsService, DecoratingService, DocService, DropwizardMetricCollectingService, DynamicHttpService, HttpAuthService, HttpEncodingService, HttpFileService, HttpHealthCheckService, LoggingService, SampledLoggingService, SimpleCompositeService, StructuredLoggingService

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>

Handles a Request received by a Server.

Method Summary

Modifier and Type	Method and Description
default <T> java.util.Optional<T>	as(java.lang.Class<T> serviceType) Undecorates this Service to find the Service which is an instance of the specified serviceType.
default <R extends Service<?,?>> R	decorate(java.lang.Class<R> serviceType) Creates a new Service that decorates this Service with a new Service instance of the specified serviceType.
default Service<I,O>	decorate(DecoratingServiceFunction<? super I,? extends O> function) Creates a new Service that decorates this Service with the specified DecoratingServiceFunction.
default <T extends Service<? super I,? extends O>,R extends Service<R_I,R_O>,R_I extends Request,R_O extends Response> R	decorate(java.util.function.Function<T,R> decorator) Creates a new Service that decorates this Service with the specified decorator.
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.

Method Detail

serviceAdded

default void serviceAdded(ServiceConfig cfg)
                   throws java.lang.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 ths Service has been added more than once.

Throws:

java.lang.Exception

serve

O serve(ServiceRequestContext ctx,
        I req)
 throws java.lang.Exception

Serves an incoming Request.

Parameters:

ctx - the context of the received Request

req - the received Request

Returns:

the Response

Throws:

java.lang.Exception

as

default <T> java.util.Optional<T> as(java.lang.Class<T> serviceType)

Undecorates this Service to find the Service which is an instance of the specified serviceType. Use this method instead of an explicit downcast since most Services are decorated via decorate(Function) and thus cannot be downcast. For example:

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

Parameters:

serviceType - the type of the desired Service

Returns:

the Service which is an instance of serviceType if this Service decorated such a Service. Optional.empty() otherwise.

decorate

default <R extends Service<?,?>> R decorate(java.lang.Class<R> serviceType)

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.

decorate

default <T extends Service<? super I,? extends O>,R extends Service<R_I,R_O>,R_I extends Request,R_O extends Response> R decorate(java.util.function.Function<T,R> decorator)

Creates a new Service that decorates this Service with the specified decorator.

decorate

default Service<I,O> decorate(DecoratingServiceFunction<? super I,? extends O> function)

Creates a new Service that decorates this Service with the specified DecoratingServiceFunction.