Merge pull request #52 from ForEvolve/design-pattern-third-edition

Architecting ASP.NET Core Applications—Unveiling the Third Edition

Author: Carl-Hugo

.gitignore

@@ -4,4 +4,5 @@ Gemfile.lock
 _drafts/en/_emmet.html
 .jekyll-metadata
 .jekyll-cache
-raft
+raft
+rafts

.vscode/settings.json

@@ -10,16 +10,15 @@
     "grammarly.selectors": [
         {
             "language": "jekyll",
-            "scheme": "file",
-            "pattern": "_drafts/en/2022-05-28-an-atypical-asp-net-core-6-design-patterns-guide-second-edition.md"
+            "scheme": "file"
         },
         {
             "language": "markdown",
             "scheme": "file",
-            "pattern": "_drafts/en/2022-05-28-an-atypical-asp-net-core-6-design-patterns-guide-second-edition.md"
+            "pattern": "_drafts/en/2024-02-01-an-atypical-asp-net-core-8-design-patterns-guide-third-edition-unveiling.md"
         }
     ],
-    "[markdown]":{
+    "[markdown]": {
         "editor.wordWrap": "on"
-    },
+    }
 }

README.md

@@ -8,7 +8,9 @@ The blog content is Copyright (c) 2017 Carl-Hugo Marcotte under Creative Commons
 
 ```
 jekyll serve --watch
-grunt watch
+npx grunt
+npx grunt watch
+~~grunt watch~~
 jekyll serve --watch --drafts
 bundle exec jekyll serve --watch --drafts
 bundle exec jekyll serve --watch --drafts --incremental --future

_data/buy-books.json

@@ -1,4 +1,11 @@
 [
+    {
+        "linkHref": "https://adpg.link/buy8",
+        "bookTitle": "Architecting ASP.NET Core Applications: An Atypical Design Patterns Guide for .NET 8, C# 12, and Beyond, 3rd Edition",
+        "imageSrc": "//cdn.forevolve.com/blog/images/net8-book-cover/ADPG-NET8-book-cover-200.png",
+        "amazonExt": "",
+        "enabled": true
+    },
     {
         "linkHref": "https://adpg.link/buycom6",
         "bookTitle": "An Atypical ASP.NET Core 6 Design Patterns Guide: A SOLID adventure into architectural principles and design patterns using .NET 6 and C# 10, 2nd Edition",
@@ -41,4 +48,4 @@
         "amazonExt": ".ca",
         "enabled": false
     }
-]
+]

_drafts/en/2023-12-01-an-atypical-asp-net-core-8-design-patterns-guide-third-edition.md

@@ -0,0 +1,214 @@
+---
+title: 'Book: An Atypical ASP.NET Core 8 Design Patterns Guide'
+subtitle: "What's new in the third edition?"
+date: 2023-12-01 00:00:00 -0500
+post-img: '/img/2023-12-Book3-release-960.png'
+# og-img: '//cdn.forevolve.com/blog/images/articles-header/2022-05-Book2-release-LinkedIn.png'
+# twitter-img: '//cdn.forevolve.com/blog/images/articles-header/2022-05-Book2-release-LinkedIn.png'
+lang: en
+categories: en/articles
+tags:
+    - UML
+    - Book
+proficiency-level: Intermediate
+---
+
+...<!--more-->
+
+# What's new and what's changed?
+
+## Sections/general
+
+-   Renamed and reworked the sections
+-   Removed Section 5 and all (or most?) UI code and moved the focus of the book purely on REST APIs instead.
+-   Consolidated on using the term `REST APIs` instead of `web APIs`, since `web APIs` can be confused with Browsers web APIs (like local storage).
+-   Refactored pararaphs into lists into **tables** to improve clarity.
+-   Refactored many section heading to improve navigation to a specific subject.
+-   Reviewed the questions and answers of many chapters; lot's of improvements.
+-   Reviewed the introduction, section conclusions, and chapter summary of multiple chapters.
+-   Lots of code formatting improvements.
+-   Removed grid background in diagrams
+
+## Chapter 2
+
+-   Major reorg of subjects.
+-   Improve the readability of the code samples.
+-   Add a section about black-, white-, and grey-box testing.
+-   Add a section about _Test case creation_, _Boundary Value Analysis_, _Decision Table Testing_, _State Transition Testing_, and _Use Case Testing_.
+
+## Chapter 3
+
+-   Reorder subjects, starting with separation of concerns, DRY, and KISS instead of SOLID. Moved SOLID after.
+-   Rewrite SOLID code samples. They are now simpler and more enterprise focused than game focused.
+-   Rewrite the covariant and contravariant explanation and sample using generics.
+-   PLANNED: Add "you aren’t gonna need it (YAGNI) principle"
+
+## Chapter 4-6
+
+-   Chapter 4: extracted REST, HTTP, DTO, and API contracts (part of section 1) + rewrite/improvements
+-   Chapter 5: new introduction to the minimal hosting model and minimal APIs (part of section 2), including deep dive into minimal APIs.
+-   Chapter 6: Merged the two MVC chapters into one (2nd ed. Chapter 4 and 5) with a focus on REST APIs.
+-   The same new, real-world oriented code example is used with both Minimal APIs (Chapter 5) and MVC (Chapter 6), allowing readers to compare the two implementations.
+
+## Chapter 7
+
+-   Minor changes improving the explanations, descriptions, and the flow.
+
+**Strategy:**
+
+-   Replaced the Strategy console app by a minimal API app.
+
+**AbstractFactory:**
+
+-   Rename HighGrade and LowGrade by HighEnd and LowEnd for more proper English. Also renamed MiddleGrade & MiddleEnd to MidRange.
+-   Simplify tests to make them easier to read. Converted the `Theory` to `Fact`.
+-   Simplified the projects and solutions structure (kept only one solution).
+-   Grouped the classes by familly instread of by "layers". The folders went from (root, models) to (root{abstractions}, HighEnd, LowEnd, MidRange).
+
+**Singleton:**
+
+-   Use the null-coalescing assignment operator `??=` instead of a `if` block.
+
+## Chapter 8
+
+-   Reordered and reworked the Dependency Injection theory section.
+-   Rewrote and improved the code sample and most of the Strategy section, including Constructor/Property/Method injection, and Guard clauses.
+-   Extracted Guard clauses into its own top-level section
+-   Updated the project Application state.
+-   Talk quickly about the new .NET 8 `TimeProvider` (wishlist project).
+-   Rewrote the factory section and updated the code to reflect the new Strategy code. (the old code could be a good blog post).
+-   Rewrote the summary to reflect the new content and added a list of Key takeaways.
+
+## Chapter 9
+
+-   Split the chapter in two.
+-   Rewrote most of the options chapter, including code samples. Made them clearer, shorter, more consise, and more "building-block-oriented".
+-   Add a code sample about the IOptionsMonitor.OnChange method.
+-   Add a code sample about centralizing the configuration and validation into the options class.
+-   Add a section about .NET 8 configuration-binding source generator
+-   Add a section about .NET 8 options validation source generator
+-   Add a section about ValidateOptionsResultBuilder
+
+## Chapter 10
+
+-   No significant changes
+
+## Chapter 11
+
+-   Rewrote the Book Store UI into an API (Composite Pattern)
+-   Removed the ultra-large bookstore diagram and simplified it
+-   Updated the bookstore data structure to reflect the API focus
+-   Renamed the corporation and bookstores, added managers, and improved locations
+
+## Chapter 12
+
+**Template method**
+
+-   Added two test cases in a new test project
+-   Corrected a bug in the code
+-   Refactor the LinearSearchMachine algo
+
+**Chain of Responsibilities**
+
+-   Improved the text by adding a few more steps to the example.
+-   Extracted "Mixing the Template Method and Chain of Responsibility patterns" to its own section.
+
+**Mixing the Template Method and Chain of Responsibility patterns**
+
+-   New section
+-   Improved flow and reworked some explanations.
+
+## Chapter 13
+
+-   Minor tweaks
+-   Added a few questions
+-   Added a life-like code sample to wrap the chapter
+
+## Chapter 14
+
+-   Minor text tweaks
+
+## Chapter 15
+
+-   Improved the headings
+-   Add an example using Mapperly
+
+## Chapter 16
+
+-   Few code tweaks, including the use of record classes instead of regular classes in the Mediator examples.
+-   Renamed the pattern CQS from CQRS; even if it was true before, it's more precise now since CQS is a subset of CQRS.
+-   Promoted the Code Smell – Marker Interfaces section to Heading 1.
+-   Updated MediatR to version 12 (from v9).
+
+## Chapter 17
+
+-   Update dependencies of the project to the latest versions (including a few breaking changes).
+-   Refactor the headings, promoting `Anti-pattern – Big Ball of Mud` and `Continuing your journey` as level 1 sections.
+-   Updated all diagrams (improved contrasts to some of them, making them more accessible).
+-   Removed the custom FluentValidation & MediatR code to make validation work as it now works out of the box. Deleted the `FluentValidationExceptionFilter` (`IExceptionFilter`) class and the `ThrowFluentValidationExceptionBehavior<TRequest, TResponse>` (`IPipelineBehavior<TRequest, TResponse>`) class. Removed the need to register the validators as `ServiceLifetime.Singleton`.
+
+## Chapter 18
+
+-   A brand new chapter about Request-EndPoint-Response (REPR) & Minimal API.
+-   Defines the pattern.
+-   Organize the code in different ways using only Minimal APIs.
+-   Explore a larger project that includes exception handling, object mapping, and grey-box testing.
+
+## Chapter 19
+
+-   Minor updates throughout the chapter.
+-   Add a BFF example that fronts the Chapter 18 REPR example and showcases API layering (low-level operation in Chapter 18 and higher-level logic/operation in Chapter 19). 30 pages
+-   Remake the Adapter section images.
+-   Add an _Advantages and potential risks_ section under CQRS.
+
+## Chapter 20
+
+-   New chapter about Modular Monolith.
+-   Takes the nano-e-commerce app from Chapter 18 and 19 and makes it a modular monolith.
+-   Adapt the code of the BFF to front the Monolith.
+-   Add in-process EDA to synchronize the two domains (cart and catalog) using MassTransit.
+
+# New Outline
+
+```
+Section 1: Principles and Methodologies
+1. Introduction
+2. Automated Testing
+3. Architectural Principles
+4. REST APIs
+
+Section 2: Designing with ASP.NET Core
+5. Minimal API
+6. Model-View-Controller
+7. Strategy, Abstract Factory, and Singleton Design Patterns
+8. Dependency Injection
+9. Application Configuration and the Options Pattern
+10. Logging patterns
+
+Section 3: Components patterns
+11. Structural Patterns
+12. Behavioral Patterns
+13. Operation Result Pattern
+
+Section 4: Applications patterns
+14. Layering and Clean Architecture
+15. Object Mappers, Aggregate Services, and Façade
+16. Mediator and CQRS Patterns
+17. Vertical Slice Architecture
+18. Request-EndPoint-Response (REPR)
+19. Introduction to Microservices Architecture
+20. Modular Monolith
+===
+**Notes about the content**
+#4: REST, HTTP, API Contracts, and the DTO pattern (were part of the MVC chapters before)
+#5: Includes an introduction to the Minimal Hosting model (consolidate the content about this and make it clearer for the readers)
+#6: MVC pattern & MVC + DTO (a stripped down version of the MVC chapters, focusing on MVC for REST APIs)
+===
+**TODO:**
+#2: add an info box about minimal hosting and the new Chapter 4 to explain readers that don't know about that, that we will talk about it there.
+```
+
+# Wave 2
+
+-   Replaced code sample in Chapter 10 (logging)
+-   Replaced code sample in Chapter 11 (facade)

_includes/buy-net5-book.html

@@ -1,4 +1,8 @@
-{%- for book in site.data.buy-books -%}
+{%- assign limit = 10 -%}
+{%- if include.limit -%}
+    {%- assign limit = include.limit -%}
+{%- endif -%}
+{%- for book in site.data.buy-books limit: limit -%}
 {%- if book.enabled -%}
 <aside class="book">
     <a

_layouts/post.html

@@ -24,7 +24,7 @@
                     {%- endif -%}
                 {%- endif -%}
                 <header class="intro-header">
-                    <div class="hidden-xs intro-header-buy-net5-book">{%- include buy-net5-book.html -%}</div>
+                    <div class="hidden-xs intro-header-buy-net5-book">{%- include buy-net5-book.html limit=1 -%}</div>
 
 
                     <div class="post-heading">
@@ -65,7 +65,7 @@ <h2 class="subheading">{{ page.subtitle }}</h2>
                         >
                         <small>({{ level.short-description }})</small>
                     </aside>
-                    {% endif %} {%- include technology-relative-level-list.html technology-relative-level=page.technology-relative-level -%}
+                    {% endif %} {%- include technology-relative-level-list.html technology-relative-level=page.technology-relative-level -%}                    
                     {% if page.tags[0] %}
                     <aside class="tags">
                         <i class="glyphicon glyphicon-tags"></i>
@@ -81,6 +81,13 @@ <h2 class="subheading">{{ page.subtitle }}</h2>
                         {%- endif -%}
                     </figure>
                     {% endif %}
+                    {% if page.ai-assisted %}
+                    <aside class="ai-assisted">
+                        <i class="fa fa-info-circle" aria-hidden="true"></i>
+                        <strong>AI-assisted content:</strong>
+                        <small>An AI assisted a human in developing portions of this article. A human refined and edited the content for accuracy and clarity.</small>
+                    </aside>
+                    {% endif %}
                 </header>
 
                 <article>