Today I started working on the HTTP server that finds, converts and serves content stored in the (SQL) backend just-in-time (later the server could also cache content).
The server can handle these types of requests:
Fileder Index Requests
A request like GET /path/to/fileder/ (note the trailing slash) is used to query the contents of a fileder.
It solicits a JSON-encoded response that contains the full paths to all children of this fileder, as well as all facets currently stored, e.g:
{
"children": [
"/projects/vcv_mods",
"/projects/HowDoIOS",
"/projects/iii-telefoni",
"/projects/btrktrl",
"/projects/demoloops",
"/projects/VJmidiKit",
"/projects/gayngine",
"/projects/themer",
"/projects/chimpanzee_bukkaque"
],
"facets": [
["", "text/moonscript -> fn -> mmm/dom"],
["name", "alpha"],
["title", "text/plain"]
]
}
Facet Requests
A request like GET /path/to/fileder/facet_name is used to query a facet.
To differentiate a request for the ‘unnamed’ facet from an index request, unnamed facets are represented as a : character instead.
The type to ask for can be specified in a MMM-Accept header separately, it defaults to text/html.
The server either sends back the (possibly converted) facet with a 200 OK status,
or a 406 Not Acceptable error if no conversion was possible.
I also restructured the code a bit and moved some of the HTML-rendering code into the main mmmfs code.
Then I renamed the text/html type to text/html+frag, since it refers to only a fragment of HTML code, not a whole document,
and added a new convert from text/html+frag to text/html that wraps the fragment in the HTML template and style.