server

Type Members

1. abstract class AbstractTwitterServer extends TwitterServer

   

   A Java-friendly version of the TwitterServer.

   A Java-friendly version of the TwitterServer.

   In addition to TwitterServer, this abstract class defines its own Java-friendly lifecycle methods onInit, preMain, postMain and onExit that might be overridden in a concrete class.

   In order to launch the AbstractTwitterServer instance, the main method should be explicitly defined. It makes sense to define it within an inner class Main as shown below.

   public class JavaServer extends AbstractTwitterServer {
     public static class Main {
       public static void main(String[] args) {
         new JavaServer().main(args);
       }
     }
   }

   The Main class containing the main method may be launched via java JavaServer$Main.

2. trait Admin extends AnyRef

   

   Defines many of the default /admin/ HTTP routes.

3. trait AdminHttpServer extends AnyRef

   

4. class FlagAnnouncer extends Announcer

   

5. class FlagResolver extends Resolver

   

6. abstract class Hook extends AnyRef

   

   Defines a hook into an com.twitter.app.App.

7. trait Hooks extends AnyRef

   

   Mix-in to include service-loaded hooks.

8. trait Lifecycle extends AnyRef

   

9. trait Linters extends AnyRef

   

   Registers any global linter rules.

10. class NamedResolverNotFoundException extends Exception

    

    Indicates that a com.twitter.finagle.Resolver was not found for the given name using the FlagResolver.

    Indicates that a com.twitter.finagle.Resolver was not found for the given name using the FlagResolver.

    Resolvers are discovered via the com.twitter.server.resolverMap

11. trait NewHook extends (App) ⇒ Hook

    

    Create a new hook for the given App.

    Create a new hook for the given App. NewHooks are service-loaded.

    To use, extend the NewHook trait and implement an apply method which returns a Hook implementation, e.g.,

    Add the Hook as a service-loaded class in /META-INF/services/com.twitter.server.NewHook

    class MyHook extends NewHook {
      def apply(app: App) = new Hook {
    
        override def premain(): Unit = ???
    
        override def onExit(): Unit = ???
      }
    }

    See also

    com.twitter.finagle.util.LoadService

    com.twitter.server.Hook

12. trait Stats extends AnyRef

    

13. trait TwitterServer extends App with Slf4jBridge with Logging with Linters with DtabFlags with Hooks with AdminHttpServer with Admin with Lifecycle with Stats

    

    Twitter Server defines a template from which servers at Twitter are built.

    Twitter Server defines a template from which servers at Twitter are built. It provides common application components such as an administrative HTTP server, tracing, stats, etc. These features are wired in correctly for use in production at Twitter.

    For DI (Dependency Injection) Twitter Server uses self-typed Scala traits that might be mixed in the TwitterServer trait. The common practice is to define self-typed traits against the App trait as shown below.

    import com.twitter.app.App
    import com.twitter.server.TwitterServer
    
    trait MyModule { self: App =>
      // module logic
    }
    
    object MyApp extends TwitterServer with MyModule {
      // app logic
    }

    Note: the Slf4jBridge trait MUST be defined first to properly bridge legacy logging APIs.