Implementation:Apache Shardingsphere ResourceSwitchManager Switch

Knowledge Sources	Apache_Shardingsphere
Domains	Mode_Management, Data_Source
Last Updated	2026-02-10 00:00 GMT

Overview

Utility class that creates resource switching transitions for registering, altering, and unregistering storage units.

Description

ResourceSwitchManager provides static-like utility methods for building SwitchingResource objects from storage unit operations. Each method takes the current database context and the desired changes, then produces a SwitchingResource containing the new data source map, stale data sources to close, and updated storage unit properties.

Usage

Called by StorageUnitManager when processing storage unit registration, alteration, or unregistration requests.

Code Reference

Source Location

• Repository: Apache_Shardingsphere
• File: ResourceSwitchManager.java
• Lines: 1-167

Signature

@NoArgsConstructor(access = AccessLevel.PRIVATE)
public final class ResourceSwitchManager {

    public static SwitchingResource registerStorageUnit(ResourceMetaData resourceMetaData,
        Map<String, DataSourcePoolProperties> toBeRegistered);

    public static SwitchingResource alterStorageUnit(ResourceMetaData resourceMetaData,
        Map<String, DataSourcePoolProperties> toBeAltered);

    public static SwitchingResource unregisterStorageUnit(ResourceMetaData resourceMetaData,
        Collection<String> toBeDropped);
}

Import

import org.apache.shardingsphere.mode.metadata.manager.resource.ResourceSwitchManager;

I/O Contract

Inputs

Name	Type	Required	Description
resourceMetaData	ResourceMetaData	Yes	Current resource metadata state
toBeRegistered/toBeAltered	Map<String, DataSourcePoolProperties>	Varies	Storage units to register or alter
toBeDropped	Collection<String>	Varies	Storage unit names to unregister

Outputs

Name	Type	Description
returns	SwitchingResource	Contains new data sources, stale data sources, and updated properties

Usage Examples

// Register new storage units
SwitchingResource switching = ResourceSwitchManager.registerStorageUnit(
    database.getResourceMetaData(), newStorageUnits);

// Apply the switching result
database.switchResource(switching);

Related Pages

• Principle:Apache_Shardingsphere_Configuration_Change_Initiation