2015-02-07 52 views
10

我目前正在检查Visual Studio 2015 Preview中的asp.net vnext MVC6。我对asp.net一般都很陌生,但在我的公司内部,我们将使用asp.net来访问我们服务器上的数据(目前我们只支持与我们自己的silverlight应用程序的wcf通信)来创建web api。这就是我正在检查MVC 6的新功能以判断在开始开发之前是否应该等待,以及在最终发布时使用MVC 6还是现在开始开发并创建Web API 2项目的原因。HelpPage for ASP.NET vNext MVC 6 Web Api

无论如何,我正在研究通过使用Microsoft.AspNet.WebApi.HelpPage将Web api集成到Visual Studio模板中的Web api 2项目。

现在对于我的问题,是这样的可用于MVC 6吗?我可以在我的ASP.NET vNext/MVC6(不管你想调用它)项目中导入相同的包在我的project.json中,但我不能在我的Startup.cs文件中执行app.UseHelpPage();

我怀疑这还没有(还)在当前版本中集成呢。如果没有,一旦ASP.NET vNext最终碰到货架,有没有关于此功能集成的知识?

回答

4

也许这个功能在MVC 6中不可用,但你可以试试Swagger。 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/

+0

感谢您的提示,我会牢记这一点!但现在看来,它也不适用于MVC 6.我认为必须这样做,因为MVC 6项目是一个.kproj而不是.csproj,安装时,用于Swashbuckle的nuget包会出现错误。 – Maarten 2015-02-07 18:14:43

+0

有一种方法可以在ASP.NET v6中使用它:http://devmeetsbi.ghost.io/help-and-test-page-for-asp-net-web-api-asp-net-5-and -mvc-6/ – 2015-06-19 09:28:34

+0

如果你的API不够稳定,那么这个效果不好。我不会说这是一个有效的答案,因为它只能部分帮助你。当你使用自定义命令或模型/动作绑定,或者如果你不是创建一个REST,而是创建一个更基于RPC的API时,这将不起作用,因为Swagger非常有见地。 – 2016-09-19 16:04:59