Download
Finatra builds on TwitterServer and uses Finagle, therefore it is highly recommended that you familiarize yourself with those frameworks before getting started. The version of Finatra documented here is version 2.x. Version 2.x is a complete rewrite over v1.x and as such many things are different. Finatra at its core is agnostic to the type of service or application being created. It can be used to build anything based on TwitterUtil: c.t.app.App. For servers, Finatra builds on top of the features of TwitterServer (and Finagle) by allowing you to easily define a Server and controllers (a Service-like abstraction) which define and handle endpoints of the Server. You can also compose Filters either per controller, per route in a controller, or across all controllers. Powerful Feature and Integration test support. Optional JSR-330 Dependency Injection using Google Guice.
Features
- ~50 times faster than v1.6 in several benchmarks
- Powerful Feature and Integration test support
- Optional JSR-330 Dependency Injection using Google Guice
- Jackson-based JSON parsing supporting required fields, default values, and validations
- Logback MDC integration with com.twitter.util.Local for contextual logging across futures
- Finatra includes working examples which highlight various features of the framework and include tests
Project Samples
