From 95bfd6cb4d25cfad27cbac2d1db29d2009efcb7d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Sat, 12 Apr 2025 09:17:38 +0300 Subject: [PATCH] docs: new diagrams for template view and throttling --- templateview/README.md | 10 +++++++--- templateview/etc/template-view-flowchart.png | Bin 0 -> 63948 bytes throttling/README.md | 4 ++++ throttling/etc/throttling-flowchart.png | Bin 0 -> 43296 bytes 4 files changed, 11 insertions(+), 3 deletions(-) create mode 100644 templateview/etc/template-view-flowchart.png create mode 100644 throttling/etc/throttling-flowchart.png diff --git a/templateview/README.md b/templateview/README.md index 3a53447c2..6708fa227 100644 --- a/templateview/README.md +++ b/templateview/README.md @@ -21,18 +21,22 @@ Separate the structure and static parts of a webpage (or view) from its dynamic ## Detailed Explanation of Template View Pattern with Real-World Examples -### Real-World Example +Real-World Example > Think of a blog website where each post page follows the same layout with a header, footer, and main content area. While the header and footer remain consistent, the main content differs for each blog post. The Template View pattern encapsulates the shared layout (header and footer) in a base class while delegating the rendering of the main content to subclasses. -### In Plain Words +In Plain Words > The Template View pattern provides a way to define a consistent layout in a base class while letting subclasses implement the specific, dynamic content for different views. -### Wikipedia Says +Wikipedia Says > While not a classic Gang of Four pattern, Template View aligns closely with the Template Method pattern, applied specifically to rendering webpages or views. It defines a skeleton for rendering, delegating dynamic parts to subclasses while keeping the structure consistent. +Flowchart + +![Template View Pattern Flowchart](./etc/template-view-flowchart.png) + ## Programmatic Example of Template View Pattern in Java Our example involves rendering different types of views (`HomePageView` and `ContactPageView`) with a common structure consisting of a header, dynamic content, and a footer. diff --git a/templateview/etc/template-view-flowchart.png b/templateview/etc/template-view-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..0887ac8bce4e2fde5e30ae8a5a7d2e2889f3ff73 GIT binary patch literal 63948 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 literal 0 HcmV?d00001 diff --git a/throttling/README.md b/throttling/README.md index d35c346de..ab5f92fbe 100644 --- a/throttling/README.md +++ b/throttling/README.md @@ -34,6 +34,10 @@ In plain words > Control the consumption of resources used by an instance of an application, an individual tenant, or an entire service. This can allow the system to continue to function and meet service level agreements, even when an increase in demand places an extreme load on resources. +Flowchart + +![Throttling Pattern Flowchart](./etc/throttling-flowchart.png) + ## Programmatic Example of Throttling Pattern in Java In this Java example, we demonstrate throttling. A young human and an old dwarf walk into a bar. They start ordering beers from the bartender. The bartender immediately sees that the young human shouldn't consume too many drinks too fast and refuses to serve if enough time has not passed. For the old dwarf, the serving rate can be higher. diff --git a/throttling/etc/throttling-flowchart.png b/throttling/etc/throttling-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..0c7d6cc329b0c50ebb7c2eca69a5babe16631504 GIT binary patch literal 43296 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