REST library

Helper library to parse/create REST. More...

Collaboration diagram for REST library:

Data Structures
struct	GNUNET_REST_RequestHandle
struct	GNUNET_REST_RequestHandlerError
struct	GNUNET_REST_RequestHandler

Macros
#define	GNUNET_REST_HANDLER_END   { NULL, NULL, NULL }

Typedefs
typedef void(*	GNUNET_REST_ResultProcessor) (void *cls, struct MHD_Response *resp, int status)
	Iterator called on obtained result for a REST result. More...

Functions
int	GNUNET_REST_namespace_match (const char *url, const char *namespace)
	Check if namespace is in URL. More...
struct MHD_Response *	GNUNET_REST_create_response (const char *data)
	Create REST MHD response. More...
int	GNUNET_REST_handle_request (struct GNUNET_REST_RequestHandle *conn, const struct GNUNET_REST_RequestHandler *handlers, struct GNUNET_REST_RequestHandlerError *err, void *cls)

Detailed Description

Helper library to parse/create REST.

Macro Definition Documentation

GNUNET_REST_HANDLER_END

#define GNUNET_REST_HANDLER_END   { NULL, NULL, NULL }

Definition at line 41 of file gnunet_rest_lib.h.

Typedef Documentation

GNUNET_REST_ResultProcessor

typedef void(* GNUNET_REST_ResultProcessor) (void *cls, struct MHD_Response *resp, int status)

Iterator called on obtained result for a REST result.

Parameters

cls	closure
resp	the response
status	status code (HTTP)

Definition at line 110 of file gnunet_rest_lib.h.

Function Documentation

GNUNET_REST_namespace_match()

int GNUNET_REST_namespace_match	(	const char *	url,
		const char *	namespace
	)

Check if namespace is in URL.

Parameters

url	URL to check
namespace	namespace to check against

Returns

GNUNET_YES if namespace matches

Check if namespace is in URL.

Definition at line 37 of file rest.c.

{
  return 0 == strncmp (namespace, url, strlen (namespace));
}

Referenced by GNUNET_REST_handle_request().

Here is the caller graph for this function:

GNUNET_REST_create_response()

struct MHD_Response* GNUNET_REST_create_response

(

const char *

data

)

Create REST MHD response.

Parameters

data

result

Returns

MHD response

Definition at line 44 of file rest.c.

{
  struct MHD_Response *resp;
  size_t len;
 
  if (NULL == data)
  {
    len = 0;
    data = "";
  }
  else
    len = strlen (data);
  resp = MHD_create_response_from_buffer (len,
                                          (void *) data,
                                          MHD_RESPMEM_MUST_COPY);
  return resp;
}

References data, and len.

Referenced by build_redirect(), bulk_tx_commit_cb(), consume_fail(), consume_ticket(), create_finished(), del_finished(), delete_finished_cb(), do_error(), do_finished(), do_redirect_error(), do_userinfo_error(), ego_get_all(), ego_get_response(), ego_sign_data_cb(), finished_cont(), get_cont(), handle_gns_response(), jwks_endpoint(), login_cont(), login_redirect(), namestore_list_finished(), oidc_config_cors(), oidc_config_endpoint(), oidc_ticket_issue_cb(), options_cont(), peerinfo_list_finished(), return_response(), set_cont(), and token_endpoint().

Here is the caller graph for this function:

GNUNET_REST_handle_request()

int GNUNET_REST_handle_request	(	struct GNUNET_REST_RequestHandle *	conn,
		const struct GNUNET_REST_RequestHandler *	handlers,
		struct GNUNET_REST_RequestHandlerError *	err,
		void *	cls
	)

Definition at line 64 of file rest.c.

{
  int count;
  int i;
  char *url;
 
  count = 0;
  while (NULL != handlers[count].method)
    count++;
 
  GNUNET_asprintf (&url, "%s", conn->url);
  if (url[strlen (url) - 1] == '/')
    url[strlen (url) - 1] = '\0';
  for (i = 0; i < count; i++)
  {
    if (0 != strcasecmp (conn->method, handlers[i].method))
      continue;
    if (strlen (url) < strlen (handlers[i].namespace))
      continue;
    if (GNUNET_NO == GNUNET_REST_namespace_match (url, handlers[i].namespace))
      continue;
    // Match
    handlers[i].proc (conn, (const char *) url, cls);
    GNUNET_free (url);
    return GNUNET_YES;
  }
  GNUNET_free (url);
  err->error_code = MHD_HTTP_BAD_REQUEST;
  return GNUNET_NO;
}

References GNUNET_REST_RequestHandlerError::error_code, GNUNET_asprintf(), GNUNET_free, GNUNET_NO, GNUNET_REST_namespace_match(), GNUNET_YES, handlers, GNUNET_REST_RequestHandle::method, MHD_HTTP_BAD_REQUEST, and GNUNET_REST_RequestHandle::url.

Here is the call graph for this function: