# drindom/rpc-project architecture

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

- Interactive diagram: https://gitdiagram.com/drindom/rpc-project
- Repository: https://github.com/drindom/rpc-project

## Overview

This is a small Java RPC example with a consumer, provider, and shared UserService contract. The intended workflow is a consumer calling a generated service proxy, which serializes an RPC request over HTTP; the provider deserializes it, resolves and invokes a registered implementation, and returns a serialized response. The README is empty, so the map relies on source excerpts and the SOURCE INDEX. Application wiring is not excerpted; those links are marked unverified rather than asserted as observed calls.

Main entry points: [`my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServerHandler.java`](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServerHandler.java) (Request Handler), [`my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxy.java`](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxy.java) (Service Proxy), [`my-rpc/provider/src/main/java/com/drindom/rpc/provider/UserServiceImpl.java`](https://github.com/drindom/rpc-project/blob/main/my-rpc/provider/src/main/java/com/drindom/rpc/provider/UserServiceImpl.java) (User Implementation), [`my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/VertxHttpServer.java`](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/VertxHttpServer.java) (HTTP Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Applications"]
  node_consumer["Consumer App"]
  node_provider["Provider App"]
  node_service_impl["User Implementation"]
end

subgraph group_contract["Shared Contract"]
  node_user_service["UserService<br/>[UserService.java]"]
  node_user_model["User Model<br/>[User.java]"]
end

subgraph group_client["RPC Client"]
  node_proxy_factory["Proxy Factory"]
  node_service_proxy["Service Proxy<br/>[ServiceProxy.java]"]
  node_rpc_request["RPC Request<br/>[RpcRequest.java]"]
  node_serializer["JDK Serializer<br/>[JdkSerializer.java]"]
  node_serializer_api["Serializer API<br/>[Serializer.java]"]
end

subgraph group_server["RPC Server"]
  node_http_server["HTTP Server"]
  node_http_server_api["Server API<br/>[HttpServer.java]"]
  node_request_handler["Request Handler"]
  node_registry[("Local Registry<br/>[LocalRegistry.java]")]
  node_rpc_response["RPC Response<br/>[RpcResponse.java]"]
end

node_caller(("RPC Caller"))
node_http(("HTTP Transport"))

node_caller -->|"invokes"| node_consumer
node_consumer -.->|"uses contract"| node_user_service
node_consumer -.->|"requests proxy"| node_proxy_factory
node_proxy_factory -->|"creates"| node_service_proxy
node_service_proxy -->|"builds request"| node_rpc_request
node_service_proxy -->|"serializes"| node_serializer
node_serializer -->|"implements"| node_serializer_api
node_service_proxy -->|"sends request"| node_http
node_http -.->|"delivers request"| node_http_server
node_provider -.->|"registers service"| node_registry
node_provider -.->|"provides implementation"| node_service_impl
node_provider -.->|"starts server"| node_http_server
node_http_server -->|"implements"| node_http_server_api
node_http_server -.->|"routes requests"| node_request_handler
node_request_handler -->|"deserializes request"| node_serializer
node_request_handler -->|"looks up service"| node_registry
node_request_handler -.->|"invokes implementation"| node_service_impl
node_request_handler -->|"builds response"| node_rpc_response
node_request_handler -->|"serializes response"| node_serializer
node_user_service -->|"uses type"| node_user_model
node_service_impl -->|"implements"| node_user_service
node_service_impl -->|"returns type"| node_user_model

click node_consumer "https://github.com/drindom/rpc-project/blob/main/my-rpc/consumer/src/main/java/com/drindom/rpc/consumer/ComsumerApplication.java"
click node_provider "https://github.com/drindom/rpc-project/blob/main/my-rpc/provider/src/main/java/com/drindom/rpc/provider/ProviderApplication.java"
click node_user_service "https://github.com/drindom/rpc-project/blob/main/my-rpc/common/src/main/java/com/drindom/rpc/common/service/UserService.java"
click node_user_model "https://github.com/drindom/rpc-project/blob/main/my-rpc/common/src/main/java/com/drindom/rpc/common/model/User.java"
click node_service_impl "https://github.com/drindom/rpc-project/blob/main/my-rpc/provider/src/main/java/com/drindom/rpc/provider/UserServiceImpl.java"
click node_proxy_factory "https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxyFactory.java"
click node_service_proxy "https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxy.java"
click node_rpc_request "https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/model/RpcRequest.java"
click node_serializer "https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/serializer/JdkSerializer.java"
click node_serializer_api "https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/serializer/Serializer.java"
click node_http_server "https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/VertxHttpServer.java"
click node_http_server_api "https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServer.java"
click node_request_handler "https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServerHandler.java"
click node_registry "https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/registry/LocalRegistry.java"
click node_rpc_response "https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/model/RpcResponse.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_consumer,node_provider,node_service_impl toneBlue
class node_user_service,node_user_model toneAmber
class node_proxy_factory,node_service_proxy,node_rpc_request,node_serializer,node_serializer_api toneMint
class node_http_server,node_http_server_api,node_request_handler,node_registry,node_rpc_response toneRose
class node_caller,node_http toneIndigo
```

## Components

### Applications

- [Consumer App](https://github.com/drindom/rpc-project/blob/main/my-rpc/consumer/src/main/java/com/drindom/rpc/consumer/ComsumerApplication.java): `my-rpc/consumer/src/main/java/com/drindom/rpc/consumer/ComsumerApplication.java`
- [Provider App](https://github.com/drindom/rpc-project/blob/main/my-rpc/provider/src/main/java/com/drindom/rpc/provider/ProviderApplication.java): `my-rpc/provider/src/main/java/com/drindom/rpc/provider/ProviderApplication.java`
- [User Implementation](https://github.com/drindom/rpc-project/blob/main/my-rpc/provider/src/main/java/com/drindom/rpc/provider/UserServiceImpl.java): `my-rpc/provider/src/main/java/com/drindom/rpc/provider/UserServiceImpl.java`

### Shared Contract

- [UserService](https://github.com/drindom/rpc-project/blob/main/my-rpc/common/src/main/java/com/drindom/rpc/common/service/UserService.java): `my-rpc/common/src/main/java/com/drindom/rpc/common/service/UserService.java`
- [User Model](https://github.com/drindom/rpc-project/blob/main/my-rpc/common/src/main/java/com/drindom/rpc/common/model/User.java): `my-rpc/common/src/main/java/com/drindom/rpc/common/model/User.java`

### RPC Client

- [Proxy Factory](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxyFactory.java): `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxyFactory.java`
- [Service Proxy](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxy.java): `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxy.java`
- [RPC Request](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/model/RpcRequest.java): `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/model/RpcRequest.java`
- [JDK Serializer](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/serializer/JdkSerializer.java): `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/serializer/JdkSerializer.java`
- [Serializer API](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/serializer/Serializer.java): `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/serializer/Serializer.java`

### RPC Server

- [HTTP Server](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/VertxHttpServer.java): `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/VertxHttpServer.java`
- [Server API](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServer.java): `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServer.java`
- [Request Handler](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServerHandler.java): `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServerHandler.java`
- [Local Registry](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/registry/LocalRegistry.java): `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/registry/LocalRegistry.java`
- [RPC Response](https://github.com/drindom/rpc-project/blob/main/my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/model/RpcResponse.java): `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/model/RpcResponse.java`

### Other components

- **RPC Caller**
- **HTTP Transport**

## Connections

- RPC Caller → Consumer App: invokes
- Consumer App → UserService: uses contract (evidence: `my-rpc/consumer/src/main/java/com/drindom/rpc/consumer/ComsumerApplication.java`)
- Consumer App → Proxy Factory: requests proxy (evidence: `my-rpc/consumer/src/main/java/com/drindom/rpc/consumer/ComsumerApplication.java`)
- Proxy Factory → Service Proxy: creates (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxyFactory.java`)
- Service Proxy → RPC Request: builds request (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxy.java`)
- Service Proxy → JDK Serializer: serializes (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxy.java`)
- JDK Serializer → Serializer API: implements (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/serializer/JdkSerializer.java`)
- Service Proxy → HTTP Transport: sends request (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/proxy/ServiceProxy.java`)
- HTTP Transport → HTTP Server: delivers request
- Provider App → Local Registry: registers service (evidence: `my-rpc/provider/src/main/java/com/drindom/rpc/provider/ProviderApplication.java`)
- Provider App → User Implementation: provides implementation (evidence: `my-rpc/provider/src/main/java/com/drindom/rpc/provider/ProviderApplication.java`)
- Provider App → HTTP Server: starts server (evidence: `my-rpc/provider/src/main/java/com/drindom/rpc/provider/ProviderApplication.java`)
- HTTP Server → Server API: implements (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/VertxHttpServer.java`)
- HTTP Server → Request Handler: routes requests (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/VertxHttpServer.java`)
- Request Handler → JDK Serializer: deserializes request (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServerHandler.java`)
- Request Handler → Local Registry: looks up service (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServerHandler.java`)
- Request Handler → User Implementation: invokes implementation
- Request Handler → RPC Response: builds response (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServerHandler.java`)
- Request Handler → JDK Serializer: serializes response (evidence: `my-rpc/rpc-core/src/main/java/com/drindom/rpc/core/server/HttpServerHandler.java`)
- UserService → User Model: uses type (evidence: `my-rpc/common/src/main/java/com/drindom/rpc/common/service/UserService.java`)
- User Implementation → UserService: implements (evidence: `my-rpc/provider/src/main/java/com/drindom/rpc/provider/UserServiceImpl.java`)
- User Implementation → User Model: returns type (evidence: `my-rpc/provider/src/main/java/com/drindom/rpc/provider/UserServiceImpl.java`)
