Refactoring 018 – Replace Singleton

Breaking Free from the Evil Singleton

TL;DR: Refactor singletons to reduce coupling

Problems Addressed

High coupling

Difficult testability

Multi-threading issues

Related Code Smells


This content originally appeared on DEV Community and was authored by Maxi Contieri

Breaking Free from the Evil Singleton

TL;DR: Refactor singletons to reduce coupling

Problems Addressed

Related Code Smells

Steps

  1. Identify the singleton
  2. Locate all references to its getInstance() method
  3. Refactor the singleton to a standard class
  4. Inject it as a dependency

Sample Code

Before

public class DatabaseConnection {
    private static DatabaseConnection instance;

    private DatabaseConnection() {}

    public static DatabaseConnection getInstance() {
        if (instance == null) {
            instance = new DatabaseConnection();
        }
        return instance;
    }

    public void connect() { 
    }
}

public class Service {
    public void performTask() {
        DatabaseConnection connection = DatabaseConnection.getInstance();
        connection.connect(); 
    }
}

After

public class DatabaseConnection {  
    // 1. Identify the singleton 
    public void connect() { 
    }
}

public class Service {
    // 2. Locate all references to its getInstance() method.
    private DatabaseConnection connection;

    // 3. Refactor the singleton to a standard class. 
    public Service(DatabaseConnection connection) {
        // 4. Inject it as a dependency.
        this.connection = connection;
    }

    public void performTask() {
        connection.connect(); 
    }
}

DatabaseConnection connection = new DatabaseConnection();
// You can also mock the connection in your tests

Service service = new Service(connection);
service.performTask();

Type

[X] Semi-Automatic

Safety

This refactoring is safe when you update all references to the singleton and handle its dependencies correctly.

Testing each step ensures that no references to the singleton are missed.

Why the code is better?

Refactoring away from a singleton makes the code more modular, testable, and less prone to issues caused by the global state.

Injecting dependencies allows you to easily replace DatabaseConnection with a mock or different implementation in testing and other contexts.

Tags

  • Coupling

Related Refactorings

See also

Credits

Image by PublicDomainPictures from Pixabay

This article is part of the Refactoring Series.


This content originally appeared on DEV Community and was authored by Maxi Contieri


Print Share Comment Cite Upload Translate Updates
APA

Maxi Contieri | Sciencx (2024-11-05T23:19:50+00:00) Refactoring 018 – Replace Singleton. Retrieved from https://www.scien.cx/2024/11/05/refactoring-018-replace-singleton/

MLA
" » Refactoring 018 – Replace Singleton." Maxi Contieri | Sciencx - Tuesday November 5, 2024, https://www.scien.cx/2024/11/05/refactoring-018-replace-singleton/
HARVARD
Maxi Contieri | Sciencx Tuesday November 5, 2024 » Refactoring 018 – Replace Singleton., viewed ,<https://www.scien.cx/2024/11/05/refactoring-018-replace-singleton/>
VANCOUVER
Maxi Contieri | Sciencx - » Refactoring 018 – Replace Singleton. [Internet]. [Accessed ]. Available from: https://www.scien.cx/2024/11/05/refactoring-018-replace-singleton/
CHICAGO
" » Refactoring 018 – Replace Singleton." Maxi Contieri | Sciencx - Accessed . https://www.scien.cx/2024/11/05/refactoring-018-replace-singleton/
IEEE
" » Refactoring 018 – Replace Singleton." Maxi Contieri | Sciencx [Online]. Available: https://www.scien.cx/2024/11/05/refactoring-018-replace-singleton/. [Accessed: ]
rf:citation
» Refactoring 018 – Replace Singleton | Maxi Contieri | Sciencx | https://www.scien.cx/2024/11/05/refactoring-018-replace-singleton/ |

Please log in to upload a file.




There are no updates yet.
Click the Upload button above to add an update.

You must be logged in to translate posts. Please log in or register.