Method Management Functions

Functions for registering and unregistering RPC methods. More...

Functions
int	mjrpc_add_method (mjrpc_handle_t *handle, mjrpc_func function_pointer, const char *method_name, void *arg2func)
	Register a new RPC method.
int	mjrpc_del_method (mjrpc_handle_t *handle, const char *method_name)
	Unregister an RPC method.

Detailed Description

Functions for registering and unregistering RPC methods.

Function Documentation

mjrpc_add_method()

int mjrpc_add_method	(	mjrpc_handle_t *	handle,
		mjrpc_func	function_pointer,
		const char *	method_name,
		void *	arg2func
	)

Register a new RPC method.

Adds a new method to the JSON-RPC handle with the specified callback function, method name, and optional user argument.

Parameters

handle	JSON-RPC handle (must not be NULL)
function_pointer	Callback function for the method (must not be NULL)
method_name	Name of the method (must not be NULL)
arg2func	User argument passed to the callback function (can be NULL)

Returns

Error code from enum mjrpc_error_return

Return values

MJRPC_RET_OK	If successful
MJRPC_RET_ERROR_HANDLE_NOT_INITIALIZED	If handle is NULL
MJRPC_RET_ERROR_INVALID_PARAM	If function_pointer or method_name is NULL
MJRPC_RET_ERROR_MEM_ALLOC_FAILED	If memory allocation failed

Note

If a method with the same name already exists, it will be replaced

The method_name will be copied internally

Example:

cJSON *hello_method(mjrpc_func_ctx_t *ctx, cJSON *params, cJSON *id) {
    return cJSON_CreateString("Hello, World!");
}
 
mjrpc_handle_t *handle = mjrpc_create_handle(0);
int ret = mjrpc_add_method(handle, hello_method, "hello", NULL);
if (ret != MJRPC_RET_OK) {
    // Handle error...
}

mjrpc_del_method()

int mjrpc_del_method	(	mjrpc_handle_t *	handle,
		const char *	method_name
	)

Unregister an RPC method.

Removes the specified method from the JSON-RPC handle and frees associated memory.

Parameters

handle	JSON-RPC handle (must not be NULL)
method_name	Name of the method to remove (must not be NULL)

Returns

Error code from enum mjrpc_error_return

Return values

MJRPC_RET_OK	If successful
MJRPC_RET_ERROR_INVALID_PARAM	If method_name is NULL
MJRPC_RET_ERROR_NOT_FOUND	If method was not found

Example:

int ret = mjrpc_del_method(handle, "hello");
if (ret == MJRPC_RET_ERROR_NOT_FOUND) {
    printf("Method 'hello' not found\n");
}