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上异步运行
相关推荐
jerry6096 分钟前
7天用Go从零实现分布式缓存GeeCache(改进)(未完待续)
分布式·缓存·golang
杜杜的man39 分钟前
【go从零单排】Closing Channels通道关闭、Range over Channels
开发语言·后端·golang
earthzhang20215 小时前
《深入浅出HTTPS》读书笔记(7):安全的密码学Hash算法
网络·网络协议·http·https·1024程序员节
甘橘籽6 小时前
【RPC】 gRPC、pb基本使用--经验与总结
golang
杜杜的man6 小时前
【go从零单排】HTTP客户端和服务端
开发语言·http·golang
AI原吾6 小时前
探索 Python HTTP 的瑞士军刀:Requests 库
开发语言·python·http·requests
找藉口是失败者的习惯6 小时前
探索 HTTP 请求方法:GET、POST、PUT、DELETE 等的用法详解
网络·网络协议·http
vortex56 小时前
HTTP 协议及内外网划分详解
网络·网络协议·http·网络安全
莫轻言舞6 小时前
Java Http 接口对接太繁琐?试试 UniHttp 框架吧
网络·网络协议·http
流氓也是种气质 _Cookie6 小时前
鸿蒙HarmonyOS 网络请求获取数据Http
http·鸿蒙·鸿蒙系统