Further improvements to httphi API (#173)

* add Exchange.WriteBodyString * Mux.MaxPathValues and other improvements * Mux PathValue improvemnt and fixes * MuxSlice more method muxing improvements * diagram out interesting approach to form parsing for clanker * refactor RequestParseForm and achieve greatness in API design * explicit naming of headerCapacityKV value in kvBuffer.Reset * fix Mux bug not matching paths correctly; httpraw HTTP V1 naming applied * rename many examples,use httphi in examples,remove useless maxAwaitingConn field * add ipv4.String * add ipv4 UnspecifiedAddr and BroadcastAddr * add ethernet.String
2026-08-13 03:13:43 +00:00 · 2026-07-31 12:47:33 -03:00
parent 5c54030f19
commit 1884cfc9b7
35 changed files with 2192 additions and 406 deletions
@@ -0,0 +1,115 @@
+//go:build !tinygo && linux
+
+package main
+
+import (
+	"log/slog"
+	"net"
+	"os"
+	"strconv"
+	"sync/atomic"
+	"time"
+
+	"github.com/soypat/lneto/http/httphi"
+)
+
+const (
+	kB          = 1 << 10
+	listenPort  = 8080
+	bufferSizes = 2 * kB
+	// A browser sends around twenty header fields; a request carrying more
+	// than this is answered 431 rather than parsed into memory it was not
+	// given. Each field costs 8 bytes of table.
+	numHeaderFields = 32
+	numGoroutines   = 4
+	readTimeout     = 2 * time.Second
+)
+
+func main() {
+	if err := run(); err != nil {
+		println("Error:", err.Error())
+		os.Exit(1)
+	}
+	println("DONE")
+}
+
+func run() error {
+	ln, err := net.Listen("tcp", ":"+strconv.Itoa(listenPort))
+	if err != nil {
+		return err
+	}
+	defer ln.Close()
+	print("listening on http://localhost:", listenPort, "\n")
+
+	var server Server
+	server.Handle("GET /", server.homepage)
+
+	var router httphi.Router
+	err = router.Configure(httphi.RouterConfig{
+		FixedNumGoroutines:          numGoroutines,
+		RequestHeaderBufferSize:     bufferSizes,
+		RequestNumHeaderKVCap:       numHeaderFields,
+		ResponseHeaderMinBufferSize: bufferSizes,
+		Mux:                         &server.mux,
+		Logger:                      slog.Default(),
+	})
+	if err != nil {
+		return err
+	}
+	defer router.Shutdown()
+
+	for {
+		conn, err := ln.Accept()
+		if err != nil {
+			return err
+		}
+		// The connection owns the idle policy: a peer that opens a socket and
+		// then stalls fails its read instead of holding a router goroutine.
+		conn.SetReadDeadline(time.Now().Add(readTimeout))
+		err = router.Handle(conn)
+		if err != nil {
+			// Every goroutine is busy and the queue is full. Dropping the
+			// connection is the backpressure: memory stays bounded.
+			slog.Warn("dropped connection", slog.String("remote", conn.RemoteAddr().String()), slog.String("err", err.Error()))
+			conn.Close()
+		}
+	}
+}
+
+const (
+	htmlHead = `<html><body bgcolor="#000080" text="#00FF00"><center>` +
+		`<marquee><font face="Comic Sans MS" size="5" color="#FFFF00">` +
+		`*** WELCOME TO MY HOMEPAGE ***</font></marquee>` +
+		`<h1><blink>YOU ARE VISITOR #`
+	htmlTail = `!</blink></h1>` +
+		`<font color="#FF00FF">Sign my guestbook!</font>` +
+		`<br><hr>Best viewed in Netscape Navigator</center></body></html>`
+	// maxPage bounds the rendered page: both halves plus the visitor number.
+	maxPage = len(htmlHead) + 20 + len(htmlTail)
+)
+
+type Server struct {
+	// visits counts served requests.
+	Visits atomic.Uint64
+	mux    httphi.MuxSlice
+}
+
+func (sv *Server) Handle(pattern string, handler httphi.HandlerFunc) {
+	// Middleware for all incoming requests declared here.
+	sv.mux.Handle(pattern, func(exch *httphi.Exchange) {
+		println(exch.RequestMethod().String(), exch.MuxPattern())
+		handler(exch)
+	})
+}
+
+func (sv *Server) homepage(exch *httphi.Exchange) {
+	var page [maxPage]byte
+	n := copy(page[:], htmlHead)
+	n += len(strconv.AppendUint(page[n:n], sv.Visits.Add(1), 10))
+	n += copy(page[n:], htmlTail)
+	exch.Respond(200, "text/html", page[:n])
+}
+
+func (sv *Server) form(exch *httphi.Exchange) {
+
+}