Build Web APIs Faster with .NET Core Scaffolding

By Tony Sneed and Long Le

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. Get the Slides Slides:
 https://speakerdeck.com/tonysneed/ build-web-apis-faster-with-net-core-scaffolding
5. Problem: Boilerplate code is time-consuming and boring!
6. Solution: .NET Core code scaffolding to the rescue!
7. Part 1: Intro to .NET Core Scaffolding
8. 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
9. 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
10. 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
11. Migrate from EF6 to Core? Don’t even think about it!
12. EF Core Power Tools • Reverse engineer • Visualize model • Customize entity classes (Handlebars templates*) * Tony’s contrib :)
13. EF Core CLI • Cross Platform
 - Compatible with VS Code on Windows or Mac • Flexible Options
 - Output entities and context to different projects
14. 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
15. Customizing Code Generation • Handlebars Templates
 - Double curly model binding
 - Partial templates
 - Helper methods • IDesignTimeServices implementation
 - services.AddHandlebarsScaffolding • https://github.com/TrackableEntities/ EntityFrameworkCore.Scaffolding.Handlebars
16. 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
18. Part 2: Design Patterns for EF Core
19. Why Patterns? • Using EF directly couples your app to EF • Newing up DbContext makes your app
 less testable
20. Repository Pattern • Repository interfaces decouple app from persistence concerns
21. 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); } }
22. 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); }
23. Unit of Work Pattern • Save changes from multiple repositories • Wrapped in a single transaction
24. Persisting Changes public interface IUnitOfWork { Task<int> SaveChangesAsync(); }
25. Dependency Injection • DI container responsible for supplying instances • DI is built into ASP.NET and EF Core
26. Helpful Frameworks • URF: Generic Unit of Work and Repository https://github.com/urfnet/URF.Core
27. Helpful Frameworks • Trackable Entities: N-Tier Support for EF Core https://github.com/TrackableEntities/ TrackableEntities.Core
29. Thank You! Tony Sneed: @tonysneed
 Long Le: @lelong37 Slides:
 https://speakerdeck.com/tonysneed/ build-web-apis-faster-with-net-core-scaffolding