finatra, 在 Twitter 服务器和Finagle上，构建了快速，可以测试的Scala 服务

状态

项目已经在 Twitter ( 还有很多其他组织)的生产中使用，正在积极开发和维护。

Finatra是一个轻量级框架，用于构建快速。测试。Scala 应用程序，位于 TwitterServer 和 Finagle之上。 Finatra为创建和测试和 Finagle服务器以及功能强大的JSON支持提供了一个 easy-to-use API，以及通过SLF4J，Finagle客户端的实用工具，以及更多的功能。

涉及到

• 网站：https://twitter.github.io/finatra/
• 最新的news: 博客。
• Github源：https://github.com/twitter/finatra/
• Gitter: https://gitter.im/twitter/finatra
• 邮件列表：finatra-users@googlegroups.com

特性

• 生产使用 @Twitter。
• 在几个基准中 ~50的速度超过 v1.6.
• 强大的功能和集成测试支持。
• 可选的JSR-330 依赖注入使用 Google Guice。
• 支持必需字段。缺省值和验证的 Jackson -based JSON解析。
• com.twitter.util.Local 集成的LogbackMDC与的集成。

文档

首先，我们要启动我们的用户指南( )的一部分，以便启动并运行。 或者查看构建 HTTP插件或者服务器的特定部分。

示例

HTTP控制器和服务器：

import com.twitter.finatra.http._



@Singleton


class ExampleController extends Controller {


 get("/") { request: Request =>


 "<h1>Hello, world!</h1>"


 }


}

import com.twitter.finatra.http._



class ExampleServer extends HttpServer {


 override def configureHttp(router: HttpRouter): Unit = {


 router


. filter[CommonFilters]


. add[ExampleController]


 }


}

Thrift 控制器和服务器：

import com.twitter.finatra.thrift._



@Singleton


class ExampleThriftController 


 extends Controller


 with MyThriftService.BaseServiceIface {



 override val myFunction = handle(MyFunction) { args: MyFunction.Args =>


. . .


 }


}

import com.twitter.finatra.thrift._



class ExampleServer extends ThriftServer {


 override def configureThrift(router: ThriftRouter): Unit = {


 router


. add[ExampleThriftController]


 }


}

示例项目

Finatra包含的工作示例突出了框架的各种特性并包括测试。 这些示例包括在 root sbt的构建中，因此作为整个项目的一部分构建。

有关特性。测试。构建和运行的更多详细信息，请查看示例。

最新版本

Github主分支插件跟踪最新的稳定发行版，目前是：

可以在 Maven 中找到。有关如何添加依赖项的信息，请参见用户指南中的步骤。

在大约每月的时间内完成发布。 在不遵循时，将详细说明changelogs插件，并包括 public API中断和运行时行为更改的部分。

插件开发版本

开发分支插件，跟踪每周更新的最新代码。 如果你希望提供补丁或者修复，请使用这里分支作为你的请求请求的基础。

有关提供贡献的详细信息，请参阅我们的 CONTRIBUTING.md 文档。

演示文稿

查看我们的演示文稿列表： Finatra演示文稿。

作者

• Steve Cosenza https://github.com/scosenza
• https://github.com/cacoco。

在GitHub上可以找到完整的插件列表。

在 Twitter 上跟随 @finatra 更新。

许可证

版权所有 2013 -2018 Twitter 公司。

在Apache许可下许可，版本 2.0: https://www.apache.org/licenses/LICENSE-2.0