Giraffe：在Web开发中使用F#和ASP.NET Core

语言开发 Microsoft

摘要： Giraffe是一种用于构建Web应用的微型F# Web框架。它基于ASP.NET Core，为Web框架提供了F# API。Giraffe支持开发人员在使用F#构建Web应用的同时，还可以访问ASP.NET Core及其生态系统所提供的特性。

作者： Pierre-Luc Maheu

正文：

Giraffe是一种用于构建Web应用的微型F# Web框架。它基于ASP.NET Core，为Web框架提供了F# API。Giraffe支持开发人员在使用F#构建Web应用的同时，还可以访问ASP.NET Core及其生态系统所提供的特性。

Giraffe的语法类似于另一种广为使用的Web框架Suave。两者间相似性为我们提出了一个问题：两种框架是否应该合二为一，或是应该遵循同一套API。Giraffe的创立者阐述了他认为合并不能产生增值的理由：

正如人们经常提及的，Giraffe的根本出发点在于提供与ASP.NET Core的紧密集成，这是Giraffw和Suave间的一个主要差异所在。我们注意到，在使用功能性.NET开发构建功能性ASP.NET Core Web应用上存在着利基空间。Giraffe的推出正是力图填补这一空缺。它在ASP.NET Core之上构建了一个轻量级功能层，同时依然保持DI、HttpRequest、HttpResponse、Config等ASP.NET Core构建块可用。这使得F#开发人员可以使用已有的（或是即将推出的）许多ASP.NET Core生态系统。

Giraffe的主要构件是HttpHandler。HttpHandler提供了一种函数流水线，它类似于通过IApplicationBuilder组合使用ASP.NET Core。一个Handler可以通过调用随后的Handler，继续流水线的处理。例如：

type HttpHandler = HttpFunc -> HttpContext -> HttpFuncResult

Giraffe使用了组合（Combinator）方法。开发人员可以通过将HttpHandlers组合在一起创建更高层级的抽象，最终创建一个应用。例如：

let webApp =
choose [
route “/foo” >=> text “Foo”
route “/bar” >=> text “Bar”
]
type Startup() =
member __.Configure (app : IApplicationBuilder)
                    (env : IHostingEnvironment)
                    (loggerFactory : ILoggerFactory) =
    app.UseGiraffe webApp

Giraffe中使用的是.NET的Task对象，而非异步（async）工作流。这两种实现是不同的，需要做相互转化。Giraffe通过最小化这种转化，降低了开销。

let personHandler =
    fun (next : HttpFunc) (ctx : HttpContext) ->
        task {
            let! person = ctx.BindModel<Person>()
            return! json person next ctx
        }

例子应用提供在GitHub上。

查看英文原文： ASP.NET Core and F# with Giraffe