# jasun0925/dubbox architecture

> Architecture diagram of the GitHub repository jasun0925/dubbox, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jasun0925/dubbox
- Repository: https://github.com/jasun0925/dubbox

## Overview

Dubbox extends Dubbo with REST-style HTTP remoting and additional serialization/configuration options. In the principal workflow, a provider is configured and exposed, consumers discover and invoke it through the RPC/cluster stack, and registry and monitoring services support governance and observation. The repository also includes a Dubbo Admin console for service and configuration management. Several documented extensions are not represented by sampled implementation files, so those links are documented rather than source-verified.

Main entry points: [`dubbo-config/dubbo-config-api/src/main/java/com/alibaba/dubbo/config/ServiceConfig.java`](https://github.com/jasun0925/dubbox/blob/master/dubbo-config/dubbo-config-api/src/main/java/com/alibaba/dubbo/config/ServiceConfig.java) (Service Export), [`dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/support/AbstractClusterInvoker.java`](https://github.com/jasun0925/dubbox/blob/master/dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/support/AbstractClusterInvoker.java) (Cluster Invoker), [`dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/RegistryService.java`](https://github.com/jasun0925/dubbox/blob/master/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/RegistryService.java) (Registry Contract), [`dubbo-config/dubbo-config-spring/src/main/java/com/alibaba/dubbo/config/spring/ServiceBean.java`](https://github.com/jasun0925/dubbox/blob/master/dubbo-config/dubbo-config-spring/src/main/java/com/alibaba/dubbo/config/spring/ServiceBean.java) (Spring Service Config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Service Configuration"]
  node_spring_config["Spring Service Config<br/>[ServiceBean.java]"]
  node_service_config["Service Export<br/>[ServiceConfig.java]"]
  node_java_config["Annotation Config<br/>[Service.java]"]
end

subgraph group_invocation["RPC Invocation"]
  node_proxy["RPC Proxy"]
  node_cluster["Cluster Invoker"]
  node_directory["Provider Directory"]
  node_loadbalance["Load Balancing"]
  node_remoting["Remoting Transport<br/>[Server.java]"]
end

subgraph group_infrastructure["Registry And Monitoring"]
  node_registry_api["Registry Contract"]
  node_simple_registry["Simple Registry"]
  node_monitor_api["Monitor Contract"]
  node_simple_monitor["Simple Monitor"]
end

subgraph group_governance["Admin Governance"]
  node_admin_ui["Admin Screens<br/>[Services.java]"]
  node_admin_services["Governance Services"]
  node_admin_sync["Registry Sync"]
end

subgraph group_extensions["Dubbox Extensions"]
  node_http_remoting["HTTP Remoting"]
  node_rest["REST Remoting"]
  node_serialization["Serialization Options"]
  node_webservice["Web Services"]
end

node_provider(("Service Provider"))
node_consumer(("Service Consumer"))

node_provider -->|"configures"| node_spring_config
node_spring_config -->|"delegates to"| node_service_config
node_java_config -.->|"configures"| node_service_config
node_service_config -.->|"registers service"| node_registry_api
node_consumer -.->|"invokes"| node_proxy
node_proxy -.->|"dispatches"| node_cluster
node_cluster -.->|"selects providers"| node_directory
node_cluster -.->|"balances calls"| node_loadbalance
node_cluster -.->|"sends RPC"| node_remoting
node_remoting -.->|"discovers services"| node_registry_api
node_service_config -.->|"reports usage"| node_monitor_api
node_registry_api -->|"implemented by"| node_simple_registry
node_monitor_api -->|"implemented by"| node_simple_monitor
node_admin_ui -.->|"requests governance"| node_admin_services
node_admin_services -->|"uses registry sync"| node_admin_sync
node_admin_sync -->|"uses registry"| node_registry_api
node_service_config -.->|"supports REST"| node_rest
node_service_config -.->|"supports serializers"| node_serialization
node_http_remoting -.->|"provides HTTP transport"| node_rest
node_service_config -.->|"supports protocols"| node_webservice

click node_spring_config "https://github.com/jasun0925/dubbox/blob/master/dubbo-config/dubbo-config-spring/src/main/java/com/alibaba/dubbo/config/spring/ServiceBean.java"
click node_service_config "https://github.com/jasun0925/dubbox/blob/master/dubbo-config/dubbo-config-api/src/main/java/com/alibaba/dubbo/config/ServiceConfig.java"
click node_java_config "https://github.com/jasun0925/dubbox/blob/master/dubbo-config/dubbo-config-api/src/main/java/com/alibaba/dubbo/config/annotation/Service.java"
click node_proxy "https://github.com/jasun0925/dubbox/blob/master/dubbo-rpc/dubbo-rpc-api/src/main/java/com/alibaba/dubbo/rpc/proxy/InvokerInvocationHandler.java"
click node_cluster "https://github.com/jasun0925/dubbox/blob/master/dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/support/AbstractClusterInvoker.java"
click node_directory "https://github.com/jasun0925/dubbox/blob/master/dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/directory/AbstractDirectory.java"
click node_loadbalance "https://github.com/jasun0925/dubbox/blob/master/dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/loadbalance/RandomLoadBalance.java"
click node_remoting "https://github.com/jasun0925/dubbox/blob/master/dubbo-remoting/dubbo-remoting-api/src/main/java/com/alibaba/dubbo/remoting/Server.java"
click node_http_remoting "https://github.com/jasun0925/dubbox/blob/master/dubbo-remoting/dubbo-remoting-http/src/main/java/com/alibaba/dubbo/remoting/http/servlet/ServletManager.java"
click node_registry_api "https://github.com/jasun0925/dubbox/blob/master/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/RegistryService.java"
click node_simple_registry "https://github.com/jasun0925/dubbox/blob/master/dubbo-simple/dubbo-registry-simple/src/main/java/com/alibaba/dubbo/registry/simple/SimpleRegistryService.java"
click node_monitor_api "https://github.com/jasun0925/dubbox/blob/master/dubbo-monitor/dubbo-monitor-api/src/main/java/com/alibaba/dubbo/monitor/MonitorService.java"
click node_simple_monitor "https://github.com/jasun0925/dubbox/blob/master/dubbo-simple/dubbo-monitor-simple/src/main/java/com/alibaba/dubbo/monitor/simple/SimpleMonitorService.java"
click node_admin_ui "https://github.com/jasun0925/dubbox/blob/master/dubbo-admin/src/main/java/com/alibaba/dubbo/governance/web/governance/module/screen/Services.java"
click node_admin_services "https://github.com/jasun0925/dubbox/blob/master/dubbo-admin/src/main/java/com/alibaba/dubbo/governance/service/impl/AbstractService.java"
click node_admin_sync "https://github.com/jasun0925/dubbox/blob/master/dubbo-admin/src/main/java/com/alibaba/dubbo/governance/sync/RegistryServerSync.java"
click node_webservice "https://github.com/jasun0925/dubbox/blob/master/dubbo-rpc/dubbo-rpc-webservice/src/main/java/com/alibaba/dubbo/rpc/protocol/webservice/WebServiceProtocol.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_spring_config,node_service_config,node_java_config toneBlue
class node_proxy,node_cluster,node_directory,node_loadbalance,node_remoting toneAmber
class node_registry_api,node_simple_registry,node_monitor_api,node_simple_monitor toneMint
class node_admin_ui,node_admin_services,node_admin_sync toneRose
class node_http_remoting,node_rest,node_serialization,node_webservice,node_provider,node_consumer toneIndigo
```

## Components

### Service Configuration

- [Spring Service Config](https://github.com/jasun0925/dubbox/blob/master/dubbo-config/dubbo-config-spring/src/main/java/com/alibaba/dubbo/config/spring/ServiceBean.java): `dubbo-config/dubbo-config-spring/src/main/java/com/alibaba/dubbo/config/spring/ServiceBean.java`
- [Service Export](https://github.com/jasun0925/dubbox/blob/master/dubbo-config/dubbo-config-api/src/main/java/com/alibaba/dubbo/config/ServiceConfig.java): `dubbo-config/dubbo-config-api/src/main/java/com/alibaba/dubbo/config/ServiceConfig.java`
- [Annotation Config](https://github.com/jasun0925/dubbox/blob/master/dubbo-config/dubbo-config-api/src/main/java/com/alibaba/dubbo/config/annotation/Service.java): `dubbo-config/dubbo-config-api/src/main/java/com/alibaba/dubbo/config/annotation/Service.java`

### RPC Invocation

- [RPC Proxy](https://github.com/jasun0925/dubbox/blob/master/dubbo-rpc/dubbo-rpc-api/src/main/java/com/alibaba/dubbo/rpc/proxy/InvokerInvocationHandler.java): `dubbo-rpc/dubbo-rpc-api/src/main/java/com/alibaba/dubbo/rpc/proxy/InvokerInvocationHandler.java`
- [Cluster Invoker](https://github.com/jasun0925/dubbox/blob/master/dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/support/AbstractClusterInvoker.java): `dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/support/AbstractClusterInvoker.java`
- [Provider Directory](https://github.com/jasun0925/dubbox/blob/master/dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/directory/AbstractDirectory.java): `dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/directory/AbstractDirectory.java`
- [Load Balancing](https://github.com/jasun0925/dubbox/blob/master/dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/loadbalance/RandomLoadBalance.java): `dubbo-cluster/src/main/java/com/alibaba/dubbo/rpc/cluster/loadbalance/RandomLoadBalance.java`
- [Remoting Transport](https://github.com/jasun0925/dubbox/blob/master/dubbo-remoting/dubbo-remoting-api/src/main/java/com/alibaba/dubbo/remoting/Server.java): `dubbo-remoting/dubbo-remoting-api/src/main/java/com/alibaba/dubbo/remoting/Server.java`

### Registry And Monitoring

- [Registry Contract](https://github.com/jasun0925/dubbox/blob/master/dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/RegistryService.java): `dubbo-registry/dubbo-registry-api/src/main/java/com/alibaba/dubbo/registry/RegistryService.java`
- [Simple Registry](https://github.com/jasun0925/dubbox/blob/master/dubbo-simple/dubbo-registry-simple/src/main/java/com/alibaba/dubbo/registry/simple/SimpleRegistryService.java): `dubbo-simple/dubbo-registry-simple/src/main/java/com/alibaba/dubbo/registry/simple/SimpleRegistryService.java`
- [Monitor Contract](https://github.com/jasun0925/dubbox/blob/master/dubbo-monitor/dubbo-monitor-api/src/main/java/com/alibaba/dubbo/monitor/MonitorService.java): `dubbo-monitor/dubbo-monitor-api/src/main/java/com/alibaba/dubbo/monitor/MonitorService.java`
- [Simple Monitor](https://github.com/jasun0925/dubbox/blob/master/dubbo-simple/dubbo-monitor-simple/src/main/java/com/alibaba/dubbo/monitor/simple/SimpleMonitorService.java): `dubbo-simple/dubbo-monitor-simple/src/main/java/com/alibaba/dubbo/monitor/simple/SimpleMonitorService.java`

### Admin Governance

- [Admin Screens](https://github.com/jasun0925/dubbox/blob/master/dubbo-admin/src/main/java/com/alibaba/dubbo/governance/web/governance/module/screen/Services.java): `dubbo-admin/src/main/java/com/alibaba/dubbo/governance/web/governance/module/screen/Services.java`
- [Governance Services](https://github.com/jasun0925/dubbox/blob/master/dubbo-admin/src/main/java/com/alibaba/dubbo/governance/service/impl/AbstractService.java): `dubbo-admin/src/main/java/com/alibaba/dubbo/governance/service/impl/AbstractService.java`
- [Registry Sync](https://github.com/jasun0925/dubbox/blob/master/dubbo-admin/src/main/java/com/alibaba/dubbo/governance/sync/RegistryServerSync.java): `dubbo-admin/src/main/java/com/alibaba/dubbo/governance/sync/RegistryServerSync.java`

### Dubbox Extensions

- [HTTP Remoting](https://github.com/jasun0925/dubbox/blob/master/dubbo-remoting/dubbo-remoting-http/src/main/java/com/alibaba/dubbo/remoting/http/servlet/ServletManager.java): `dubbo-remoting/dubbo-remoting-http/src/main/java/com/alibaba/dubbo/remoting/http/servlet/ServletManager.java`
- **REST Remoting**
- **Serialization Options**
- [Web Services](https://github.com/jasun0925/dubbox/blob/master/dubbo-rpc/dubbo-rpc-webservice/src/main/java/com/alibaba/dubbo/rpc/protocol/webservice/WebServiceProtocol.java): `dubbo-rpc/dubbo-rpc-webservice/src/main/java/com/alibaba/dubbo/rpc/protocol/webservice/WebServiceProtocol.java`

### Other components

- **Service Provider**
- **Service Consumer**

## Connections

- Service Provider → Spring Service Config: configures
- Spring Service Config → Service Export: delegates to (evidence: `dubbo-config/dubbo-config-spring/src/main/java/com/alibaba/dubbo/config/spring/ServiceBean.java`)
- Annotation Config → Service Export: configures
- Service Export → Registry Contract: registers service
- Service Consumer → RPC Proxy: invokes
- RPC Proxy → Cluster Invoker: dispatches
- Cluster Invoker → Provider Directory: selects providers
- Cluster Invoker → Load Balancing: balances calls
- Cluster Invoker → Remoting Transport: sends RPC
- Remoting Transport → Registry Contract: discovers services
- Service Export → Monitor Contract: reports usage
- Registry Contract → Simple Registry: implemented by (evidence: `dubbo-simple/dubbo-registry-simple/src/main/java/com/alibaba/dubbo/registry/simple/SimpleRegistryService.java`)
- Monitor Contract → Simple Monitor: implemented by (evidence: `dubbo-simple/dubbo-monitor-simple/src/main/java/com/alibaba/dubbo/monitor/simple/SimpleMonitorService.java`)
- Admin Screens → Governance Services: requests governance
- Governance Services → Registry Sync: uses registry sync (evidence: `dubbo-admin/src/main/java/com/alibaba/dubbo/governance/service/impl/AbstractService.java`)
- Registry Sync → Registry Contract: uses registry (evidence: `dubbo-admin/src/main/java/com/alibaba/dubbo/governance/service/impl/AbstractService.java`)
- Service Export → REST Remoting: supports REST
- Service Export → Serialization Options: supports serializers
- HTTP Remoting → REST Remoting: provides HTTP transport
- Service Export → Web Services: supports protocols
