asp.net zero 8.2 学习-4-创建接口及服务
系列目录：
asp.net zero 8.2 学习-1-安装
asp.net zero 8.2 学习-3-添加实体，并迁移到数据库
asp.net zero 8.2 学习-5-实现增删改查服务及API测试
asp.net zero 8.2 学习-7-展示实体列表，实现查询，分页，过滤，排序功能
asp.net zero 8.2 学习-8-实现在页面添加、编辑、删除、查看实体
asp.net zero 8.2 学习-9-多租户设置,发送邮件配置
asp.net zero 8.2 学习-11-Metronic替换google字体，加速网页加载速度
上一节，在框架添加了实体，这一节，写接口及服务类，实现实体的增删改查：
- 创建接口： SIS.Application.Shared层
- 创建DTO: SIS.Application.Shared层,对应的Dto文件夹
- 创建Dto映射Mapper: SIS.Application层CustomDtoMapper.cs
- 创建服务层：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();
}
}
}
