本文示例源代码地址https://github.com/lcyhjx/abp-training
上一篇我们已经对ABP是什么,能做什么、有了一个印象。那么接下来我们将动手使用ABP框架快速开发一个API,你将会发现使用ABP框架有多么便利,会实实在在感受到它的魅力。
环境要求
- Visual Studio 2017
- SQL Server
- .Net Core SDK
创建应用程序
我们使用ABP模板来创建应用程序,访问http://www.aspnetboilerplate.com/Templates,你将会看到如下页面
- 参照上图所示的选项选择
- 输入项目名称,我这里是"AbpTraining"
- 输入验证码
点击“创建项目”, 接着我们就会从ABP模板网站上获得一个项目源码的压缩包AbpTraining.zip. 解压缩AbpTraining.zip就会获得初始项目的源代码。
运行应用程序
- 进入解压目录,点击aspnet-core/AbpTraining.sln,打开解决方案
- 在本地Sql Server数据库实例中创建数据库AbpTrainingDb
- 找到AbpTraining.Web.Host/appsettings.json, 根据自己本地环境修改数据库连接(ConnectionStrings)
"ConnectionStrings": {
"Default": "Server=localhost; Database=AbpTrainingDb; Trusted_Connection=True;"
}
- 使用数据库迁移脚本创建初始数据库
- 在Visual Studio中选择工具-> Nuget包管理器-> 包管理器控制台
- 设置AbpTraining.Web.Host为启动项目
- 在包管理器控制台中设置AbpTraining.EntityFrameworkCore为默认项目
- 包管理器控制台中执行命令 update-database -verbos, 等待命令成功执行完成,就完成了数据库的同步
- 运行AbpTraining.Web.Host, 将会出现swagger的api页面,程序运行成功
我的第一个API
1. API功能
功能: 根据商品名查询商品信息
2. 创建商品实体
AbpTraining.Core\\Products\\Product.cs
using Abp.Domain.Entities.Auditing;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace AbpTraining.Products
{
//可以显示的指定表名,不指定默认是实体名+s
[Table("Product")]
public class Product : FullAuditedEntity<long>
{
[Required]
[StringLength(128)]
public string Name { get; set; }
public decimal Price { get; set; }
}
}
- [Table("Product")] 显示指定实体对应的表名,如果不指定,默认用类名+s
- FullAuditedEntity
为实体添加审计字段CreattonTime、CreatorUserId、DeleterUserId、DeletionTime、LastModificationTime、LastModifierUserId, 类型 指定主键的类型 - [Required]指定字段是必填的, 不指定则字段可为空
- [StringLength(128)]指定字段最大长度为128
3. 创建商品领域DomainService
AbpTraining.Core\\Products\\ProductDomainService.cs
using Abp.Domain.Repositories;
using Abp.Domain.Services;
using System.Threading.Tasks;
using System.Linq;
using Abp.UI;
using Microsoft.EntityFrameworkCore;
namespace AbpTraining.Products
{
public class ProductDomainService : DomainService
{
private readonly IRepository<Product, long> _productRepository;
public ProductDomainService(IRepository<Product, long> productRepository)
{
_productRepository = productRepository;
}
public async Task<Product> GetProductByName(string name)
{
var query = from p in _productRepository.GetAll()
where p.Name == name
select p;
var product = await query.FirstOrDefaultAsync();
if (product == null)
{
throw new UserFriendlyException($"商品({name})不存在");
}
if (product.Price < 0)
{
throw new UserFriendlyException($"商品({name})的价格小于0,请检查");
}
return product;
}
}
}
- 领域服务要继承DomainService
- _productRepository数据仓储直接依赖注入
- 使用async await一异步编程模型
- 使用Linq To Sql查询数据
- 如果要返回业务错误消息给客户端,要使用UserFriendlyException
4. 创建商品ApplicationService
4.1 定义Dto
AbpTraining.Application\\Products\\Dto\\ProductDto
using Abp.AutoMapper;
namespace AbpTraining.Products.Dto
{
[AutoMapFrom(typeof(Product))]
public class ProductDto
{
public string Name { get; set; }
public decimal Price { get; set; }
}
}
- AutoMapFrom特性指明从哪一个类可以自动映射到当前类,这样就不用手动的去做实体时间的转换
AbpTraining.Application\\Products\\Dto\\GetProductByNameInput
using System.ComponentModel.DataAnnotations;
namespace AbpTraining.Products.Dto
{
public class GetProductByNameInput
{
[Required]
public string Name { get; set; }
}
}
- [Required] - input对象中有此特性,ABP会自动对request的这个字段做必填验证
Mysoft.RDC.Application\\Products\\Dto\\GetProductByNameOutput
namespace AbpTraining.Products.Dto
{
public class GetProductByNameOutput : ProductDto
{
}
}
4.2 定义ApplicationService接口
AbpTraining.Application\\Products\\IProductAppService.cs
using Abp.Application.Services;
using AbpTraining.Products.Dto;
using System.Threading.Tasks;
namespace AbpTraining.Products
{
public interface IProductAppService : IApplicationService
{
Task<GetProductByNameOutput> GetProductByName(GetProductByNameInput input);
}
}
- 应用服务接口要继承IApplicationService
4.3 商品ApplicationService实现
AbpTraining.Application\\Products\\ProductAppService.cs
using System.Threading.Tasks;
namespace AbpTraining.Products.Dto
{
public class ProductAppService : AbpTrainingAppServiceBase, IProductAppService
{
private readonly ProductDomainService _productDomainService;
public ProductAppService(ProductDomainService productDomainService)
{
_productDomainService = productDomainService;
}
public async Task<GetProductByNameOutput> GetProductByName(GetProductByNameInput input)
{
//1.将input dto转换为domain obj
//2.调用doamin service
var item = await _productDomainService.GetProductByName(input.Name);
//call other doamin serivce
//3.将domain obj转换为output dto
var output = ObjectMapper.Map<GetProductByNameOutput>(item);
return output;
}
}
}
- 应用服务实现要继承AbpTrainingAppServiceBase
5. 数据库
5.1 数据库实体映射
在AbpTraining.EntityFrameworkCore\\EntityFrameworkCore\\AbpTrainingDbContext.cs 中添加如下代码片段
public DbSet<Product> Products { get; set; }
5.2 生成migration文件
在包管理器控制台中,执行如下命令,生成迁移脚本文件
Add-Migration AddProduct -Verbos
- 执行完成后,会在在AbpTraining.EntityFrameworkCore\\Migrations下看到新生成的脚本文件,我这次生成的文件名是20180405043514_AddProduct.cs (会有一个时间戳前缀,每次会不一样)
5.3 更新数据库
在包管理器控制台中,执行如下命令,将新的实体同步数据库
Update-Database -Verbos
- 执行完成后,你会在数据库看到一个新表Product
6. 运行服务、测试
设置AbpTraining.Web.Host为启动项目,直接在Visual Studio中运行, 在Swagger的API列表中找到/api/services/app/Product/GetProductByName 即可以开始测试。
到此,我们的第一个API就成功的完成了.