Skip to content

Commit

Permalink
#590 Add new presentation for Singleton
Browse files Browse the repository at this point in the history
  • Loading branch information
iluwatar committed Aug 12, 2017
1 parent 600553e commit 746e452
Show file tree
Hide file tree
Showing 5 changed files with 27 additions and 149 deletions.
29 changes: 27 additions & 2 deletions singleton/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,32 @@ tags:
Ensure a class only has one instance, and provide a global point of
access to it.

![alt text](./etc/singleton_1.png "Singleton")

## Explanation
Real world example
> There can only be one ivory tower where the wizards study their magic. The same enchanted ivory tower is always used by the wizards. Ivory tower here is singleton.
In plain words
> Ensures that only one object of a particular class is ever created.
Wikipedia says
> In software engineering, the singleton pattern is a software design pattern that restricts the instantiation of a class to one object. This is useful when exactly one object is needed to coordinate actions across the system.
**Programmatic Example**

Joshua Bloch, Effective Java 2nd Edition p.18
> A single-element enum type is the best way to implement a singleton
```
public enum EnumIvoryTower {
INSTANCE;
}
```
Then in order to use
```
EnumIvoryTower enumIvoryTower1 = EnumIvoryTower.INSTANCE;
EnumIvoryTower enumIvoryTower2 = EnumIvoryTower.INSTANCE;
assertEquals(enumIvoryTower1, enumIvoryTower2); // true
```

## Applicability
Use the Singleton pattern when
Expand All @@ -40,7 +65,7 @@ Use the Singleton pattern when

* Violates Single Responsibility Principle (SRP) by controlling their own creation and lifecycle.
* Encourages using a global shared instance which prevents an object and resources used by this object from being deallocated.
* Creates tightly coupled code that is difficult to test.
* Creates tightly coupled code. The clients of the Singleton become difficult to test.
* Makes it almost impossible to subclass a Singleton.

## Credits
Expand Down
Binary file removed singleton/etc/singleton.png
Binary file not shown.
104 changes: 0 additions & 104 deletions singleton/etc/singleton.ucls

This file was deleted.

43 changes: 0 additions & 43 deletions singleton/etc/singleton.urm.puml

This file was deleted.

Binary file removed singleton/etc/singleton_1.png
Binary file not shown.

0 comments on commit 746e452

Please sign in to comment.