From 7ed9e393f090d72fc498e924262d4c17883a92f3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Wed, 9 Apr 2025 21:30:44 +0300 Subject: [PATCH] docs: null object diagram --- null-object/README.md | 4 ++++ .../etc/null-object-sequence-diagram.png | Bin 0 -> 39826 bytes 2 files changed, 4 insertions(+) create mode 100644 null-object/etc/null-object-sequence-diagram.png diff --git a/null-object/README.md b/null-object/README.md index 75da7452a..00799a1a3 100644 --- a/null-object/README.md +++ b/null-object/README.md @@ -35,6 +35,10 @@ Wikipedia says > In object-oriented computer programming, a null object is an object with no referenced value or with defined neutral ("null") behavior. The null object design pattern describes the uses of such objects and their behavior (or lack thereof). +Sequence diagram + +![Null Object sequence diagram](./etc/null-object-sequence-diagram.png) + ## Programmatic Example of Null Object in Java By implementing the Null Object Pattern, Java developers can ensure that their applications handle 'empty' objects more gracefully, enhancing code stability and readability. diff --git a/null-object/etc/null-object-sequence-diagram.png b/null-object/etc/null-object-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..bfeda450aa0c756fdd182d590fa9a28822515e0f GIT binary patch literal 39826 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 Hr-UW|g1sgu literal 0 HcmV?d00001