What is DNTFrameworkCore?

CRUD-based Thinking

publicinterfaceIBlogService:IEntityService<int,BlogModel>{}publicclassBlogService:EntityService<Blog,int,BlogModel>,IBlogService{privatereadonlyIMapper_mapper;publicBlogService(IDbContextdbContext,IEventBusbus,IMappermapper):base(dbContext,bus){_mapper=mapper??thrownewArgumentNullException(nameof(mapper));}publicoverrideTask<IPagedResult<BlogModel>>FetchPagedListAsync(FilteredPagedRequestrequest,CancellationTokencancellationToken=default){returnEntitySet.AsNoTracking().Select(b=>newBlogModel{Id=b.Id,Version=b.Version,Url=b.Url,Title=b.Title}).ToPagedListAsync(request,cancellationToken);}protectedoverridevoidMapToEntity(BlogModelmodel,Blogblog){_mapper.Map(model,blog);}protectedoverrideBlogModelMapToModel(Blogblog){return_mapper.Map<BlogModel>(blog);}}

[Route("api/[controller]")]publicclassBlogsController:EntityController<IBlogService,int,BlogModel>{publicBlogsController(IBlogServiceservice):base(service){}protectedoverridestringCreatePermissionName=>PermissionNames.Blogs_Create;protectedoverridestringEditPermissionName=>PermissionNames.Blogs_Edit;protectedoverridestringViewPermissionName=>PermissionNames.Blogs_View;protectedoverridestringDeletePermissionName=>PermissionNames.Blogs_Delete;}

publicclassBlogsController:EntityController<IBlogService,int,BlogModel>{publicBlogsController(IBlogServiceservice):base(service){}protectedoverridestringCreatePermissionName=>PermissionNames.Blogs_Create;protectedoverridestringEditPermissionName=>PermissionNames.Blogs_Edit;protectedoverridestringViewPermissionName=>PermissionNames.Blogs_View;protectedoverridestringDeletePermissionName=>PermissionNames.Blogs_Delete;protectedoverridestringViewName=>"_BlogPartial";}

@inheritsEntityFormRazorPage<BlogModel>@{Layout="_EntityFormLayout";EntityName="Blog";DeletePermission=PermissionNames.Blogs_Delete;CreatePermission=PermissionNames.Blogs_Create;EditPermission=PermissionNames.Blogs_Edit;EntityDisplayName="Blog";}<divclass="form-group row">   <divclass="col col-md-8">       <labelasp-for="Title"class="col-form-label text-md-left"></label>       <inputasp-for="Title"autocomplete="off"class="form-control"/>       <spanasp-validation-for="Title"class="text-danger"></span>   </div></div><divclass="form-group row">   <divclass="col">       <labelasp-for="Url"class="col-form-label text-md-left"></label>       <inputasp-for="Url"class="form-control"type="url"/>       <spanasp-validation-for="Url"class="text-danger"></span>   </div></div>

Installation

PM> Install-Package DNTFrameworkCorePM> Install-Package DNTFrameworkCore.EFCorePM> Install-Package DNTFrameworkCore.EFCore.SqlServerPM> Install-Package DNTFrameworkCore.WebPM> Install-Package DNTFrameworkCore.Web.TenancyPM> Install-Package DNTFrameworkCore.Web.EFCorePM> Install-Package DNTFrameworkCore.LicensingPM> Install-Package DNTFrameworkCore.FluentValidation

Features

Usage

publicclassTask:Entity<int>,INumberedEntity,IHasRowVersion,IHasRowIntegrity,ICreationTracking,IModificationTracking{publicconstintMaxTitleLength=256;publicconstintMaxDescriptionLength=1024;publicstringTitle{get;set;}publicstringNormalizedTitle{get;set;}publicstringNumber{get;set;}publicstringDescription{get;set;}publicTaskStateState{get;set;}=TaskState.Todo;publicbyte[]Version{get;set;}}

publicclassProjectDbContext:DbContextCore{publicProjectDbContext(DbContextOptions<ProjectDbContext>options,IEnumerable<IHook>hooks):base(options,hooks){}protectedoverridevoidOnModelCreating(ModelBuildermodelBuilder){modelBuilder.ApplyConfigurationsFromAssembly(Assembly.GetExecutingAssembly());modelBuilder.AddJsonFields();modelBuilder.AddTrackingFields<long>();modelBuilder.AddIsDeletedField();modelBuilder.AddRowVersionField();modelBuilder.AddRowIntegrityField();modelBuilder.NormalizeDateTime();modelBuilder.NormalizeDecimalPrecision();base.OnModelCreating(modelBuilder);}}

[LocalizationResource(Name="SharedResource",Location="DNTFrameworkCore.TestAPI")]publicclassTaskModel:MasterModel<int>,IValidatableObject{publicstringTitle{get;set;}[MaxLength(50,ErrorMessage="Validation from DataAnnotations")]publicstringNumber{get;set;}publicstringDescription{get;set;}publicTaskStateState{get;set;}=TaskState.Todo;publicIEnumerable<ValidationResult>Validate(ValidationContextvalidationContext){if(Title=="IValidatableObject"){yieldreturnnewValidationResult("Validation from IValidatableObject");}}}

publicclassTaskValidator:ModelValidator<TaskModel>{publicoverrideIEnumerable<ModelValidationResult>Validate(TaskModelmodel){if(!Enum.IsDefined(typeof(TaskState),model.State)){yieldreturnnewModelValidationResult(nameof(TaskModel.State),"Validation from IModelValidator");}}}

publicclassTaskReadModel:ReadModel<int>{publicstringTitle{get;set;}publicstringNumber{get;set;}publicTaskStateState{get;set;}=TaskState.Todo;}

publicinterfaceITaskService:IEntityService<int,TaskReadModel,TaskModel,TaskFilteredPagedRequest>{}publicclassTaskService:EntityService<Task,int,TaskReadModel,TaskModel,TaskFilteredPagedRequest>,ITaskService{privatereadonlyIMapper_mapper;publicTaskService(IDbContextdbContext,IEventBusbus,IMappermapper):base(dbContext,bus){_mapper=mapper??thrownewArgumentNullException(nameof(mapper);}publicoverrideTask<IPagedResult<TaskReadModel>>FetchPagedListAsync(TaskFilteredPagedRequestrequest,CancellationTokencancellationToken=default){returnEntitySet.AsNoTracking().WhereIf(model.State.HasValue, t=>t.State==model.State).Select(t=>newTaskReadModel{Id=t.Id,Title=t.Title,State=t.State,Number=t.Number}).ToPagedListAsync(request,cancellationToken);}protectedoverridevoidMapToEntity(TaskModelmodel,Tasktask){_mapper.Map(model,task);}protectedoverrideTaskModelMapToModel(Tasktask){return_mapper.Map<TaskModel>(task);}}

[Route("api/[controller]")]publicclassTasksController:EntityController<ITaskService,int,TaskReadModel,TaskModel,TaskFilteredPagedRequest>{publicTasksController(ITaskServiceservice):base(service){}protectedoverridestringCreatePermissionName=>PermissionNames.Tasks_Create;protectedoverridestringEditPermissionName=>PermissionNames.Tasks_Edit;protectedoverridestringViewPermissionName=>PermissionNames.Tasks_View;protectedoverridestringDeletePermissionName=>PermissionNames.Tasks_Delete;}

[Route("api/[controller]")]publicclassBlogsController:EntityController<IBlogService,int,BlogModel>{publicBlogsController(IBlogServiceservice):base(service){}protectedoverridestringCreatePermissionName=>PermissionNames.Blogs_Create;protectedoverridestringEditPermissionName=>PermissionNames.Blogs_Edit;protectedoverridestringViewPermissionName=>PermissionNames.Blogs_View;protectedoverridestringDeletePermissionName=>PermissionNames.Blogs_Delete;}

Task-based Thinking

publicclassPriceType:Entity<long>,IAggregateRoot{privatePriceType(Titletitle){Title=title;}publicPriceType(Titletitle,IPriceTypePolicypolicy){if(title==null)thrownewArgumentNullException(nameof(title));if(policy==null)thrownewArgumentNullException(nameof(policy));Title=title;if(!policy.IsUnique(this))ThrowDomainException("PriceType Title Should Be Unique");AddDomainEvent(newPriceTypeCreatedDomainEvent(this));}publicTitleTitle{get;privateset;}// public static Result<PriceType> New(Title title, IPriceTypePolicy policy)// {//     if (title == null) throw new ArgumentNullException(nameof(title));//     if (policy == null) throw new ArgumentNullException(nameof(policy));////     var priceType = new PriceType(title);//     if (!policy.IsUnique(priceType)) return Fail<PriceType>("PriceType Title Should Be Unique");////     priceType.AddDomainEvent(new PriceTypeCreatedDomainEvent(priceType));////     return Ok(priceType);// }}

publicclassTitle:ValueObject{privateTitle(){}publicTitle(stringvalue){value??=string.Empty;switch(value.Length){case0:ThrowDomainException("title should not be empty");break;case>100:ThrowDomainException("title is too long");break;}}publicstringValue{get;privateset;}protectedoverrideIEnumerable<object>EqualityValues{get{yieldreturnValue;}}// public static Result<Title> New(string value)// {//     value ??= string.Empty;////     if (value.Length == 0) return Fail<Title>("title should not be empty");////     return value.Length > 100 ? Fail<Title>("title is too long") : Ok(new Title { Value = value });// }publicstaticimplicitoperatorstring(Titletitle){returntitle.Value;}publicstaticexplicitoperatorTitle(stringtitle){returnnew(title);}}

publicsealedclassPriceTypeCreatedDomainEvent:DomainEvent{publicPriceTypeCreatedDomainEvent(PriceTypepriceType){PriceType=priceType??thrownewArgumentNullException(nameof(priceType));}publicPriceTypePriceType{get;}}

publicsealedclassCreatePriceTypeCommand:ICommand{publicstringTitle{get;}[JsonConstructor]publicCreatePriceTypeCommand(stringtitle)=>Title=title;}

publicclassPriceTypeCommandHandlers:ICommandHandler<RemovePriceTypeCommand,Result>,ICommandHandler<CreatePriceTypeCommand,Result>{privatereadonlyIUnitOfWork_uow;privatereadonlyIPriceTypeRepository_repository;privatereadonlyIPriceTypePolicy_policy;privatereadonlyIEventBus_bus;publicPriceTypeCommandHandlers(IUnitOfWorkuow,IPriceTypeRepositoryrepository,IPriceTypePolicypolicy,IEventBusbus){_uow=uow??thrownewArgumentNullException(nameof(uow));_repository=repository??thrownewArgumentNullException(nameof(repository));_policy=policy??thrownewArgumentNullException(nameof(policy));_bus=bus??thrownewArgumentNullException(nameof(bus));}publicasyncTask<Result>Handle(RemovePriceTypeCommandcommand,CancellationTokencancellationToken){varpriceType=await_repository.FindAsync(command.PriceTypeId,cancellationToken);if(priceTypeisnull)returnResult.Fail($"PriceType with id:{command.PriceTypeId} not found");//Alternative: _repository.Remove(priceType);_uow.Set<PriceType>().Remove(priceType);await_uow.SaveChanges(cancellationToken);await_bus.DispatchDomainEvents(priceType,cancellationToken);returnResult.Ok();}publicasyncTask<Result>Handle(CreatePriceTypeCommandcommand,CancellationTokencancellationToken){vartitle=newTitle(command.Title);varpriceType=newPriceType(title,_policy);//Alternative: _repository.Add(priceType);_uow.Set<PriceType>().Add(priceType);await_uow.SaveChanges(cancellationToken);await_bus.DispatchDomainEvents(priceType,cancellationToken);returnResult.None;}}

TODO

ASP.NET Boilerplate