asp.net zero 8.2 学习-4-创建接口及服务

迷南。 2021-07-26 23:43 333阅读 0赞

上一节，在框架添加了实体，这一节，写接口及服务类，实现实体的增删改查：

> 1.  创建接口： SIS.Application.Shared层
> 2.  创建DTO: SIS.Application.Shared层,对应的Dto文件夹
> 3.  创建Dto映射Mapper: SIS.Application层CustomDtoMapper.cs
> 4.  创建服务层：SIS.Application层

## 创建接口 ##

在SIS.Application.Shared层创建Demo文件夹,并创建接口文件：IDemoObjectAppService，接口定义了增删改查及获取数据列表的方法

using Abp.Application.Services;
    using Abp.Application.Services.Dto;
    using EDU.SIS.Demo.Dtos;
    using System.Threading.Tasks;
    
    namespace EDU.SIS.Demo
    {
        /// <summary>
        /// DemoObject 应用接口
        /// </summary>
        public interface IDemoObjectAppService:IApplicationService
        {
            /// <summary>
            /// 分页查询所有实体
            /// </summary>
            /// <param name="input">分页排序筛选</param>
            /// <returns></returns>
            Task<PagedResultDto<GetDemoObjectForViewDto>> GetAll(GetAllDemoObjectInput input);
    
            /// <summary>
            /// 创建和修改
            /// </summary>
            /// <param name="input"></param>
            /// <returns></returns>
            Task CreateOrEdit(CreateOrEditDemoObjectDto input);
    
            /// <summary>
            /// 获取修改数据详情
            /// </summary>
            /// <param name="input"></param>
            /// <returns></returns>
            Task<GetDemoObjectForEditOutput> GetDemoObjectForEdit(EntityDto input);
    
            /// <summary>
            /// 数据删除
            /// </summary>
            /// <param name="input"></param>
            /// <returns></returns>
            Task Delete(EntityDto input);
    
            /// <summary>
            /// 获取单条数据
            /// </summary>
            /// <param name="id"></param>
            /// <returns></returns>
            Task<GetDemoObjectForViewDto> GetDemoObjectForView(int id);
    
        }
    }

## 创建DTO ##

在SIS.Application.Shared层的Demo文件夹下创建Dto文件夹，并创建IDemoObjectAppService中使用的Dto,注意Dto的命名：  
CreateOrEditDemoObjectDto继承自EntityDto<int?>，其中EntityDto里面只包含ID,可以通过判断ID是否为空来确定是创建或编辑状态。  
GetAllDemoObjectInput继承自PagedAndSortedResultRequestDto，返回的包括实体集合及分页,过滤信息

CreateOrEditDemoObjectDto:
    
    using Abp.Application.Services.Dto;
    using System;
    using System.ComponentModel.DataAnnotations;
    
    namespace EDU.SIS.Demo.Dtos
    {
        public class CreateOrEditDemoObjectDto:EntityDto<int?>
        {
            /// <summary>
            /// 姓名
            /// </summary>
            [Required]
            [StringLength(DemoObjectConsts.MaxNameLength)]
            public string Name { get; set; }
            /// <summary>
            /// 年龄
            /// </summary>
            public int Age { get; set; }
            /// <summary>
            /// 价格
            /// </summary>
            public double Price { get; set; }
            /// <summary>
            /// 是否为会员
            /// </summary>
            public bool IsVip { get; set; }
            /// <summary>
            /// 截至时间
            /// </summary>
            public DateTime EndDateTime { get; set; }
        }
    }
    
    DemoObjectDto: 
    using Abp.Application.Services.Dto;
    using System;
    
    namespace EDU.SIS.Demo.Dtos
    {
        public class DemoObjectDto:EntityDto
        {
            /// <summary>
            /// 姓名
            /// </summary>
            public string Name { get; set; }
            /// <summary>
            /// 年龄
            /// </summary>
            public int Age { get; set; }
            /// <summary>
            /// 价格
            /// </summary>
            public double Price { get; set; }
            /// <summary>
            /// 是否为会员
            /// </summary>
            public bool IsVip { get; set; }
            /// <summary>
            /// 截至时间
            /// </summary>
            public DateTime EndDateTime { get; set; }
    
        }
    }
    
    GetAllDemoObjectInput: 
    using Abp.Application.Services.Dto;
    
    namespace EDU.SIS.Demo.Dtos
    {
        public class GetAllDemoObjectInput:PagedAndSortedResultRequestDto
        {
            // 模糊查询过滤器
            public string Filter { get; set; }
            //特定字段查询过滤器
            public string NameFilter { get; set; }
        }
    }
    
    GetDemoObjectForEditOutput:
    namespace EDU.SIS.Demo.Dtos
    {
        public class GetDemoObjectForEditOutput
        {
            public DemoObjectDto DemoObject { get; set; }
        }
    }
    
    GetDemoObjectForViewDto:
    namespace EDU.SIS.Demo.Dtos
    {
        public class GetDemoObjectForViewDto
        {
            public DemoObjectDto DemoObject { get; set; }
        }
    }

## 创建Dto映射Mapper ##

在SIS.Application层CustomDtoMapper.cs中对Dto和实体添加映射关系,这里是集中配置，还可以参考官方文档，在Dto类中使用特性配置

configuration.CreateMap<DemoObject, DemoObjectDto>();
    configuration.CreateMap<CreateOrEditDemoObjectDto, DemoObject>();

## 创建服务层 ##

在SIS.Application层，添加Demo文件夹，并创建DemoObjectAppService类，继承SISAppServiceBase类，实现IDemoObjectAppService接口：

using Abp.Application.Services.Dto;
    using EDU.SIS.Demo.Dtos;
    using System;
    using System.Threading.Tasks;
    
    namespace EDU.SIS.Demo
    {
        public class DemoObjectAppService : SISAppServiceBase, IDemoObjectAppService
        {
            /// <summary>
            /// 创建和修改
            /// </summary>
            /// <param name="input"></param>
            /// <returns></returns>
            public Task CreateOrEdit(CreateOrEditDemoObjectDto input)
            {
                throw new NotImplementedException();
            }
    
            /// <summary>
            /// 数据删除
            /// </summary>
            /// <param name="input"></param>
            /// <returns></returns>
            public Task Delete(EntityDto input)
            {
                throw new NotImplementedException();
            }
    
            /// <summary>
            /// 分页查询所有实体
            /// </summary>
            /// <param name="input">分页排序筛选</param>
            /// <returns></returns>
            public Task<PagedResultDto<GetDemoObjectForViewDto>> GetAll(GetAllDemoObjectInput input)
            {
                throw new NotImplementedException();
            }
    
            /// <summary>
            /// 获取修改数据详情
            /// </summary>
            /// <param name="input"></param>
            /// <returns></returns>
            public Task<GetDemoObjectForEditOutput> GetDemoObjectForEdit(EntityDto input)
            {
                throw new NotImplementedException();
            }
    
            /// <summary>
            /// 获取单条数据
            /// </summary>
            /// <param name="id"></param>
            /// <returns></returns>
            public Task<GetDemoObjectForViewDto> GetDemoObjectForView(int id)
            {
                throw new NotImplementedException();
            }
        }
    }