Home /Modules/http-servers/README.md

README.md

http-servers/README.md · 77 line(s) · markdown

<img align="right" src="https://github.com/mearvk/SLeeLa/blob/master/images/debian/debian-logo.png" width="75" height="75" alt="SLeeLa">

<img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-logo-004.jpg" alt="SLeeLa">

SLeeLa HTTP Servers

Three native server grades live under http-servers/1, 2, and 3, sharing common/.

Grade 2 and Grade 3 are transport-specific implementations. Grade 2 uses native HTTP/2 framing over TCP; Grade 3 uses HTTP/3 over QUIC/UDP. They do not falsely treat either protocol as HTTP/1 text. Lower-protocol compatibility is a separate service/dispatch concern and is not claimed by the dedicated Grade 2/3 listeners yet.

Configuration, logging, and generated-output rules are documented in CONFIGURATION.md, LOGGING.md, and OUTPUTS.md. HTTP/3 additionally requires deployment-managed TLS key/certificate material and a QUIC-capable backend.

The HTTP/1.x parser follows the repository's HTTP specifications plus RFC 1945 for HTTP/1.0 and RFC 9112 for current HTTP/1.1 message framing.

Command line

sleela http-server 1
sleela http-server 2
sleela http-server 3

Optional flags: --port N, --threads N, --root DIR, --log FILE, --once.

Defaults are TCP 8080/8081/8082.

Careful architecture

Apache's documented modular MPM model and Tomcat's connector/request-worker model were used as architectural references, not copied code.

Native builds

make -C http-servers/1
make -C http-servers/2
make -C http-servers/3

The common source is reusable by future HTTP/2 and HTTP/3 transport adapters.

Annotation forwarding and generations 1.0–9.0

The HTTP server family now participates in SLeeLa's uniform annotation model: Holding Document → Forwarding Annotation → Nexter Colony → HTTP Generation → Transport Adapter. See http/ANNOTATION-FORWARDING.md. The common annotation bridge validates a declared Nexter Colony while leaving authorization and generation-specific protocol semantics to their authoritative layers.

Unified Route Data

This server consumes the SLeeLa unified route-data contract in route/ROUTE.DATA.json and route/ROUTE.DATA.md. Route records carry protocol, server surface, HTTP generation, VM generation/formal VM name, canonical configuration root, route identifier, target/resolution mode, capability, transport, port, and status. VM names are architectural metadata only and do not grant capabilities. Dynamic targets must use the shared resolver before acceptance. The VM identity is: /impl Core, /1 Foundation, /2 Operator, /3 Specialist, /4 Supervisor, /5 Manager, /6 Director, /7 Administrator, /8 Executive, /9 Authority, /10 Principal, /11 Sovereign.


SLeeLa

<p align="center"><img src="images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>