Go 语言 net/http 包使用之HTTP 服务器、客户端与中间件详解

 更新时间:2025年05月19日 09:43:17   作者:Chandler24  
Go 语言标准库中的net/http包十分的优秀,提供了非常完善的 HTTP 客户端与服务端的实现,仅通过几行代码就可以搭建一个非常简单的 HTTP 服务器,本文给大家介绍Go语言net/http包使用之HTTP服务器、客户端与中间件的操作,感兴趣的朋友一起看看吧

Go 语言标准库中的net/http包十分的优秀,提供了非常完善的 HTTP 客户端与服务端的实现,仅通过几行代码就可以搭建一个非常简单的 HTTP 服务器。几乎所有的 go 语言中的 web 框架,都是对已有的 http 包做的封装与修改,因此,十分建议学习其他框架前最好先行掌握 http 包。

HTTP服务器

我们先初步介绍以下net/http包的使用,通过http.HandleFunc()http.ListenAndServe()两个函数就可以轻松创建一个简单的Go web服务器,示例代码如下:

package main
import (
    "fmt"
    "net/http"
)
func helloHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello, World!")
}
func main() {
    http.HandleFunc("/hello", helloHandler)
    fmt.Println("Server starting on port 8080...")
    http.ListenAndServe(":8080", nil)
}

路由处理

http包提供了两种路由注册方式:

处理器函数(HandlerFunc)http.HandleFunc(pattern string, handler func(ResponseWriter, *Request))

func helloHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello, World!")
}
http.HandleFunc("/hello", helloHandler)

这种形式最为简单直接,适合处理简单的路由逻辑。http.HandleFunc内部会将函数转换为HandlerFunc类型,它实现了Handler接口。

处理器对象(Handler)http.Handle(pattern string, handler Handler)

type CounterHandler struct {
    count int
}
func (h *CounterHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    h.count++
    fmt.Fprintf(w, "Visitor count: %d", h.count)
}
handler := &CounterHandler{}
http.Handle("/counter", handler)

ServeMux路由

http.ServeMux是Go默认提供的多路复用器(路由器),它实现了Handler接口,可以看作是一个高级的路由管理器。它的工作原理是:

  • 注册路由时,将路径模式(pattern)和处理器(handler)存储在内部映射中
  • 收到请求时,按照最长匹配原则查找对应的处理器
  • 如果找不到精确匹配,会尝试查找带斜杠的路径
  • 最终都找不到则返回404错误
mux := http.NewServeMux()
mux.HandleFunc("/products/", productsHandler)
mux.HandleFunc("/articles/", articlesHandler)
mux.HandleFunc("/", indexHandler)

这种路由设计虽然简单,但对于RESTful API和传统Web应用已经足够。对于更复杂的需求,可以考虑第三方路由库如gorilla/mux。

HTTP客户端

GET请求

resp, err := http.Get("https://example.com")
if err != nil {
    // 处理错误
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
    // 处理错误
}
fmt.Println(string(body))

POST请求

data := url.Values{}
data.Set("key", "value")
resp, err := http.PostForm("https://example.com/form", data)
if err != nil {
    // 处理错误
}
defer resp.Body.Close()
// 处理响应...

自定义请求

req, err := http.NewRequest("GET", "https://example.com", nil)
if err != nil {
    // 处理错误
}
req.Header.Add("Authorization", "Bearer token123")
req.Header.Add("Content-Type", "application/json")
client := &http.Client{
    Timeout: time.Second * 10,
}
resp, err := client.Do(req)
if err != nil {
    // 处理错误
}
defer resp.Body.Close()
// 处理响应...

中间件模式

中间件是构建模块化HTTP服务的关键模式。Go的中间件本质上是处理器的包装函数,可以在不修改核心业务逻辑的情况下,添加横切关注点功能。

基本中间件结构

func loggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        // 调用下一个处理器
        next.ServeHTTP(w, r)
        // 记录请求日志
        log.Printf(
            "%s %s %s %v",
            r.Method,
            r.URL.Path,
            r.RemoteAddr,
            time.Since(start),
        )
    })
}

这种模式的工作流程是:

  • 中间件接收一个处理器作为参数
  • 返回一个新的处理器
  • 新处理器在执行原有逻辑前后添加额外功能

中间件链

多个中间件可以串联形成处理链:

func authMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        if !isAuthenticated(r) {
            http.Error(w, "Unauthorized", http.StatusUnauthorized)
            return
        }
        next.ServeHTTP(w, r)
    })
}
func main() {
    mux := http.NewServeMux()
    mux.HandleFunc("/secure", secureHandler)
    // 构建中间件链
    handler := loggingMiddleware(authMiddleware(mux))
    http.ListenAndServe(":8080", handler)
}

中间件的执行顺序是从外到内,即先注册的中间件后执行。上面的例子中,请求会先经过日志记录,再进行认证检查。

上下文传递

中间件常用于在请求间传递值,这时应该使用context.Context

func requestIDMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        // 生成唯一请求ID
        requestID := uuid.New().String()
        // 创建新上下文并存储请求ID
        ctx := context.WithValue(r.Context(), "requestID", requestID)
        // 设置响应头
        w.Header().Set("X-Request-ID", requestID)
        // 使用新上下文继续处理
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}
// 在处理器中获取请求ID
func handler(w http.ResponseWriter, r *http.Request) {
    requestID := r.Context().Value("requestID").(string)
    fmt.Fprintf(w, "Request ID: %s", requestID)
}

这种方式是线程安全的,避免了全局变量的问题,是Go中处理请求间数据传递的推荐方式。

参考资料:

Golang 中文学习文档 标准库 http包

到此这篇关于Go 语言 net/http 包使用之HTTP 服务器、客户端与中间件详解的文章就介绍到这了,更多相关Go 语言 net/http 包使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 使用Go语言实现并发处理CSV文件到数据库

    使用Go语言实现并发处理CSV文件到数据库

    Go 语言的 goroutine 和通道(channel)非常适合用来并发地处理数据,本文将通过简单示例介绍一下如何使用Go语言并发地处理 CSV 文件并将数据插入到数据库中,感兴趣的可以了解下
    2025-01-01
  • go语言用八百行代码实现一个JSON解析器

    go语言用八百行代码实现一个JSON解析器

    这篇文章主要为大家介绍了go语言用八百行代码实现一个JSON解析器实例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-07-07
  • 详解Golang互斥锁内部实现

    详解Golang互斥锁内部实现

    本篇文章主要介绍了详解Golang互斥锁内部实现,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-06-06
  • 掌握GoLang Fiber路由和中间件技术进行高效Web开发

    掌握GoLang Fiber路由和中间件技术进行高效Web开发

    这篇文章主要为大家介绍了GoLang Fiber路由和中间件进行高效Web开发,本文将深入探讨 Fiber 中的路由细节,学习如何创建和处理路由,深入了解使用路由参数的动态路由,并掌握在 Fiber 应用程序中实现中间件的艺术
    2024-01-01
  • go语言题解LeetCode1160拼写单词示例详解

    go语言题解LeetCode1160拼写单词示例详解

    这篇文章主要为大家介绍了go语言题解LeetCode1160拼写单词示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-12-12
  • 使用Go+GoQuery库实现头条新闻采集

    使用Go+GoQuery库实现头条新闻采集

    在本文中,我们将介绍如何使用Go语言和GoQuery库实现一个简单的爬虫程序,用于抓取头条新闻的网页内容,我们还将使用爬虫代理服务,提高爬虫程序的性能和安全性,我们将使用多线程技术,提高采集效率,最后,我们将展示爬虫程序的运行结果和代码,需要的朋友可以参考下
    2023-10-10
  • Go语言tunny的workerWrapper使用教程示例

    Go语言tunny的workerWrapper使用教程示例

    这篇文章主要为大家介绍了Go语言tunny的workerWrapper使用教程示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-07-07
  • Golang 使用gorm添加数据库排他锁,for update

    Golang 使用gorm添加数据库排他锁,for update

    这篇文章主要介绍了Golang 使用gorm添加数据库排他锁,for update,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-12-12
  • 利用GO语言实现多人聊天室实例教程

    利用GO语言实现多人聊天室实例教程

    聊天室的实现大家应该都遇到过,这篇文章主要给大家介绍了关于利用GO语言实现多人聊天室的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面来一起看看吧。
    2018-03-03
  • go语言简单网络程序实例分析

    go语言简单网络程序实例分析

    这篇文章主要介绍了go语言简单网络程序实现方法,实例分析了服务器端与客户端的实现技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-02-02

最新评论