Build Web APIs Faster with .NET Core Scaffolding

Transcript

1. Build Web APIs Faster With .NET Core Scaffolding Tony Sneed and Long Le
2. About Tony • Sr. Solutions Architect
 @ www.hilti.com • Coding C# since v1 • Author / Instructor:
 DevelopMentor, Wintellect • Open Source:
 URF, Trackable Entities
 ASPNET Core, EF Core • blog.TonySneed.com • Twitter: @tonysneed
3. About Le • Sr. Solutions Architect
 @ www.hilti.com • Currently geeking out with MEAN & .NET Core • Open Source:
 URF.Core, Trackable Entities • blog.longle.io • Twitter: @lelong37
4. Problem: Boilerplate code is time-consuming and boring!
5. Solution: .NET Core code scaffolding to the rescue!
6. Part 1: Intro to .NET Core Scaffolding
7. What is .NET Core Scaffolding? • Reverse engineer entity and EF Core context classes from existing database • Create Web API controllers with CRUD operations based on EF Core context class
8. Scaffolding Approaches • Visual Studio wizards
 - EF Core Power Tools
 - Add New Controller wizard
 - Visual Studio only
 - Windows only • Command line
 - .NET Core CLI
 - VS Code or Visual Studio
 - Cross-platform
9. EF Core: Not Your Father’s EF • Re-written from the ground up! • .NET Standard 2.0 • Cross-Platform, Containers, Cloud Friendly • Modern, Modular, Extensible • Lightweight, Performant
10. Migrate from EF6 to Core? Don’t even think about it!
11. EF Core Power Tools • Reverse engineer • Visualize model • Customize entity classes (Handlebars templates*) * Tony’s contrib :)
12. EF Core CLI • Cross Platform
 - Compatible with VS Code on Windows or Mac • Flexible Options
 - Output entities and context to different projects
13. Project Structure • Entities: NET Standard 2.0 class library
 - Compatible across all flavors of .NET • DbContext: .NET Core class library
 - EF Core CLI requires .NET Core • Web API: ASP.NET Core Project
 - Reference Entities and Data projects
14. Customizing Code Generation • Handlebars Templates
 - Double curly model binding
 - Partial templates
 - Helper methods • IDesignTimeServices implementation
 - services.AddHandlebarsScaffolding • https://github.com/TrackableEntities/ EntityFrameworkCore.Scaffolding.Handlebars
15. Scaffolding Web API Controllers • Razor Templates
 - C# Syntax
 - Partial templates
 - Helper methods • .NET Core CLI
 - dotnet new -i “AspNetCore.WebApi.Templates::*" • https://github.com/TrackableEntities/ AspNetCore.ApiControllers.Templates
17. Part 2: Design Patterns for EF Core
18. Why Patterns? • Using EF directly couples your app to EF • Newing up DbContext makes your app
 less testable
19. Repository Pattern • Repository interfaces decouple app from persistence concerns
20. Sample Repository public class ProductRepository : IProductRepository { private readonly NorthwindContext _dbContext; public ProductRepository(NorthwindContext dbContext)
 { _dbContext = dbContext; } public async Task<Product> FindAsync(int id) { return await _dbContext.Products.FindAsync(id); } }
21. Marking Changes public void Insert(Product product) { // Mark Added _dbContext.Products.Add(product); } public void Update(Product product) { // Mark Modified _dbContext.Products.Update(product); } public async Task Delete(int id) { // Mark Deleted var product = await _dbContext.Products.FindAsync(id) _dbContext.Products.Remove(product); }
22. Unit of Work Pattern • Save changes from multiple repositories • Wrapped in a single transaction
23. Persisting Changes public interface IUnitOfWork { Task<int> SaveChangesAsync(); }
24. Dependency Injection • DI container responsible for supplying instances • DI is built into ASP.NET and EF Core
25. Helpful Frameworks • URF: Generic Unit of Work and Repository https://github.com/urfnet/URF.Core
26. Helpful Frameworks • Trackable Entities: N-Tier Support for EF Core https://github.com/TrackableEntities/ TrackableEntities.Core
28. Thank You! Tony Sneed: @tonysneed
 Long Le: @lelong37 Slides:
 https://speakerdeck.com/tonysneed/ef-core-with-patterns Bits: https://github.com/tonysneed/Demo.EfCore.Patterns
29. Thank You! Tony Sneed: @tonysneed
 Long Le: @lelong37 Slides:
 https://speakerdeck.com/tonysneed/ef-core-with-patterns Bits: https://github.com/tonysneed/Demo.EfCore.Patterns