How alibaba/spring-cloud-alibaba works
Spring Cloud Alibaba is a collection of Spring Cloud integrations for distributed application development. The principal documented workflow is to configure a Spring application with Alibaba components, then use their Spring-managed capabilities for discovery, configuration, traffic governance, messaging, transactions, and scheduling. The graph also includes the sampled storage-service example as a concrete request-to-result flow. Several feature nodes are documented capabilities whose implementation was not sampled; their paths identify existing source directories, and their internal wiring is not inferred.
Main entry points: NacosConfigManager.java Config client · NacosServiceManager.java Naming client manager · StorageController.java Storage API · JobSyncService.java Scheduled jobs
Components 25
Configuration
- Nacos settings
spring-cloud-alibaba-starters/spring-alibaba-nacos-config/src/main/java/com/alibaba/cloud/nacos/NacosConfigProperties.java - Config client
spring-cloud-alibaba-starters/spring-alibaba-nacos-config/src/main/java/com/alibaba/cloud/nacos/NacosConfigManager.java - Nacos config
- Config parser
spring-cloud-alibaba-starters/spring-alibaba-nacos-config/src/main/java/com/alibaba/cloud/nacos/parser/NacosDataParserHandler.java - Config resource
spring-cloud-alibaba-starters/spring-alibaba-nacos-config/src/main/java/com/alibaba/cloud/nacos/parser/NacosByteArrayResource.java
Discovery
- Discovery settings
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-nacos-discovery/src/main/java/com/alibaba/cloud/nacos/NacosDiscoveryProperties.java - Naming client manager
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-nacos-discovery/src/main/java/com/alibaba/cloud/nacos/NacosServiceManager.java - Nacos naming
- Sidecar discovery
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-sidecar/src/main/java/com/alibaba/cloud/sidecar/SidecarDiscoveryClient.java
Governance
- Sentinel rule sources
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-sentinel/src/main/java/com/alibaba/cloud/sentinel/custom/SentinelDataSourceHandler.java - Rule converters
spring-cloud-alibaba-starters/spring-cloud-alibaba-sentinel-datasource/src/main/java/com/alibaba/cloud/sentinel/datasource/converter/SentinelConverter.java - Sentinel governance
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-sentinel/src/main/java/com/alibaba/cloud/sentinel - Circuit breaking
spring-cloud-alibaba-starters/spring-cloud-circuitbreaker-sentinel/src/main/java/com/alibaba/cloud/circuitbreaker/sentinel
Application integrations
- Storage API
spring-cloud-alibaba-examples/integrated-example/integrated-storage/src/main/java/com/alibaba/cloud/integration/storage/controller/StorageController.java - Stock operations
spring-cloud-alibaba-examples/integrated-example/integrated-storage/src/main/java/com/alibaba/cloud/integration/storage/service/StorageService.java - Stock persistence
spring-cloud-alibaba-examples/integrated-example/integrated-storage/src/main/java/com/alibaba/cloud/integration/storage/mapper/StorageMapper.java - API result
spring-cloud-alibaba-examples/integrated-example/integrated-common/src/main/java/com/alibaba/cloud/integration/common/Result.java - RocketMQ producer
spring-cloud-alibaba-starters/spring-cloud-starter-stream-rocketmq/src/main/java/com/alibaba/cloud/stream/binder/rocketmq/integration/outbound/RocketMQProducerMessageHandler.java - RocketMQ broker
- Distributed transactions
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-seata/src/main/java/com/alibaba/cloud/seata - Scheduled jobs
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-schedulerx/src/main/java/com/alibaba/cloud/scheduling/schedulerx/service/JobSyncService.java - Cron parser
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-schedulerx/src/main/java/com/alibaba/cloud/scheduling/schedulerx/util/CronExpression.java - SchedulerX service
Other components
- Spring application
- API caller
Connections 23
- Spring application → Config client: uses config
- Config client → Nacos settings: reads settings
spring-cloud-alibaba-starters/spring-alibaba-nacos-config/src/main/java/com/alibaba/cloud/nacos/NacosConfigManager.java - Config client → Nacos config: creates client
spring-cloud-alibaba-starters/spring-alibaba-nacos-config/src/main/java/com/alibaba/cloud/nacos/NacosConfigManager.java - Spring application → Config parser: loads config
- Config parser → Config resource: builds resource
spring-cloud-alibaba-starters/spring-alibaba-nacos-config/src/main/java/com/alibaba/cloud/nacos/parser/NacosDataParserHandler.java - Spring application → Naming client manager: uses discovery
- Naming client manager → Discovery settings: reads settings
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-nacos-discovery/src/main/java/com/alibaba/cloud/nacos/NacosServiceManager.java - Naming client manager → Nacos naming: creates client
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-nacos-discovery/src/main/java/com/alibaba/cloud/nacos/NacosServiceManager.java - Spring application → Sidecar discovery: uses discovery
- Spring application → Sentinel rule sources: configures rules
- Sentinel rule sources → Rule converters: configures converters
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-sentinel/src/main/java/com/alibaba/cloud/sentinel/custom/SentinelDataSourceHandler.java - Spring application → Sentinel governance: uses governance
- Spring application → Circuit breaking: uses circuit breaking
- API caller → Storage API: requests stock
spring-cloud-alibaba-examples/integrated-example/integrated-storage/src/main/java/com/alibaba/cloud/integration/storage/controller/StorageController.java - Storage API → Stock operations: calls operations
spring-cloud-alibaba-examples/integrated-example/integrated-storage/src/main/java/com/alibaba/cloud/integration/storage/controller/StorageController.java - Storage API → API result: returns result
spring-cloud-alibaba-examples/integrated-example/integrated-storage/src/main/java/com/alibaba/cloud/integration/storage/controller/StorageController.java - Stock operations → Stock persistence: persists stock
- Spring application → RocketMQ producer: sends messages
- RocketMQ producer → RocketMQ broker: publishes messages
spring-cloud-alibaba-starters/spring-cloud-starter-stream-rocketmq/src/main/java/com/alibaba/cloud/stream/binder/rocketmq/integration/outbound/RocketMQProducerMessageHandler.java - Spring application → Distributed transactions: uses transactions
- Spring application → Scheduled jobs: schedules jobs
- Scheduled jobs → Cron parser: parses schedules
spring-cloud-alibaba-starters/spring-cloud-starter-alibaba-schedulerx/src/main/java/com/alibaba/cloud/scheduling/schedulerx/service/JobSyncService.java - Scheduled jobs → SchedulerX service: manages jobs