move marshaller to IPC component

master
Сергей Маринкевич 2 months ago
parent 31d0496a93
commit e7aa646a80

@ -27,9 +27,8 @@ project/
│ │ ├── IpcConfig.h # type alias: using IpcMessage = BaseIpcMessage<TextIpcSerializer> │ │ ├── IpcConfig.h # type alias: using IpcMessage = BaseIpcMessage<TextIpcSerializer>
│ │ ├── IpcDispatcher.h │ │ ├── IpcDispatcher.h
│ │ ├── IpcPipeChannel.h │ │ ├── IpcPipeChannel.h
│ │ ├── IpcMarshaller.h
│ │ └── IpcSerializer.h # сериализаторы (TextIpcSerializer) │ │ └── IpcSerializer.h # сериализаторы (TextIpcSerializer)
│ ├── proxy/
│ │ └── ProxyMarshaller.h
│ └── rpc/ │ └── rpc/
│ ├── rpc_export.h │ ├── rpc_export.h
│ ├── RpcInvoker.h │ ├── RpcInvoker.h
@ -59,15 +58,15 @@ project/
* Сериализация вынесена в отдельные сериализаторы (`TextIpcSerializer` и т.д.) * Сериализация вынесена в отдельные сериализаторы (`TextIpcSerializer` и т.д.)
* Тип сырых данных параметризован через сериализатор (по умолчанию `std::string`, можно использовать `std::vector<std::byte>` для бинарных форматов) * Тип сырых данных параметризован через сериализатор (по умолчанию `std::string`, можно использовать `std::vector<std::byte>` для бинарных форматов)
* Выбор сериализатора делается один раз в `IpcConfig.h` через type alias * Выбор сериализатора делается один раз в `IpcConfig.h` через type alias
* **Уровень канала**: `RpcChannel` + `IpcPipeChannel` * **Уровень канала**: `IpcChannel` + `IpcPipeChannel`
* `IpcChannel` — абстракция транспорта: `send(const IpcMessage&)`, `receive() -> IpcMessage`. * `IpcChannel` — абстракция транспорта: `send(const IpcMessage&)`, `receive() -> IpcMessage`.
* `IpcPipeChannel` — реализация поверх двух FIFO (`/tmp/fifo_to_server`, `/tmp/fifo_to_client`), которая внутри работает со строками, но наружу — только с `IpcMessage`. * `IpcPipeChannel` — реализация поверх двух FIFO (`/tmp/fifo_to_server`, `/tmp/fifo_to_client`), которая внутри работает со строками, но наружу — только с `IpcMessage`.
* **Уровень RPC-ядра**: * **Уровень RPC-ядра**:
* `ProxyMarshaller` — собирает `IpcMessage` из имени метода и аргументов, отправляет через `RpcChannel` и читает ответ. * `IpcMarshaller` — собирает `IpcMessage` из имени метода и аргументов, отправляет через `IpcChannel` и читает ответ.
* `RpcInvoker` — по имени метода (первое поле сообщения) находит зарегистрированную функцию-член и вызывает её, читая аргументы через `get<T>()`. * `RpcInvoker` — по имени метода (первое поле сообщения) находит зарегистрированную функцию-член и вызывает её, читая аргументы через `get<T>()`.
* **Сгенерированные обёртки**: * **Сгенерированные обёртки**:
* `*.proxy.*` — используют `ProxyMarshaller` и `RpcChannel`, не зависят от конкретного транспорта. * `*.proxy.*` — шаблонные классы, зависящие только от абстрактного `impl` с методом `impl.callTyped<Ret>(method, args...)` и не знающие про конкретный транспорт.
* `*.skeleton.*` — используют `RpcInvoker` и принимают/возвращают `IpcMessage` для диспетчеризации вызовов. * `*.skeleton.*` — используют `RpcInvoker` и принимают/возвращают `RpcValue` для диспетчеризации вызовов.
--- ---

@ -4,9 +4,13 @@
#include <ipc/IpcCodec.h> #include <ipc/IpcCodec.h>
#include <rpc/RpcValue.h> #include <rpc/RpcValue.h>
class ProxyMarshaller { // Маршаллер, который знает, как превратить типизированный RPC-вызов
// в IpcMessage и обратно. Живёт в IPC-слое и опирается на IpcChannel
// и IpcCodec, но снаружи предъявляет только callTyped<T>(...).
class IpcMarshaller {
public: public:
explicit ProxyMarshaller(IpcChannel& ch) : channel(ch) {} explicit IpcMarshaller(IpcChannel& ch)
: channel(ch) {}
// Базовый type-erased вызов: принимает вектор RpcValue и возвращает RpcValue. // Базовый type-erased вызов: принимает вектор RpcValue и возвращает RpcValue.
RpcValue call(const std::string& method, const RpcArgs& args) { RpcValue call(const std::string& method, const RpcArgs& args) {
@ -21,7 +25,7 @@ public:
return IpcCodec::decodeResponse(resp); return IpcCodec::decodeResponse(resp);
} }
// Удобный шаблонный хелпер для сгенерированных прокси. // Типизированный хелпер: контрактом является только наличие этого метода.
template<typename Ret, typename... Args> template<typename Ret, typename... Args>
Ret callTyped(const std::string& method, const Args&... args) { Ret callTyped(const std::string& method, const Args&... args) {
RpcArgs packed; RpcArgs packed;
@ -38,3 +42,4 @@ private:
}; };

@ -1,6 +1,6 @@
#include "MyService.proxy.h" #include "MyService.proxy.h"
#include "ipc/IpcPipeChannel.h" #include "ipc/IpcPipeChannel.h"
#include "proxy/ProxyMarshaller.h" #include "ipc/IpcMarshaller.h"
#include <sys/stat.h> #include <sys/stat.h>
@ -16,9 +16,9 @@ int main() {
// и читает из fifo, в который пишет сервер (fifo_to_client). // и читает из fifo, в который пишет сервер (fifo_to_client).
IpcPipeChannel ch("/tmp/fifo_to_client", "/tmp/fifo_to_server"); IpcPipeChannel ch("/tmp/fifo_to_client", "/tmp/fifo_to_server");
// RPCуровень: создаём marshaller поверх канала и передаём его в прокси. // RPCуровень: создаём IpcMarshaller поверх канала и передаём его в прокси.
ProxyMarshaller marshaller(ch); IpcMarshaller marshaller(ch);
MyServiceProxy proxy(marshaller); MyServiceProxy<IpcMarshaller> proxy(marshaller);
proxy.add(7, 9); proxy.add(7, 9);
int counter = proxy.get(); int counter = proxy.get();

@ -1,11 +1,5 @@
#include "{{ cls.name }}.proxy.h" #include "{{ cls.name }}.proxy.h"
{{ cls.name }}Proxy::{{ cls.name }}Proxy(ProxyMarshaller& marshaller) // Реализация шаблонного прокси целиком находится в заголовочном файле.
: impl(marshaller) {} // Этот cpp остаётся пустым, чтобы сгенерированные файлы по‑прежнему
// могли участвовать в сборке как отдельная единица трансляции.
{% for m in cls.methods %}
{{ m.return_type }} {{ cls.name }}Proxy::{{ m.name }}({% for a in m.args %}{{ a.type }} {{ a.name }}{% if not loop.last %}, {% endif %}{% endfor %}) {
return impl.callTyped<{{ m.return_type }}>("{{ cls.name }}.{{ m.name }}"{% for a in m.args %}, {{ a.name }}{% endfor %});
}
{% endfor %}

@ -1,14 +1,24 @@
#pragma once #pragma once
#include "proxy/ProxyMarshaller.h" #include "{{ cls.name }}.h"
// Шаблонный прокси, который зависит только от контракта Impl:
// Impl должен предоставлять метод
// template<typename Ret, typename... Args>
// Ret callTyped(const std::string& method, const Args&... args);
template<typename Impl>
class {{ cls.name }}Proxy { class {{ cls.name }}Proxy {
public: public:
explicit {{ cls.name }}Proxy(ProxyMarshaller& marshaller); explicit {{ cls.name }}Proxy(Impl& impl)
: impl(impl) {}
{% for m in cls.methods %} {% for m in cls.methods %}
{{ m.return_type }} {{ m.name }}({% for a in m.args %}{{ a.type }} {{ a.name }}{% if not loop.last %}, {% endif %}{% endfor %}); {{ m.return_type }} {{ m.name }}({% for a in m.args %}{{ a.type }} {{ a.name }}{% if not loop.last %}, {% endif %}{% endfor %}) {
return impl.template callTyped<{{ m.return_type }}>("{{ cls.name }}.{{ m.name }}"{% for a in m.args %}, {{ a.name }}{% endfor %});
}
{% endfor %} {% endfor %}
private: private:
ProxyMarshaller& impl; Impl& impl;
}; };

Loading…
Cancel
Save