golang HTTP基础

http.ListenAndServe

http.ListenAndServe 是 Go 语言标准库 net/http 包中的一个函数,用于启动一个 HTTP 服务器并监听指定的端口,以便接收和处理来自客户端的 HTTP 请求。这个函数是构建 Web 服务器和 Web 服务的基础。

函数签名

go 复制代码
func ListenAndServe(address string, handler Handler) error

参数
address:一个字符串,指定服务器监听的网络地址和端口。通常格式为 "host:port",例如 ":8080" 表示监听所有可用网络接口上的 8080 端口。如果省略 host 部分,默认监听所有网络接口**(即 0.0.0.0)。

handler:一个实现了 http.Handler 接口的值,用于处理传入的 HTTP 请求。http.Handler 是一个接口,包含一个方法 ServeHTTP(ResponseWriter, *Request),用于处理 HTTP 请求。如果传递 nil,则默认使用 http.DefaultServeMux,这是一个多路复用器,它将 URL 路径映射到对应的处理器。

返回值

函数返回一个 error 类型,如果服务器成功启动并开始监听,则返回 nil。如果启动服务器时发生错误(例如,指定的端口已经被占用),函数会返回一个错误。

工作流程

  • 监听端口:服务器尝试在指定的地址和端口上监听 TCP 连接。
  • 接收连接:一旦监听成功,服务器会无限循环等待客户端的连接。
  • 处理请求:对于每个接收到的连接,服务器会创建一个 http.Request 对象来表示请求,并使用提供的 handler 来处理这个请求。如果 handler 是 nil,则使用默认的多路复用器 http.DefaultServeMux。
  • 发送响应:处理器处理请求后,会通过 http.ResponseWriter 发送响应给客户端。
  • 循环处理:服务器会持续这个过程,直到发生错误或被外部信号中断。

例子:

go 复制代码
package main

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

// 定义一个处理器函数
func myHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "Hello, World!")
}

func main() {
    // 使用 http.HandleFunc 注册 URL 路径和处理器函数
    http.HandleFunc("/", myHandler)

    // 启动 HTTP 服务器
    log.Println("Starting server on port 8080...")
    err := http.ListenAndServe(":8080", nil)
    if err != nil {
        log.Fatal("ListenAndServe: ", err)
    }
}

在这个例子中,我们定义了一个名为 myHandler 的处理器函数,它简单地向客户端返回 "Hello, World!"。然后我们使用 http.HandleFunc 将根 URL 路径("/")与 myHandler 函数关联起来。最后,我们调用 http.ListenAndServe 来启动服务器,监听 8080 端口。

当服务器运行时,任何对服务器根路径的 HTTP GET 请求都会被 myHandler 函数处理。如果服务器成功启动,它会打印一条日志消息,并持续运行,直到被外部因素(如操作系统信号)终止。如果启动服务器时发生错误(例如,指定的端口已经被占用),函数会返回一个错误。

http.Handle

  • 当你调用 http.Handle 时,你实际上是在向 http.DefaultServeMux 注册一个路由和对应的处理器。
  • 当你调用 http.ListenAndServe 时,如果传入 nil 作为处理器,那么它会使用 http.DefaultServeMux 来处理请求;如果你传入了一个自定义的 http.ServeMux 实例,那么它会使用这个自定义的实例来处理请求。

例子:

go 复制代码
package main

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

func TestHTTP(t *testing.T) {

	http.Handle("/api", http.HandlerFunc(
		func(w http.ResponseWriter, r *http.Request) {
			fmt.Fprintln(w, "hello world")
		}))

	go http.ListenAndServe("localhost:8080", nil)
	go http.ListenAndServe("localhost:8081", nil)

	select {}
}
  • 其中访问localhost:8080/api和localhost:8080/api都会显示"hello world"
  • select {}是为了使主进程阻塞,让服务器持续提供服务
  • 多个http.ListenAndServe会阻塞,需要在不同goroutine上异步运行
相关推荐
ykuaile_h81 分钟前
Go 编译报错排查:vendor/golang.org/x/crypto/cryptobyte/asn1 no Go source files
后端·golang
Nejosi_念旧14 小时前
解读 Go 中的 constraints包
后端·golang·go
风无雨14 小时前
GO 启动 简单服务
开发语言·后端·golang
小明的小名叫小明14 小时前
Go从入门到精通(19)-协程(goroutine)与通道(channel)
后端·golang
光影少年14 小时前
从前端转go开发的学习路线
前端·学习·golang
斯普信专业组14 小时前
Go语言包管理完全指南:从基础到最佳实践
开发语言·后端·golang
2501_9159184116 小时前
Fiddler中文版全面评测:功能亮点、使用场景与中文网资源整合指南
android·ios·小程序·https·uni-app·iphone·webview
Digitally19 小时前
[5种方法] 如何将iPhone短信保存到电脑
ios·iphone
高hongyuan1 天前
Go语言教程-占位符及演示代码
开发语言·后端·golang
甘露寺1 天前
HTTP 请求体类型详解:选择最适合的数据提交格式
网络·网络协议·http