Em grande parte de nosso sistema, muitas telas precisam conter apenas uma lógica de CRUD básica (Create, Read, Update e Delete).
Visando uma maior produtividade, o TNF trás classes que agilizam essa criação de serviços de forma automática.
Para utilizar essas funcionalidades instale via nuget o pacote Tnf.App.EntityFrameworkCore disponível em: https://www.myget.org/F/tnf/api/v3/index.json
Primeiro vamos criar nossa interface para o serviço de aplicação definindo sua herança para a interface IAppApplicationService<PersonDto, GetAllPeopleDto> informando qual o Dto será usado para o mapeamento da entidade, e qual o Dto para métodos de GetAll:
public interface IPersonAppService : IAppApplicationService<PersonDto, GetAllPeopleDto> { }
Dto:
public class PersonDto : DtoBase { public static PersonDto NullInstance = new PersonDto().AsNullable(); public string Name { get; set; } public enum Error { GetAllPeople = 1, GetPerson = 2, PostPerson = 3, PutPerson = 4, DeletePerson = 5 } }
Entidade:
[AutoMap(typeof(CountryDto))] public class Person : Entity { public string Name { get; set; } public Person() { } public Person(int id, string name) { Id = id; Name = name; } public enum Error { PersonNameMustHaveValue = 1 } }
Até este ponto temos nossa definição de serviço (interface), Dto criado e Entidade no Entity Framework Core representada.
Essa especificação garante que ao utilizar o serviço de CRUD irá usar o Mapper automático das propriedades pra classe de infraestrutura e Dto.
Para utilizar o AutoMapper consulte o tópico de Mapeamento Automático de Entidades.
public class PersonAppService : AppApplicationService, IPersonAppService { private readonly IAppDomainService<Person> _service; public PersonAppService(IAppDomainService<Person> service) { _service = service; } public IListDto<PersonDto, int> GetAll(GetAllPeopleDto request) => _service.GetAll<PersonDto>(request, p => request.Name.IsNullOrEmpty() || p.Name.Contains(request.Name)); public PersonDto Get(IRequestDto<int> id) { ValidateRequestDto(id, nameof(id)); if (Notification.HasNotification()) return PersonDto.NullInstance; var entity = _service.Get(id); return entity.MapTo<PersonDto>(); } public PersonDto Create(PersonDto person) { ValidateDto(person, nameof(person)); if (Notification.HasNotification()) return PersonDto.NullInstance; var personBuilder = new PersonBuilder(Notification) .WithId(person.Id) .WithName(person.Name); person.Id = _service.InsertAndGetId(personBuilder); return person; } public PersonDto Update(int id, PersonDto person) { ValidateDtoAndId(person, id, nameof(person), nameof(id)); if (Notification.HasNotification()) return PersonDto.NullInstance; var personBuilder = new PersonBuilder(Notification) .WithId(id) .WithName(person.Name); _service.Update(personBuilder); person.Id = id; return person; } public void Delete(int id) { ValidateId(id, nameof(id)); if (Notification.HasNotification()) return; _service.Delete(id); } }
Note que a definição do serviço se da pela herança da classe IAppDomainService<Person> onde é passado a Entidade do Entity Framework Core.
Após a definição acima o serviço de aplicação pode ser usado normalmente.
A interface IAppApplicationService<PersonDto, GetAllPeopleDto> expõe os métodos de CRUD no formato síncrono. Também existe a versão assíncrona do serviço de CRUD usando a interface IAppAsyncApplicationService<PersonDto, GetAllPeopleDto>.