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 -\u0026gt; HttpContext -\u0026gt; HttpFuncResult
\\
Giraffe使用了组合(Combinator)方法。开发人员可以通过将HttpHandlers组合在一起创建更高层级的抽象,最终创建一个应用。例如:
\\\let webApp =\choose [\route “/foo” \u0026gt;=\u0026gt; text “Foo”\route “/bar” \u0026gt;=\u0026gt; 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) -\u0026gt;\ task {\ let! person = ctx.BindModel\u0026lt;Person\u0026gt;()\ return! json person next ctx\ }
\\
例子应用提供在GitHub上。
\\查看英文原文: ASP.NET Core and F# with Giraffe