「マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。
http://swagger.io/open-source-integrations/
Swagger Spec Files(Json)を参照し、クライアントとして機能する。
Json ファイルからクライアントコードを自動生成する。
Install-Package Swashbuckle.Core
// Swashbuckle の構成 config.EnableSwagger(c => { c.SingleApiVersion("v1.0", "WebApplication"); c.IncludeXmlComments(System.AppDomain.CurrentDomain.BaseDirectory + @"bin\WebApplication.XML"); }) .EnableSwaggerUi(c => { });
モデル・バインディングの仕様がカオスだから、自動生成だけでイケる気がしない。
XMLコメントの書き方などにルールなどはないのかなぁ?などと思った。
この辺か?
ざっと見たところ、[FromBody?] や [FromUri?] などの属性で、
絞ることで、Web APIの仕様も明確になるものと思われる。
https://www.nuget.org/packages/Microsoft.AspNet.WebApi.HelpPage
ASP.NET MVCへの依存が欠点とされる。
以下のドキュメント出力機能を持つ。
Tags: :プログラミング, :通信技術, :.NET開発, :.NET Core, :.NET Standard, :ASP.NET, :ASP.NET Web API