• 前言
• 开始
  • 模块运行
  • 动态 C# API 客户端
• 最后

很久没更新这个系列。。。之前的章节中讲到ABP的模块是可以独立运行的，但是没有介绍具体怎么操作，本篇就来讨论一下模块如何独立运行，以及一些托管方式。本人也是处于摸索阶段，如有不对欢迎指出。

模块运行

首先需要生成模块的数据库，修改HttpApi.Host和IdentityServer项目的appsettings.json数据库连接字符串配置。

\modules\file-management\host\Xhznl.FileManagement.HttpApi.Host\appsettings.json：

\modules\file-management\host\Xhznl.FileManagement.IdentityServer\appsettings.json：

这样会生成2个数据库，如果你只需要一个数据库的话，就把FileManagement的那行配置去掉就好了。

打开程序包管理器控制台，默认项目选择IdentityServer，执行update-database

执行完成会生成Main数据库，其中是一些ABP的基础表。

继续将默认项目设置为HttpApi.Host执行add-migration Initial update-database

执行完成会生成Module数据库，其中是你模块的相关表。

此时这两个项目就可以正常运行了。

项目中可能有多个模块相互协作，如果将各个模块独立运行的话，不可能每个模块都创建一个Main数据库，所以部分ABP的通用模块的数据库表就用同一个就好了。

\modules\file-management\host\Xhznl.FileManagement.HttpApi.Host\appsettings.json：

\modules\file-management\host\Xhznl.FileManagement.IdentityServer\appsettings.json：

动态 C# API 客户端

当有多个独立部署的模块时，可能需要做一些网关之类的来统一入口，模块之间的相互调用也比较麻烦，本篇暂不讨论。下面介绍一下如何使用ABP的动态C# API客户端来调用远程模块。

ABP可以自动创建C# API 客户端代理来调用远程HTTP服务(REST APIS).通过这种方式,你不需要通过 HttpClient 或者其他低级的HTTP功能调用远程服务并获取数据.

前面的章节中，在主项目中将模块的Application层和Domain层的大部分项目都引用了一遍，那种方式是单体部署的情况，模块和主项目托管在同一个进程里。

下面使用C# API客户端来代理远程模块。

首先删除项目中模块的引用和DependsOn

然后在你需要调用模块的项目中，添加模块的HttpApi.Client项目的依赖即可。比如我这里的Xhznl.HelloAbp.HttpApi.Host项目：

然后DependsOn：

然后在appsettings.json中添加远程服务的地址配置：

其中的FileManagement这个名称是来自模块的HttpApi.Client项目中的定义：

接下来就可以像使用本地方法一样去使用远程服务了，因为HttpApi.Client是依赖于Application.Contracts项目的，所以你模块的所有服务接口都可以在这里使用，直接注入即可（前提是你的服务需要实现IRemoteService），ABP会自动帮你完成Http的远程调用。随便找个地方测试一下：

接下来是模块项目，最好配合ABP的自动API控制器一起使用，如果你是自定义路由的话，可能会出现一些Could not found remote action的奇怪错误。

Auth服务地址也注意一下：

下面给两个项目打上断点，测试一下流程是否正确：

可以看到，请求已经正常流转到模块项目中。

上面有些乱，总结一下重点：

1. 添加HttpApi.Client引用
2. 添加RemoteServices地址配置
3. 注入服务接口进行使用

如果想托管模块的所有API，那么只需要再添加模块的HttpApi依赖即可。托管方式非常灵活，具体可以参考：模块化架构最佳实践 & 约定

本篇就到这里。。。。。。