abp(net core)+easyui+efcore实现仓储管理系统——ABP WebAPI与EasyUI结合增删改查之七(三十三)

abp(net core)+easyui+efcore实现仓储管理系统目录

abp(net core)+easyui+efcore实现仓储管理系统——ABP整体介绍(一）

abp(net core)+easyui+efcore实现仓储管理系统——解决方案介绍(二)

abp(net core)+easyui+efcore实现仓储管理系统——领域层建立实体(三)

 abp(net core)+easyui+efcore实现仓储管理系统——定义仓储并实现 (四)

abp(net core)+easyui+efcore实现仓储管理系统——建立应用服务（五）

abp(net core)+easyui+efcore实现仓储管理系统——展示层实现增删改查之控制器（六）

abp(net core)+easyui+efcore实现仓储管理系统——展示层实现增删改查之列表视图（七）

abp(net core)+easyui+efcore实现仓储管理系统——展示层实现增删改查之增删改视图（八）

abp(net core)+easyui+efcore实现仓储管理系统——展示层实现增删改查之菜单与测试（九）

abp(net core)+easyui+efcore实现仓储管理系统——多语言（十）

abp(net core)+easyui+efcore实现仓储管理系统——使用 WEBAPI实现CURD (十一)

abp(net core)+easyui+efcore实现仓储管理系统——菜单-上 (十六)

abp(net core)+easyui+efcore实现仓储管理系统——EasyUI前端页面框架 (十八)

abp(net core)+easyui+efcore实现仓储管理系统——EasyUI之货物管理一 (十九)

abp(net core)+easyui+efcore实现仓储管理系统——EasyUI之货物管理六(二十四)

abp(net core)+easyui+efcore实现仓储管理系统——EasyUI之货物管理七(二十五)

abp(net core)+easyui+efcore实现仓储管理系统——EasyUI之货物管理八(二十六)

 abp(net core)+easyui+efcore实现仓储管理系统——ABP WebAPI与EasyUI结合增删改查之一(二十七)

abp(net core)+easyui+efcore实现仓储管理系统——ABP WebAPI与EasyUI结合增删改查之二(二十八)

abp(net core)+easyui+efcore实现仓储管理系统——ABP WebAPI与EasyUI结合增删改查之三(二十九)

abp(net core)+easyui+efcore实现仓储管理系统——ABP WebAPI与EasyUI结合增删改查之四(三十)

abp(net core)+easyui+efcore实现仓储管理系统——ABP WebAPI与EasyUI结合增删改查之五(三十一)

abp(net core)+easyui+efcore实现仓储管理系统——ABP WebAPI与EasyUI结合增删改查之六(三十二)

 

 

     在上面几篇文章的学习以后，组织管理的新增功能的前端与后台功能基本实现了咱们所要。今天开始咱们要经过WebAPI来替换控制器中的操做方法。在学习WebAPI以前，我先来介绍一下Swagger这个组件。

 

十3、Swagger管理WEBAPI

        Swagger兼具了API文档管理和测试的功能,并且保证了代码和文档的一致性。它提供了无需任何实现逻辑的RESTfulAPI的UI表示。它容许用户在没有任何代码访问的状况下了解服务的功能，并减小建立服务文档的时间。

   Swagger使用swagger工具基于咱们编写的服务代码生成的swagger.json文件来生成文档管理界面。此文件描述服务的功能，即服务支持多少方法，并提供有关方法参数的信息。使用这个文件，SwaggerUI生成客户机代码。下面咱们经过调用新增组织信息的WEBAPI接口不成功为示例来学习一下ABP中的Swagger使用。

      1.在“添加组织信息”界面中输入相应的组织信息以后，点击“保存”按钮 。在弹出的确认对话框中点击“肯定”按钮。在弹出的“保存成功”确认对话框中点击“肯定”按钮。

 

      2.若是保存界面一直是正在保存界面。见下图。首先咱们去启动“ABP.TPLMS.Web.Host”项目，经过Swagger来看看咱们的WebAPI是否可用。

 

      3.咱们把“ABP.TPLMS.WEB.Host”项目设为启动项目，而后在Visual Studio 2017中按F5启动swagger应用程序。生成并浏览WEBAPI，可是swagger并无生成WEBAPI，只是给了一个错误信息。以下图。

 

      4. 在Visual Studio 2017的“解决方案资源管理器”中，找到领域层“ABP.TPLMS.Web.Host”项目中的App_Data\Logs目录下找到Logs.txt。在日志文件中看到ABP写入的错误信息。错误信息以下：

System.NotSupportedException: HTTP method "DELETE" & path "api/services/app/Cargo/Delete" overloaded by actions - ABP.TPLMS.Cargos.CargoAppService.Delete (ABP.TPLMS.Application),ABP.TPLMS.Cargos.CargoAppService.Delete (ABP.TPLMS.Application).

    5.根据上面的错误信息，咱们发现因为以前咱们在写货物信息页面时的一个重载方法形成的。

     6. 在Visual Studio 2017的“解决方案资源管理器”中，找到“ABP.TPLMS.Application”项目中的“Cargos”目录，找到ICargoAppService.cs文件，把“Delete”方法改成“DeleteBatch”方法。以下图。

      7. 在Visual Studio 2017的“解决方案资源管理器”中，找到“ABP.TPLMS.Application”项目中的“Cargos”目录，找到CargoAppService.cs文件，把“Delete”方法改成“DeleteBatch”方法。以下图。

 

     8. 在Visual Studio 2017的“解决方案资源管理器”中，找到“ABP.TPLMS.Web.Mvc”项目中的“Controller”目录，找到CargoController.cs文件，把“Delete”方法中原来调用“Delete”方法，改成调用“DeleteBatch”方法。以下图。

 

      9. 在Visual Studio 2017的解决方案资源管理器中，把“ABP.TPLMS.Web.Host”项目设为启动项目，而后按F5运行。结果以下图。正如图中所示，它对每一个HTTP动词使用不一样的颜色代码。

 

 

   10. 当咱们单击任何操做方法时，Swagger会显示这个方法所须要的参数和测试按钮。以下图。

     11. 当咱们单击“Try It out”按钮时，它将询问参数详细信息。咱们在参数中填写参数值，而后点击“Execute”按钮，它将向Web API发送请求。以下图。

 

    12. Org的WebAPI方法Get，返回结果，以下图。测试正常。