我目前正在Visual Studio 2015 Preview中查看asp.net vnext MVC6.我一般都是asp.net的新手,但是在我公司内部,我们将开始使用asp.net创建一个web api来访问我们服务器上的数据(目前我们只支持与我们自己的Silverlight应用程序进行通信).这是我检查MVC 6的新功能的原因,以判断在开始开发之前是否应该等待,并在MVC 6最终发布或开始开发并创建Web API 2项目时使用MVC 6.
无论如何,我正在研究使用Microsoft.AspNet.WebApi.HelpPage自动记录web api,它已经被集成到WebApi 2项目的Visual Studio模板中.
现在我的问题,是这样的可用于MVC 6?我可以在我的ASP.NET vNext / MVC6(无论你想要调用它)项目中的project.json中导入相同的包,但是我无法执行app.UseHelpPage();在我的Startup.cs文件.
我怀疑这不是(还)集成在当前版本中.如果没有,ASP.NET vNext最终会碰到货架后,有没有关于此功能的集成的知识?
解决方法
可能这个功能在MVC 6中还不可用,但是您可以尝试Swagger.
Swagger基本上是用于描述,消费和可视化RESTful API的框架.
关于Swashbuckle,它并不依赖于ASP.NET MVC,所以没有必要包含任何MVC Nuget软件包以启用API文档,Swashbuckle还包含一个嵌入式版本的swagger-ui,它将自动提供一旦安装Swashbuckle.
Swagger基本上是用于描述,消费和可视化RESTful API的框架.
关于Swashbuckle,它并不依赖于ASP.NET MVC,所以没有必要包含任何MVC Nuget软件包以启用API文档,Swashbuckle还包含一个嵌入式版本的swagger-ui,它将自动提供一旦安装Swashbuckle.
资料来源:http://bitoftech.net/2014/08/25/asp-net-web-api-documentation-using-swagger/