Server basics
To start a server, you need to build it first. Use ServerBuilder:
Decorating a service
A 'decorating service' (or a 'decorator') is a service that wraps another service
Running a gRPC service
Visit armeria-examples to find a fully working example.
Running a Thrift service
Visit armeria-examples to find a fully working example.
Running a GraphQL service
Visit armeria-examples to find a fully working example.
Browsing and invoking services with DocService
DocService is a single-page web application which provides the following useful features:
Annotated services
Visit armeria-examples to find a fully working example.
Serving static files
Visit armeria-examples to find a fully working example.
Embedding a servlet container
You can make Armeria serve your JEE web application on the same JVM and TCP/IP port by embedding
Writing an access log
Configuring logging framework
Configuring CORS
Armeria provides a way to configure Cross-origin resource sharing (CORS) policy for specific origins or
Serving Server-Sent Events
Visit armeria-examples to find a fully working example.
Service registration for discovery
You can use ServerListener to register the information of Armeria servers when they start so that
Handling a multipart request
Armeria provides Multipart encoder and decoder built on top of
Configuring server timeouts
There are several ways to override the default timeouts at server-side.
Graceful shutdown
When a server shuts down, in-flight requests may be interrupted abruptly. Armeria provides