Skip to content
wired guide

Routing by path

There is no router: the handler reads :path from the request and decides. This page answers / and /about, and a real 404 for anything else.

Code

main.c
#define WIRED_MAIN
#include "wired.h"


/* Pick the response by :path; an unknown path answers a real 404
 * (wired_http_handler can choose the status, unlike the 7-argument
 * handler, which always sends 200). */
static int on_request(void* ctx, wired_http_exchange* x) {
  (void)ctx;
  wired_span path = wired_h3req_path(x->req);
  wired_dprintf(2, "request %.*s\n", WIRED_SPAN_ARG(path));
  if (wired_span_eq_cstr(path, "/")) return wired_http_reply_text(x, 0, "home");
  if (wired_span_eq_cstr(path, "/about"))
    return wired_http_reply_text(x, 0, "about");
  x->status = 404;
  return 0;
}


int wired_main(int argc, char** argv) {
  /* Fixed demo identity (self-signed certificate; never for production). */
  static wired_srvboot_demo_keys keys;
  wired_srvboot_id               id;
  wired_srvboot_demo(&id, &keys, 0x50, "guide-h3");


  u16 port                 = (u16)wired_cliargs_int(argc, argv, "--port", 4433);
  wired_srvrun_handler h   = {.http = on_request};
  wired_srvrun_obs     obs = {0};
  return wired_server_run(port, &id, h, obs) ? 0 : 1;
}

Output

Terminal window
$ ./h3-routing --port 4433
request /
request /about
request /missing
conn closed by peer (CONNECTION_CLOSE)
Terminal window
$ probe h3get 127.0.0.1:4433 / /about /missing
GET / status=200 content-type=text/plain body="home"
GET /about status=200 content-type=text/plain body="about"
GET /missing status=404 body=""

How it works

Section titled “How it works”
  • x->req->path / x->req->path_len hold the request’s :path (not NUL-terminated). Compare them byte by byte.
  • The handler takes a wired_http_exchange* (wired_srvrun_handler.http), so it can set x->status instead of always answering 200.
  • Returning 0 with x->status left unset sends a 200 with no body; setting x->status = 404 before returning 0 sends that status instead.
  • wired_log_str needs a NUL-terminated string, so log_request copies the path into a local buffer first.