jsonrpc::server::Dispatcher Class Reference

Dispatcher for JSON-RPC requests. More...

#include <dispatcher.hpp>

Collaboration diagram for jsonrpc::server::Dispatcher:

Public Member Functions
	Dispatcher (bool enable_multithreading=true, size_t num_threads=std::thread::hardware_concurrency())
	Constructs a Dispatcher.
	Dispatcher (const Dispatcher &)=delete
	Dispatcher (Dispatcher &&)=delete
auto	operator= (const Dispatcher &) -> Dispatcher &=delete
auto	operator= (Dispatcher &&) -> Dispatcher &=delete
virtual	~Dispatcher ()=default
	Destructor.
auto	DispatchRequest (const std::string &request) -> std::optional< std::string >
	Processes a JSON-RPC request.
void	RegisterMethodCall (const std::string &method, const MethodCallHandler &handler)
	Registers a method call handler.
void	RegisterNotification (const std::string &method, const NotificationHandler &handler)
	Registers a notification handler.

Detailed Description

Dispatcher for JSON-RPC requests.

Dispatcher manages the registration and execution of method call and notification handlers for JSON-RPC requests. It can operate in single-threaded or multi-threaded mode.

Definition at line 24 of file dispatcher.hpp.

Constructor & Destructor Documentation

Dispatcher() [1/3]

jsonrpc::server::Dispatcher::Dispatcher ( bool enable_multithreading = true, size_t num_threads = std::thread::hardware_concurrency() )

explicit

Constructs a Dispatcher.

Parameters

enableMultithreading	Enable multi-threading support.
numThreads	Number of threads to use if multi-threading is enabled.

Definition at line 7 of file dispatcher.cpp.

    : enable_multithreading_(enable_multithreading),
      thread_pool_(enable_multithreading ? num_threads : 0) {
  // Optionally log or perform additional setup if needed
  if (enable_multithreading_) {
    spdlog::info(
        "Dispatcher initialized with multithreading support using {} threads",
        num_threads);
  } else {
    spdlog::info("Dispatcher initialized without multithreading support");
  }
}

Dispatcher() [2/3]

jsonrpc::server::Dispatcher::Dispatcher ( const Dispatcher & )

delete

Dispatcher() [3/3]

jsonrpc::server::Dispatcher::Dispatcher ( Dispatcher && )

delete

~Dispatcher()

virtual jsonrpc::server::Dispatcher::~Dispatcher ( )

virtualdefault

Destructor.

Member Function Documentation

DispatchRequest()

auto jsonrpc::server::Dispatcher::DispatchRequest

(

const std::string &

request

)

-> std::optional<std::string>

Processes a JSON-RPC request.

Dispatches the request to the appropriate handler.

Parameters

request

The JSON-RPC request as a string.

Returns

The response from the handler as a JSON string, or std::nullopt if no response is needed.

Definition at line 20 of file dispatcher.cpp.

                              {
  auto request_json = ParseAndValidateJson(request_str);
  if (!request_json.has_value()) {
    return Response::CreateLibError(LibErrorKind::kParseError).ToStr();
  }
 
  if (request_json->is_array()) {
    return DispatchBatchRequest(*request_json);
  }
 
  return DispatchSingleRequest(*request_json);
}

References jsonrpc::server::Response::CreateLibError(), and jsonrpc::server::kParseError.

Here is the call graph for this function:

operator=() [1/2]

auto jsonrpc::server::Dispatcher::operator= ( const Dispatcher & ) -> Dispatcher &=delete

delete

operator=() [2/2]

auto jsonrpc::server::Dispatcher::operator= ( Dispatcher && ) -> Dispatcher &=delete

delete

RegisterMethodCall()

void jsonrpc::server::Dispatcher::RegisterMethodCall	(	const std::string &	method,
		const MethodCallHandler &	handler )

Registers a method call handler.

Parameters

method	The name of the RPC method.
handler	The handler function for this method.

Definition at line 208 of file dispatcher.cpp.

                                                               {
  handlers_[method] = handler;
  spdlog::info("Dispatcher registered method call: {}", method);
}

RegisterNotification()

void jsonrpc::server::Dispatcher::RegisterNotification	(	const std::string &	method,
		const NotificationHandler &	handler )

Registers a notification handler.

Parameters

method	The name of the RPC notification.
handler	The handler function for this notification.

Definition at line 214 of file dispatcher.cpp.

                                                                 {
  handlers_[method] = handler;
  spdlog::info("Dispatcher registered notification: {}", method);
}

---

The documentation for this class was generated from the following files:

• include/jsonrpc/server/dispatcher.hpp
• src/server/dispatcher.cpp