Embedding a Netty server in your application

While Play apps are most commonly used as their own container, you can also embed a Play server into your own existing application. This can be used in conjunction with the Twirl template compiler and Play routes compiler, but these are of course not necessary. A common use case is an application with only a few simple routes. To use Netty Server embedded, you will need the following dependency:

@netty-sbt-dependencies

One way to start a Play Netty Server is to use the NettyServer factory methods. If all you need to do is provide some straightforward routes, you may decide to use the [[String Interpolating Routing DSL|ScalaSirdRouter]] in combination with the fromRouterWithComponents method:

@simple

By default, this will start a server on port 9000 in prod mode. You can configure the server by passing in a ServerConfig:

@config

Play also provides components traits that make it easy to customize other components besides the router. The NettyServerComponents trait is provided for this purpose, and can be conveniently combined with BuiltInComponents to build the application that it requires. In this example we use DefaultNettyServerComponents, which is equivalent to NettyServerComponents with BuiltInComponents with NoHttpFiltersComponents:

@components

Here the only method you need to implement is router. Everything else has a default implementation that can be customized by overriding methods, such as in the case of httpErrorHandler above. The server configuration can be overridden by overriding the serverConfig property.

To stop the server once you've started it, simply call the stop method:

@stop

Note: Play requires an [[application secret|ApplicationSecret]] to be configured in order to start. This can be configured by providing an application.conf file in your application, or using the play.http.secret.key system property.

Logging configuration

When using Netty as an embedded server, no logging dependencies are included by default. If you want to also add logging to the embedded application, you can add the Play logback module:

@embed-logging-sbt-dependencies

And later call the LoggerConfigurator API:

@logger-configurator