Home /Modules/http-3.0/http3_naming.h

http3_naming.h

http-3.0/http3_naming.h · 83 line(s) · c

/* ==========================================================================
 * http3_naming.h -- SLeeLa HTTP 3.0 fast naming (spec §4).
 *
 * HTTP 3.0 treats service and operation names as performance-critical data.
 * The first request may carry full names; later requests over the same
 * connection use compact numeric identifiers negotiated here:
 *
 *     First request:   service="orders",  operation="calculate"
 *     Later requests:  service=7,          operation=3
 *
 * The numeric ids are connection/service-local and MUST NOT be assumed
 * globally stable (spec §4). This dictionary resolves names -> compact ids
 * (caching the result) and ids -> names (for dispatch and diagnostics).
 * ========================================================================== */
#ifndef HTTP3_NAMING_H
#define HTTP3_NAMING_H

#include <stddef.h>
#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

#define HTTP3_NAME_MAX        64u   /* max length of a service/operation name  */
#define HTTP3_MAX_SERVICES    64u   /* dictionary capacity: services           */
#define HTTP3_MAX_OPS_PER_SVC 64u   /* dictionary capacity: ops per service    */

/* An operation entry: its local id and name. */
typedef struct {
    uint32_t op_id;
    char     name[HTTP3_NAME_MAX];
} http3_op_entry_t;

/* A service entry: its local id, name, and its operation table. */
typedef struct {
    uint32_t         service_id;
    char             name[HTTP3_NAME_MAX];
    http3_op_entry_t ops[HTTP3_MAX_OPS_PER_SVC];
    size_t           op_count;
} http3_service_entry_t;

/* The connection-local naming dictionary. Compact ids are assigned in the
 * order names are first seen (ids start at 1; 0 means "unresolved"). */
typedef struct {
    http3_service_entry_t services[HTTP3_MAX_SERVICES];
    size_t                service_count;
    uint32_t              next_service_id;
} http3_naming_t;

/* Initialize an empty dictionary. */
void http3_naming_init(http3_naming_t *dict);

/*
 * Resolve a service name to its compact id, allocating a new id on first use
 * (this is the caching step of §4). Returns the id, or 0 on capacity/input
 * error.
 */
uint32_t http3_naming_intern_service(http3_naming_t *dict, const char *service_name);

/*
 * Resolve an operation name within a service to its compact id, allocating on
 * first use. Returns the op id, or 0 on error.
 */
uint32_t http3_naming_intern_op(http3_naming_t *dict,
                                const char *service_name,
                                const char *op_name);

/* Look up ids WITHOUT allocating (returns 0 if not yet interned). */
uint32_t http3_naming_lookup_service(const http3_naming_t *dict, const char *service_name);
uint32_t http3_naming_lookup_op(const http3_naming_t *dict, uint32_t service_id, const char *op_name);

/* Reverse lookups: compact id -> name (for dispatch and §17 diagnostics).
 * Returns NULL if the id is unknown. */
const char *http3_naming_service_name(const http3_naming_t *dict, uint32_t service_id);
const char *http3_naming_op_name(const http3_naming_t *dict, uint32_t service_id, uint32_t op_id);

#ifdef __cplusplus
}
#endif

#endif /* HTTP3_NAMING_H */