mirror of
https://github.com/tiennm99/java-design-patterns.git
synced 2026-05-15 03:01:12 +00:00
Ilkka Seppälä
4108f86177
* Changed database implementation. Removed static objects. * Fix Logs * Fix 40 errors from checkstyle plugin run. 139 left)) * Fix CacheStore errors from checkstyle plugin 107 left * Fix last errors in checkstyle. * Fix sonar issues * Fix issues in VALIDATE phase * Fix Bug with mongo connection. Used "Try with resources" * Add test * Added docker-compose for mongo db. MongoDb db work fixed. * Provided missing tests * Comments to start Application with mongo. * Fix some broken links * Remove extra space * Update filename * Fix some links in localization folders * Fix link * Update frontmatters * Work on patterns index page * Work on index page * Fixes according PR comments. Mainly Readme edits. * fix frontmatter * add missing png * Update pattern index.md * Add index.md for Chinese translation * update image paths * update circuit breaker image paths * Update image paths for localizations * add generated puml * Add missing image * Update img file extensions * Update the rest of the EN and ZH patterns to conform with the new website Co-authored-by: Victor Zalevskii <zvictormail@gmail.com>
95 lines
3.5 KiB
Markdown
95 lines
3.5 KiB
Markdown
---
|
|
title: Singleton
|
|
category: Creational
|
|
language: en
|
|
tags:
|
|
- Gang of Four
|
|
---
|
|
|
|
## Intent
|
|
|
|
Ensure a class only has one instance, and provide a global point of access to it.
|
|
|
|
## 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. The ivory tower here is a 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
|
|
|
|
```java
|
|
public enum EnumIvoryTower {
|
|
INSTANCE
|
|
}
|
|
```
|
|
|
|
Then in order to use:
|
|
|
|
```java
|
|
var enumIvoryTower1 = EnumIvoryTower.INSTANCE;
|
|
var enumIvoryTower2 = EnumIvoryTower.INSTANCE;
|
|
LOGGER.info("enumIvoryTower1={}", enumIvoryTower1);
|
|
LOGGER.info("enumIvoryTower2={}", enumIvoryTower2);
|
|
```
|
|
|
|
The console output
|
|
|
|
```
|
|
enumIvoryTower1=com.iluwatar.singleton.EnumIvoryTower@1221555852
|
|
enumIvoryTower2=com.iluwatar.singleton.EnumIvoryTower@1221555852
|
|
```
|
|
|
|
## Class diagram
|
|
|
|
|
|
|
|
## Applicability
|
|
|
|
Use the Singleton pattern when
|
|
|
|
* There must be exactly one instance of a class, and it must be accessible to clients from a well-known access point
|
|
* When the sole instance should be extensible by subclassing, and clients should be able to use an extended instance without modifying their code
|
|
|
|
Some typical use cases for the Singleton
|
|
|
|
* The logging class
|
|
* Managing a connection to a database
|
|
* File manager
|
|
|
|
## Known uses
|
|
|
|
* [java.lang.Runtime#getRuntime()](http://docs.oracle.com/javase/8/docs/api/java/lang/Runtime.html#getRuntime%28%29)
|
|
* [java.awt.Desktop#getDesktop()](http://docs.oracle.com/javase/8/docs/api/java/awt/Desktop.html#getDesktop--)
|
|
* [java.lang.System#getSecurityManager()](http://docs.oracle.com/javase/8/docs/api/java/lang/System.html#getSecurityManager--)
|
|
|
|
|
|
## Consequences
|
|
|
|
* Violates Single Responsibility Principle (SRP) by controlling their creation and lifecycle.
|
|
* Encourages using a globally shared instance which prevents an object and resources used by this object from being deallocated.
|
|
* Creates tightly coupled code. The clients of the Singleton become difficult to test.
|
|
* Makes it almost impossible to subclass a Singleton.
|
|
|
|
## Credits
|
|
|
|
* [Design Patterns: Elements of Reusable Object-Oriented Software](https://www.amazon.com/gp/product/0201633612/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0201633612&linkCode=as2&tag=javadesignpat-20&linkId=675d49790ce11db99d90bde47f1aeb59)
|
|
* [Effective Java](https://www.amazon.com/gp/product/0134685997/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0134685997&linkCode=as2&tag=javadesignpat-20&linkId=4e349f4b3ff8c50123f8147c828e53eb)
|
|
* [Head First Design Patterns: A Brain-Friendly Guide](https://www.amazon.com/gp/product/0596007124/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0596007124&linkCode=as2&tag=javadesignpat-20&linkId=6b8b6eea86021af6c8e3cd3fc382cb5b)
|
|
* [Refactoring to Patterns](https://www.amazon.com/gp/product/0321213351/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=0321213351&linkCode=as2&tag=javadesignpat-20&linkId=2a76fcb387234bc71b1c61150b3cc3a7)
|