From 139bb6d1c5038927ceed53d08f15eb12915970f4 Mon Sep 17 00:00:00 2001
From: adesai <adesai@cloudera.com>
Date: Sun, 1 Oct 2023 10:38:37 +0530
Subject: [PATCH] Adding lazy initialisation pattern

---
 README.md                         |  1 +
 creational/lazy-initialisation.md | 69 +++++++++++++++++++++++++++++++
 2 files changed, 70 insertions(+)
 create mode 100644 creational/lazy-initialisation.md

diff --git a/README.md b/README.md
index 7d9f5f7..57802fe 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,7 @@ A curated collection of idiomatic design & application patterns for Go language.
 | [Factory Method](/creational/factory.md) | Defers instantiation of an object to a specialized function for creating instances | ✔ |
 | [Object Pool](/creational/object-pool.md) | Instantiates and maintains a group of objects instances of the same type | ✔ |
 | [Singleton](/creational/singleton.md) | Restricts instantiation of a type to one object | ✔ |
+| [Lazy Initialisation](/creational/lazy-initialisation.md) | Defer creation of object until actually needed | ✔ |
 
 ## Structural Patterns
 
diff --git a/creational/lazy-initialisation.md b/creational/lazy-initialisation.md
new file mode 100644
index 0000000..785194e
--- /dev/null
+++ b/creational/lazy-initialisation.md
@@ -0,0 +1,69 @@
+# Lazy Initialisation Pattern
+
+While not a traditional design pattern, lazy initialization is a common technique in Go. It involves deferring the creation of an object until it is actually needed. You can use this technique to optimize resource usage.
+
+## Implementation
+
+```go
+package main
+
+import (
+	"fmt"
+	"sync"
+)
+
+// LazyInitializer represents a generic lazy initializer for any type.
+type LazyInitializer struct {
+	mu       sync.Mutex
+	instance interface{}
+	initialized bool
+}
+
+// NewLazyInitializer creates a new LazyInitializer.
+func NewLazyInitializer() *LazyInitializer {
+	return &LazyInitializer{}
+}
+
+// GetInstance returns the instance, creating it lazily if necessary.
+func (li *LazyInitializer) GetInstance(factory func() interface{}) interface{} {
+	li.mu.Lock()
+	defer li.mu.Unlock()
+
+	if !li.initialized {
+		li.instance = factory()
+		li.initialized = true
+	}
+	return li.instance
+}
+```
+
+## Usage
+
+Given below is an example usage for lazy initialisation.
+
+```go
+	// Create a LazyInitializer instance.
+	initializer := NewLazyInitializer()
+
+	// Access the resource, which will be created lazily.
+	resource1 := initializer.GetInstance(func() interface{} {
+		fmt.Println("Creating a resource...")
+		return "Resource 1"
+	})
+	fmt.Println("Resource 1:", resource1)
+
+	// Access the resource again, which should reuse the existing one.
+	resource2 := initializer.GetInstance(func() interface{} {
+		fmt.Println("Creating a resource...")
+		return "Resource 2"
+	})
+	fmt.Println("Resource 2:", resource2)
+
+	// The resource is created only once, and subsequent accesses reuse it.
+```
+
+## Rules of Thumb
+
+- The lazy initialization design pattern is used when you want to defer the creation of an object or resource until it's actually needed, rather than creating it immediately.
+- It's important to note that while lazy initialization can be a useful optimization technique, it should be used judiciously.
+-  In some cases, it might introduce additional complexity or latency if used excessively.