Open棟梁Project - マイクロソフト系技術情報 Wiki
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, :ASP.NET, :ASP.NET Web API