Users MUST provide an implementation to configure the provided JavaThriftRouter. The JavaThriftRouter exposes a DSL which results in a configured Finagle Service[-Req, +Rep] to serve on the ListeningServer.

ONLY INTENDED FOR USE BY THE FRAMEWORK.

Default modules can be overridden in production by overriding methods in your App or Server.

We take special care to make sure the module is not null, since a common bug is overriding the default methods using a val instead of a def

ONLY INTENDED FOR USE BY THE FRAMEWORK.

ONLY INTENDED FOR USE BY THE FRAMEWORK.

After postWarmup, all external servers have been started, and we can now enable our health endpoint.

Callback to register multiple Awaitable instances for the server to await (block) on.

Callback to register an Awaitable instance for the server to await (block) on.

All registered Awaitable instances are entangled by the server such that if any registered Awaitable exits it will trigger all registered Awaitable instances to exit.

After warmup but before accepting traffic promote to old gen (which triggers gc).

The address to which the underlying ListeningServer is bound

Override to provide further configuration to the Service[Array[Byte], Array[Byte]] served. For example, to add "global" filters over the resultant Service[Array[Byte], Array[Byte]].

E.g.

override protected def configureService(
  service: Service[Array[Byte], Array[Byte]]
): Service[Array[Byte], Array[Byte]] = {
   injector.instance[MyGreatServiceFilter].andThen(service)
}

Users are expected to use JavaThriftRouter)

This method allows for further configuration of the thrift server for parameters not exposed by this trait or for overriding defaults provided herein, e.g.,

override def configureThriftServer(server: ThriftMux.Server): ThriftMux.Server = { server .withMaxReusableBufferSize(...) }

A Java-friendly method for creating a named Flag.

A Java-friendly way to create a "mandatory" Flag. "Mandatory" flags MUST have a value provided as an application argument (as they have no default value to be used).

Default server announcement String used as the Flag default value for thriftAnnounceFlag. This can be overridden to provide a different default programmatically when a flag value cannot be passed. An empty String value is an indication to not perform any announcement of the server.

In general, users should prefer setting the thriftAnnounceFlag Flag value.

Default external Thrift port used as the Flag default value for thriftPortFlag. This can be overridden to provide a different default programmatically when a flag value cannot be passed. The format of this value is expected to be a String in the form of ":port".

In general, users should prefer setting the thriftPortFlag Flag value.

Default server name for the external Thrift interface used as the Flag default value for thriftServerNameFlag. This can be overridden to provide a different default programmatically when a flag value cannot be passed.

In general, users should prefer setting the thriftServerNameFlag Flag value.

Default shutdown timeout used as the Flag default value for thriftShutdownTimeoutFlag. This represents the deadline for the closing of this server which can be overridden to provide a different default programmatically when a flag value cannot be passed.

In general, users should prefer setting the thriftShutdownTimeoutFlag Flag value.

<invalid inheritdoc annotation>

Utility to run a com.twitter.inject.utils.Handler. This is generally used for running a warmup handler in TwitterServer.warmup.

Utility to run a com.twitter.inject.utils.Handler. This is generally used for running a warmup handler in TwitterServer.warmup.

Returns the bound port representing the external HTTP interface of this server.

Returns the bound port representing the external HTTPS interface of this server.

Production modules from Java.

ONLY INTENDED FOR USE IN TESTING.

Override modules from Java which redefine production bindings (only use overrideModules during testing) If you think you need this in your main server you are most likely doing something incorrectly.

Name used for registration in the com.twitter.util.registry.Library

ONLY INTENDED FOR USE BY THE FRAMEWORK.

DO NOT BLOCK

Production modules.

Called prior to application exiting.

Called prior to application exiting after onExit.

Called prior to application initialization.

ONLY INTENDED FOR USE IN TESTING.

Override modules which redefine production bindings (only use overrideModules during testing) If you think you need this in your main server you are most likely doing something incorrectly.

After creation of the Injector. Before any other lifecycle methods.

Called after the main method.

If you override this method to create and bind any external interface or to instantiate any awaitable it is expected that you add the Awaitable (or com.twitter.finagle.ListeningServer) to the list of Awaitables using the await[T <: Awaitable[_(awaitable: T): Unit function.

Called before the main method.

Resolve all Finagle clients before warmup method called

Callback method which is executed specifically in the postInjectorStartup lifecycle phase of this server.

This is AFTER the injector is created but BEFORE server warmup has been performed.

This method is thus suitable for starting and awaiting on PubSub publishers or subscribers.

The server is NOT signaled to be started until AFTER this method has executed thus it is imperative that this method is NOT BLOCKED as it will cause the server to not complete startup.

This method can be used to start long-lived processes that run in separate threads from the main() thread. It is expected that you manage these threads manually, e.g., by using a com.twitter.util.FuturePool.

If you override this method to instantiate any com.twitter.util.Awaitable it is expected that you add the com.twitter.util.Awaitable to the list of Awaitables using the await[T <: Awaitable[_]](awaitable: T): Unit function if you want the server to exit when the com.twitter.util.Awaitable exits.

Any exceptions thrown in this method will result in the server exiting.

Callback method which is executed after the injector is created and all lifecycle methods have fully completed but before awaiting on any Awaitables. It is NOT expected that you block in this method as you will prevent completion of the server lifecycle.

The server is signaled as STARTED prior to the execution of this callback as all lifecycle methods have successfully completed and the admin and any external interfaces have started.

This method can be used to start long-lived processes that run in separate threads from the main() thread. It is expected that you manage these threads manually, e.g., by using a com.twitter.util.FuturePool.

Any exceptions thrown in this method will result in the server exiting.

Default com.twitter.inject.TwitterModule for providing a com.twitter.finagle.stats.StatsReceiver.

Returns the bound port representing the external Thrift interface of this server.

Default com.twitter.inject.TwitterModule for providing a ThriftResponseClassifier.

Configuration of the Service[Array[Byte], Array[Byte]] to serve on the ListeningServer is defined by configuring the ThriftRouter and not by implementation of this method, thus this method overridden to be final and set to a NilService.

Callback method run before TwitterServer.postWarmup, used for performing warm up of this server. Override, but do not call super.warmup() as you will trigger a lint rule violation.

Any exceptions thrown in this method will result in the app exiting.