Go / 系统课时

认识 Go net/http 核心组件

认识 Go net/http 核心组件

net/http 把一次 HTTP 交互拆成职责明确的对象:客户端发请求,传输层管理连接,服务器接收,路由器选择处理器,处理器再读请求并写响应。掌握这些关系,后续组织 Web 服务代码会简单很多。

学习目标

  • 说清 Server、ServeMux、Handler 与 HandlerFunc 的调用关系
  • 理解 Request 与 ResponseWriter 在一次服务端请求中的职责
  • 理解 Client 与 Transport 为什么应该复用

服务端围绕 Handler 接口组织

http.Handler 是服务端最核心的抽象,它只有一个方法:ServeHTTP(http.ResponseWriter, *http.Request)。只要一个值实现了这个方法,就可以交给 http.Server 处理请求。

http.HandlerFunc 是函数适配器。普通函数只要签名为 func(http.ResponseWriter, *http.Request),就能转换成 HandlerFunc,避免为每个接口单独声明结构体。http.ServeMux 自身也实现了 Handler,它根据请求的主机和路径模式选择下一级处理器,因此通常被放到 Server.Handler 字段中。

net/http 核心组件调用关系

Request 与 ResponseWriter 只描述当前交互

*http.Request 包含方法、URL、Header、Body、上下文等本次请求信息。处理器应从 r.Context() 获取请求级取消信号和截止时间,而不是自己创建与请求生命周期无关的后台上下文。

http.ResponseWriter 是处理器写响应的出口。调用 Header() 可以设置响应头,WriteHeader 写状态码,Write 写响应体。第一次写响应体时如果还没有显式写状态码,默认会发送 200 OK。因此状态码和响应 Header 必须在首次写 Body 之前确定。

Client 与 Transport 位于请求发起侧

http.Client 提供 Do、Get 等高层请求 API;真正负责连接复用、代理、TLS 和底层 RoundTrip 的通常是 http.Transport。一个 Client 可以长期复用,一个 Transport 也应长期复用,这样才能使用连接池;为每次请求新建 Transport 会失去连接复用并增加资源开销。

下面的程序在本机随机端口启动 http.Server,用 ServeMux 路由到 HandlerFunc,再由一个复用的 Client 和 Transport 发起请求。随机端口不会出现在预期输出中。

go
package main

import (
	"context"
	"fmt"
	"io"
	"net"
	"net/http"
	"time"
)

func main() {
	mux := http.NewServeMux()
	mux.Handle("/hello", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		name := r.URL.Query().Get("name")
		if name == "" {
			name = "world"
		}

		// Handler 通过 ResponseWriter 设置响应元数据并写回消息体。
		w.Header().Set("Content-Type", "text/plain; charset=utf-8")
		fmt.Fprintf(w, "hello, %s\n", name)
	}))

	server := &http.Server{
		Handler:           mux,
		ReadHeaderTimeout: 2 * time.Second,
	}

	listener, err := net.Listen("tcp", "127.0.0.1:0")
	if err != nil {
		panic(err)
	}
	go func() {
		if err := server.Serve(listener); err != nil && err != http.ErrServerClosed {
			panic(err)
		}
	}()

	// Client 与 Transport 都放在请求外部创建并复用。
	transport := http.DefaultTransport.(*http.Transport).Clone()
	defer transport.CloseIdleConnections()
	client := &http.Client{
		Transport: transport,
		Timeout:   2 * time.Second,
	}

	resp, err := client.Get("http://" + listener.Addr().String() + "/hello?name=Go")
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Print(string(data))

	ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
	defer cancel()
	if err := server.Shutdown(ctx); err != nil {
		panic(err)
	}
}

预期输出

text
hello, Go

一次请求如何穿过这些组件

客户端调用 Client.Do 或 Get 后,Client 把请求交给配置的 Transport。Transport 建立或复用连接,把 HTTP 请求发送到服务器。Server 接收并解析请求后调用自己的 Handler;若这个 Handler 是 ServeMux,Mux 再选择具体业务 Handler。业务 Handler 读取 Request,通过 ResponseWriter 写回状态码、Header 与 Body。

服务端代码组织时,可以把 Server 看成运行边界,把 ServeMux 看成路由边界,把 Handler 看成业务入口;客户端侧则把 Client 看成调用策略,把 Transport 看成连接策略。理解这两条链路后,超时、连接池、中间件和路由拆分都会有明确的落点。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

认识 Go net/http 核心组件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通