ABP 개발 프레임 워크 시리즈 --- 전면 및 후면 끝을 개발하기 (4) 전 ABP 개발 시리즈 --- 개발 프레임 워크를 사용하여 캡슐화 웹 API 호출 카테고리와 터미널 후 (3)과 계층 파일 구성 프레임 워크

ABP는 프로젝트의 프레임 워크, 각 클래스 코드 필드 조직 층의 프로젝트의 이전 응용 프로그램 에세이 조직의 기술, 우리는 더 명확 구조를 투사 할 수 있도록, 각 층 ABP 프레임의 내용을 단순화합니다. 소개, 기초에 따라이 글은 앞에서 설명한, 수필은 사전에 응용 프로그램 서비스 계층 인터페이스 모듈의 달성에 설명되어 있고, 인터페이스가 여기에서 실행중인 프로그램의 웹 API를 통해 호스트 인터페이스를 테스트 할 수있는 웹 API 클래스를 호출 포장 및 사용, 콘솔의 사용을 포함하고 패키지의 WinForm 클래스를 호출하는 데 사용됩니다.

에세이 "에 프론트 엔드 개발 시리즈 개발 프레임 워크 ABP --- (3) 프레임과 계층 파일 조직 "나는도 같이 ABP 표시된 아키텍처, 프레임을 개선 꾸몄다.

이 프로젝트 내부 계층화 03-Application.Common 일반적인 응용 프로그램 서비스 계층, 우리는 주로 각 모듈 DTO 및 공공 서비스 인터페이스 클래스의 응용 프로그램 내에서 배치됩니다. 이러한 DTO 클래스와 인터페이스 파일, 우리는 클라이언트의이 부분의 내용의 준비를 반복 할 필요가 없습니다 (예 :의 WinForm 클라이언트, 콘솔, WPF / UWP, 등), 직접 사용할 수 있습니다.

DTO 클래스 파일 문서 및 인터페이스는, 우리의 주요 목적은 클라이언트가 클래스 웹 API 호출을 호출 캡슐화하는 것입니다, 그래서 우리는 인터페이스를 사용할 때보다 편리 호출.

1) 웹 API 클래스의 캡슐화를 호출

쉽게 웹 API 콘솔 클라이언트 기능의 WinForm 클라이언트와 다른 장면을 호출 할 수 있도록하기 위해, 우리는 웹 API 패키지의 응용 서비스 계층 인터페이스를 던져해야하고, DTO 클래스는 표준 인터페이스를 구현하여 다음 결합.

그래서 우리는 혼합 프레임 워크에서 축적 한 경험을 바탕으로 클래스가 여러 클라이언트간에 공유 할 수 이러한 호출은, 우리는 독립적으로 프로젝트를 관리 할 수 ​​넣어 때문에 다음과 같이 프로젝트를 볼 수 있습니다.

객체에 대응하는 필드는 DictDataApiCaller <예술> 명명 규칙의 ApiCaller된다.

如对于字典模块的API封装类，它们继承一个相同的基类，然后实现特殊的自定义接口即可，这样可以减少常规的Create、Get、GetAll、Update、Delete等操作的代码，这些全部由调用基类进行处理，而只需要实现自定义的接口调用即可。如下是字典模块DictType和DictData两个业务对象的API封装关系。

如对于字典类型的API封装类定义代码如下所示。

    /// <summary>
    /// 字典类型对象的Web API调用处理
    /// </summary>
    public class DictTypeApiCaller : AsyncCrudApiCaller<DictTypeDto, string, DictTypePagedDto, CreateDictTypeDto, DictTypeDto>, IDictTypeAppService
    {
        /// <summary>
        /// 提供单件对象使用
        /// </summary>
        public static DictTypeApiCaller Instance
        {
            get
            {
                return Singleton<DictTypeApiCaller>.Instance;
            }
        }

......

这里我们可以通过单件的方式来使用字典类型API的封装类实例 DictTypeApiCaller.Instance

对于Web API的调用，我们知道，一般需要使用WebClient或者HttpRequest的底层类进行Url的访问处理，通过提供相应的数据，获取对应的返回结果。

而对于操作方法的类型，是使用POST、GET、INPUT、DELETE的不同，需要看具体的接口，我们可以通过Swagger UI 呈现出来的进行处理即可，如下所示的动作类型。

如果处理动作不匹配，如本来是Post的用Get方法，或者是Delete的用Post方法，都会出错。

在Abp.Web.Api项目里面有一个AbpWebApiClient的封装方法，里面实现了POST方法，可以参考来做对应的WebClient的封装调用。

我在它的基础上扩展了实现方法，包括了Get、Put、Delete方法的调用。

我们使用的时候，初始化它就可以了。

apiClient = new AbpWebApiClient();

例如，我们对于常规的用户登录处理，它的API调用封装的操作代码如下所示，这个是一个POST方法。

        /// <summary>
        /// 对用户身份进行认证
        /// </summary>
        /// <param name="username">用户名</param>
        /// <param name="password">用户密码</param>
        /// <returns></returns>
        public async virtual Task<AuthenticateResult> Authenticate(string username, string password)
        {
            var url = string.Format("{0}/api/TokenAuth/Authenticate", ServerRootAddress);
            var input = new
            {
                UsernameOrEmailAddress = username,
                Password = password
            };

            var result = await apiClient.PostAsync<AuthenticateResult>(url, input);
            return result;
        }

对于业务接口来说，我们都是基于约定的规则来命名接口名称和地址的，如对于GetAll这个方法来说，字典类型的地址如下所示。

/api/services/app/DictData/GetAll

另外还包括服务器的基础地址，从而构建一个完整的调用地址如下所示。

http://localhost:21021/api/services/app/DictData/GetAll

由于这些规则确定，因此我们可以通过动态构建这个API地址即可。

            string url = GetActionUrl(MethodBase.GetCurrentMethod());//获取访问API的地址（未包含参数）
            url += string.Format("?SkipCount={0}&MaxResultCount={1}", dto.SkipCount, dto.MaxResultCount);

而对于GetAll函数来说，这个定义如下所示。

Task<PagedResultDto<TEntityDto>> GetAll(TGetAllInput input)

它是需要根据一定的条件进行查询的，不仅仅是 SkipCount 和 MaxResultCount两个属性，因此我们需要动态组合它的url参数，因此建立一个辅助类来动态构建这些输入参数地址。

        /// <summary>
        /// 获取所有对象列表
        /// </summary>
        /// <param name="input">获取所有条件</param>
        /// <returns></returns>
        public async virtual Task<PagedResultDto<TEntityDto>> GetAll(TGetAllInput input)
        {
            AddRequestHeaders();//加入认证的token头信息
            string url = GetActionUrl(MethodBase.GetCurrentMethod());//获取访问API的地址（未包含参数）
            url = GetUrlParam(input, url);

            var result = await apiClient.GetAsync<PagedResultDto<TEntityDto>>(url);
            return result;
        }

这样我们这个API的调用封装类的基类就实现了常规的功能了。效果如下所示。

而字典类型的API封装类，我们只需要实现特定的自定义接口即可，省却我们很多的工作量。

namespace MyProject.Caller
{
    /// <summary>
    /// 字典类型对象的Web API调用处理
    /// </summary>
    public class DictTypeApiCaller : AsyncCrudApiCaller<DictTypeDto, string, DictTypePagedDto, CreateDictTypeDto, DictTypeDto>, IDictTypeAppService
    {
        /// <summary>
        /// 提供单件对象使用
        /// </summary>
        public static DictTypeApiCaller Instance
        {
            get
            {
                return Singleton<DictTypeApiCaller>.Instance;
            }
        }

        /// <summary>
        /// 默认构造函数
        /// </summary>
        public DictTypeApiCaller()
        {
            this.DomainName = "DictType";//指定域对象名称，用于组装接口地址
        }

        public async Task<Dictionary<string, string>> GetAllType(string dictTypeId)
        {
            AddRequestHeaders();//加入认证的token头信息
            string url = GetActionUrl(MethodBase.GetCurrentMethod());//获取访问API的地址（未包含参数）
            url += string.Format("?dictTypeId={0}", dictTypeId);

            var result = await apiClient.GetAsync<Dictionary<string, string>>(url);
            return result; 
        }

        public async Task<IList<DictTypeNodeDto>> GetTree(string pid)
        {
            AddRequestHeaders();//加入认证的token头信息
            string url = GetActionUrl(MethodBase.GetCurrentMethod());//获取访问API的地址（未包含参数）
            url += string.Format("?pid={0}", pid);

            var result = await apiClient.GetAsync<IList<DictTypeNodeDto>>(url);
            return result;
        }
    }
}

 

2）API封装类的调用

前面小节介绍了针对Web API接口的封装，以适应客户端快速调用的目的，这个封装作为一个独立的封装层，以方便各个模块之间进行共同调用。

到这里为止，我们还没有测试过具体的调用，还没有了解实际调用过程中是否有问题，当然我们在开发的时候，一般都是一步步来的，但也是确保整个路线没有问题的。

实际情况如何，是骡是马拉出来溜溜就知道了。

首先我们创建一个基于.net Core的控制台程序，项目情况如下所示。

在其中我们定义这个项目的模块信息，它是依赖于APICaller层的模块。

namespace RemoteApiConsoleApp
{
    [DependsOn(typeof(CallerModule))]
    public class MyModule : AbpModule
    {
        public override void Initialize()
        {
            IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
        }
    }
}

在ABP里面，模块是通过一定顺序启动的，如果我们通过AbpBootstrapper类来启动相关的模块，启动模块的代码如下所示。

//使用AbpBootstrapper创建类来处理
using (var bootstrapper = AbpBootstrapper.Create<MyModule>())
{
    bootstrapper.Initialize();

        ..........

模块启动后，系统的IOC容器会为我们注册好相关的接口对象，那么调用API封装类的代码如下所示。

                //使用AbpBootstrapper创建类来处理
                using (var bootstrapper = AbpBootstrapper.Create<MyModule>())
                {
                    bootstrapper.Initialize();

                    #region Role
                    using (var client = bootstrapper.IocManager.ResolveAsDisposable<RoleApiCaller>())
                    {
                        var caller = client.Object;

                        Console.WriteLine("Logging in with TOKEN based auth...");
                        var token = caller.Authenticate("admin", "123qwe").Result;
                        Console.WriteLine(token.ToJson());

                        caller.RequestHeaders.Add(new NameValue("Authorization", "Bearer " + token.AccessToken));

                        Console.WriteLine("Getting roles...");
                        var pagerDto = new PagedResultRequestDto() { SkipCount = 0, MaxResultCount = 10 };
                        var result = caller.GetAll(pagerDto);
                        Console.WriteLine(result.ToJson());

                        Console.WriteLine("Create role...");
                        List<string> permission = new List<string>() { "Pages.Roles" };
                        var createRoleDto = new CreateRoleDto { DisplayName = "test", Name = "Test", Description = "test", Permissions = permission };
                        var roleDto = caller.Create(createRoleDto).Result;
                        Console.WriteLine(roleDto.ToJson());

                        var singleDto = new EntityDto<int>() { Id = roleDto.Id };
                        Console.WriteLine("Getting role by id...");
                        roleDto = caller.Get(singleDto).Result;
                        Console.WriteLine(roleDto);

                        Console.WriteLine("Delete role...");
                        var delResult = caller.Delete(singleDto);
                        Console.WriteLine(delResult.ToJson());

                        Console.ReadLine();
                    }
                    #endregion

上面是对角色的相关接口操作，如果对于我们之前创建的字典模块，那么它的操作代码类似，如下所示。

    #region DictType

    using (var client = bootstrapper.IocManager.ResolveAsDisposable<DictTypeApiCaller>())
    {
        var caller = client.Object;

        Console.WriteLine("Logging in with TOKEN based auth...");
        var token = caller.Authenticate("admin", "123qwe").Result;
        Console.WriteLine(token.ToJson());

        caller.RequestHeaders.Add(new NameValue("Authorization", "Bearer " + token.AccessToken));

        Console.WriteLine("Get All ...");
        var pagerDto = new DictTypePagedDto() { SkipCount = 0, MaxResultCount = 10 };
        var result = caller.GetAll(pagerDto).Result;
        Console.WriteLine(result.ToJson());

        Console.WriteLine("Get All by condition ...");
        var pagerdictDto = new DictTypePagedDto() { Name = "民族" };
        result = caller.GetAll(pagerdictDto).Result;
        Console.WriteLine(result.ToJson());
        
        Console.WriteLine("Get count by condition ...");
        pagerdictDto = new DictTypePagedDto() {};
        var count = caller.Count(pagerdictDto).Result;
        Console.WriteLine(count);
        Console.WriteLine();

        Console.WriteLine("Create DictType...");
        var createDto = new CreateDictTypeDto { Id = Guid.NewGuid().ToString(), Name = "Test", Code = "Test" };
        var dictDto = caller.Create(createDto).Result;
        Console.WriteLine(dictDto.ToJson());

        Console.WriteLine("Update DictType...");
        dictDto.Code = "testcode";
        var updateDto = caller.Update(dictDto).Result;
        Console.WriteLine(updateDto.ToJson());

        if (updateDto != null)
        {
            Console.WriteLine("Delete DictType...");
            caller.Delete(new EntityDto<string>() { Id = dictDto.Id });
        }

    }
    #endregion

测试字典模块的处理，执行效果如下所示。

删除内容，我们是配置为软删除的，因此可以通过数据库记录查看是否标记为删除了。

同时，我们可以看到审计日志里面，有对相关应用层接口的调用记录。

以上就是.net core控制台程序中对于API封装接口的调用，上面代码如果需要在.net framework里面跑，也是一样的，我同样也做了一个基于.net framework控制台程序，代码调用都差不多的，它的ApiCaller我们做成了 .net standard程序类库的，因此都是通用的。

前面我们提到，我们的APICaller的类，设计了单件的实例调用，因此我们调用起来更加方便，除了上面使用ABP的启动模块的方式调用外，我们可以用传统的方式进行调用，也就是创建一个ApiCaller的实例对象的方式进行调用，如下代码所示。

    string loginName = this.txtUserName.Text.Trim();
    string password = this.txtPassword.Text;
    AuthenticateResult result = null;
    try
    {
        result = await DictTypeApiCaller.Instance.Authenticate(loginName, password);
    }
    catch(AbpException ex)
    {
        MessageDxUtil.ShowTips("用户帐号密码不正确。\r\n错误信息：" + ex.Message);
        return;
    }

由于篇幅的原因，基于winform界面模块的调用，我在后面随笔在另起一篇随笔进行介绍吧，毕竟那是毕竟漂亮的字典模块呈现了。