从零构建GEO Web框架：HTTP基础与路由设计深度解析

前言

在Web开发中，框架选型往往是第一步。对于Java开发者，Spring MVC是首选；而Go语言开发者则可能选择Beego、Gin或Iris。尽管这些框架各有特色，但它们的设计思想殊途同归。

初学Go语言的net/http标准库时，我们可能会觉得它已经封装了HTTP协议解析、请求参数提取等细节，足以支撑简单的Web开发。但为何还需要在标准库之上再封装一层？直接使用net/http开发，就像用Java的Servlet构建Web应用——虽然可行，但大量重复逻辑未被抽象，导致代码臃肿、难以维护。

本文将从零开始，构建一个名为GEO的轻量级Web框架，深入理解其核心设计。GEO框架的灵感来源于极客兔兔的Gee教程，我们将通过实践掌握路由、处理器等基础组件。

HTTP基础与标准库

启动Web服务

Go语言的net/http库提供了HTTP网络编程的基础接口。以下示例展示了如何使用标准库处理请求：

package main

import (
	"fmt"
	"log"
	"net/http"
)

func main() {
	// 注册静态路由
	http.HandleFunc("/", indexHandler)
	http.HandleFunc("/hello", helloHandler)
	log.Fatal(http.ListenAndServe(":9999", nil))
}

func indexHandler(w http.ResponseWriter, req *http.Request) {
	fmt.Fprintf(w, "URL.Path = %q\n", req.URL.Path)
}

func helloHandler(w http.ResponseWriter, req *http.Request) {
	for k, v := range req.Header {
		fmt.Fprintf(w, "Header[%q] = %q\n", k, v)
	}
}

这里设置了两个路由：/和/hello，分别绑定indexHandler和helloHandler。访问/会返回路径信息，而/hello则返回请求头。ListenAndServe的第一个参数是监听地址，第二个参数为nil表示使用标准库默认处理器。

实现http.Handler接口

通过查看net/http源码，可以发现Handler是一个接口：

package http

type Handler interface {
	ServeHTTP(w ResponseWriter, r *Request)
}

func ListenAndServe(address string, h Handler) error

只要传入实现了ServeHTTP的实例，所有HTTP请求都会交给该实例处理。这类似于Spring MVC的DispatcherServlet——所有请求先被统一拦截，再进行后续分发。

package main

import (
	"fmt"
	"log"
	"net/http"
)

type Engine struct{}

func (engine *Engine) ServeHTTP(w http.ResponseWriter, req *http.Request) {
	switch req.URL.Path {
	case "/":
		fmt.Fprintf(w, "URL.Path = %q\n", req.URL.Path)
	case "/hello":
		for k, v := range req.Header {
			fmt.Fprintf(w, "Header[%q] = %q\n", k, v)
		}
	default:
		fmt.Fprintf(w, "404 NOT FOUND: %s\n", req.URL)
	}
}

func main() {
	engine := new(Engine)
	log.Fatal(http.ListenAndServe(":9999", engine))
}

通过定义Engine结构体并实现ServeHTTP，我们获得了统一的控制入口，可以自由定义路由规则和添加通用逻辑。

GEO框架雏形

目录结构

geo/
├── geo.go
├── go.mod
main.go

go.mod配置

module main

go 1.18

require geo v0.0.0

replace geo => ./geo

从Go 1.11开始，引用相对路径的包需使用replace指令。

main.go

package main

import (
	"fmt"
	"net/http"
	"geo"
)

func main() {
	r := geo.New()
	r.GET("/", func(w http.ResponseWriter, req *http.Request) {
		fmt.Fprintf(w, "URL.Path = %q\n", req.URL.Path)
	})
	r.GET("/hello", func(w http.ResponseWriter, req *http.Request) {
		for k, v := range req.Header {
			fmt.Fprintf(w, "Header[%q] = %q\n", k, v)
		}
	})
	r.Run(":9999")
}

如果熟悉Gin框架，会发现这种API风格非常亲切。GEO框架的设计参考了Gin：使用New()创建实例，GET()添加路由，Run()启动服务。

geo.go核心实现

package geo

import (
	"fmt"
	"net/http"
)

type HandlerFunc func(http.ResponseWriter, *http.Request)

type Engine struct {
	router map[string]HandlerFunc
}

func New() *Engine {
	return &Engine{router: make(map[string]HandlerFunc)}
}

func (engine *Engine) addRoute(method string, pattern string, handler HandlerFunc) {
	key := method + "-" + pattern
	engine.router[key] = handler
}

func (engine *Engine) GET(pattern string, handler HandlerFunc) {
	engine.addRoute("GET", pattern, handler)
}

func (engine *Engine) POST(pattern string, handler HandlerFunc) {
	engine.addRoute("POST", pattern, handler)
}

func (engine *Engine) Run(addr string) (err error) {
	return http.ListenAndServe(addr, engine)
}

func (engine *Engine) ServeHTTP(w http.ResponseWriter, req *http.Request) {
	key := req.Method + "-" + req.URL.Path
	if handler, ok := engine.router[key]; ok {
		handler(w, req)
	} else {
		w.WriteHeader(http.StatusNotFound)
		fmt.Fprintf(w, "404 NOT FOUND: %s\n", req.URL)
	}
}

HandlerFunc定义了路由处理函数的类型。Engine结构体包含一个路由映射表router，键由HTTP方法和静态路由路径组成（如GET-/、POST-/hello），值是对应的处理函数。这种设计允许相同路径不同方法映射到不同处理器。

addRoute方法注册路由，GET和POST是便捷方法。Run封装了ListenAndServe。ServeHTTP解析请求路径，查找路由表，若找到则调用对应处理器，否则返回404。

总结

通过本教程，我们从零开始构建了GEO框架的雏形，理解了HTTP基础、Handler接口以及路由映射的核心机制。GEO框架虽然简单，但已具备路由注册和请求分发的基本能力，为后续扩展动态路由、中间件等功能奠定了基础。

GEO框架的设计体现了Web框架的核心思想：抽象通用逻辑、提供统一入口、简化开发流程。掌握这些基础，将帮助我们更深入地理解高级框架的设计哲学。