How apache/dubbo works
Apache Dubbo is a Java RPC and web framework for building microservices. A typical consumer invokes a service through an RPC protocol; provider instances are discovered from registries, and cluster routing and load balancing select traffic targets. The repository also includes provider-side service APIs, metadata, REST/OpenAPI, and observability and security capabilities. The README documents these broad relationships; sampled source is limited, so detailed runtime wiring—especially registry updates and optional integrations—is not asserted here.
Main entry points: AbstractClusterInvoker.java Cluster invocation · TriBuiltinService.java RPC protocols · ServerService.java Service provider · ServiceDiscoveryService.java Service discovery
Components 19
RPC services
- Service API
dubbo-common/src/main/java/org/apache/dubbo/config/annotation/DubboService.java - RPC protocols
dubbo-rpc/dubbo-rpc-triple/src/main/java/org/apache/dubbo/rpc/protocol/tri/service/TriBuiltinService.java - Service provider
dubbo-rpc/dubbo-rpc-api/src/main/java/org/apache/dubbo/rpc/ServerService.java
Discovery and cluster
- Service registry
dubbo-registry/dubbo-registry-api/src/main/java/org/apache/dubbo/registry/RegistryService.java - Service discovery
dubbo-registry/dubbo-registry-api/src/main/java/org/apache/dubbo/registry/client/ServiceDiscoveryService.java - Cluster invocation
dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/support/AbstractClusterInvoker.java - Provider directory
dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/directory/AbstractDirectory.java
Traffic management
- Router chain
dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/RouterChain.java - Mesh routing
dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/router/mesh/route/MeshRuleRouter.java - Load balancing
dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/loadbalance/AdaptiveLoadBalance.java - Failure strategies
dubbo-cluster/src/main/java/org/apache/dubbo/rpc/cluster/support/FailoverClusterInvoker.java
Platform capabilities
- Service metadata
dubbo-metadata/dubbo-metadata-api/src/main/java/org/apache/dubbo/metadata/MetadataService.java - Metrics collection
dubbo-metrics/dubbo-metrics-default/src/main/java/org/apache/dubbo/metrics/service/DefaultMetricsService.java - Monitoring API
dubbo-metrics/dubbo-metrics-api/src/main/java/org/apache/dubbo/monitor/MonitorService.java - Access-key storage
dubbo-plugin/dubbo-auth/src/main/java/org/apache/dubbo/auth/DefaultAccessKeyStorage.java
Web and extensibility
- REST OpenAPI
dubbo-plugin/dubbo-rest-openapi/src/main/java/org/apache/dubbo/rpc/protocol/tri/rest/openapi/DefaultOpenAPIService.java - MCP services
dubbo-plugin/dubbo-mcp/src/main/java/org/apache/dubbo/mcp/core/McpSseService.java
Other components
- RPC consumer
- Registry service
Connections 16
- RPC consumer → RPC protocols: invokes via
- Service API → Service provider: defines service
- RPC protocols → Service provider: communicates with
- RPC consumer → Service discovery: discovers instances
- Service discovery → Registry service: queries
- Service registry → Registry service: registers services
- Cluster invocation → Provider directory: selects providers
- Cluster invocation → Router chain: routes traffic
- Cluster invocation → Load balancing: selects target
- Cluster invocation → Failure strategies: handles failures
- Router chain → Mesh routing: supports mesh rules
- Service metadata → Service provider: describes services
- Metrics collection → Monitoring API: exposes metrics
- RPC consumer → Access-key storage: uses credentials
- RPC protocols → REST OpenAPI: supports REST APIs
- RPC protocols → MCP services: offers MCP services