5 Go语言中的HTTP编程

在前一篇中，我们探讨了Go语言中并发编程的sync包的应用。在这一篇中，我们将深入探讨Go语言的网络编程，尤其是HTTP编程。HTTP是网络通信的基础，通过HTTP协议，我们能够构建强大的Web应用程序和API。

HTTP概述

HTTP（超文本传输协议）是应用层协议，通常用于客户端和服务器之间的请求和响应交互。Go语言提供了net/http包，使得HTTP编程变得相对简单。

创建一个简单的HTTP服务器

我们首先来创建一个最基本的HTTP服务器。以下示例代码展示了如何使用Go语言创建一个HTTP服务器，该服务器会在访问根路径时返回“Hello, World!”。

package main

import (
    "fmt"
    "net/http"
)

func handler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "Hello, World!")
}

func main() {
    http.HandleFunc("/", handler)
    fmt.Println("Starting server at :8080")
    err := http.ListenAndServe(":8080", nil)
    if err != nil {
        fmt.Println("Error starting server:", err)
    }
}

解析代码

1. 导入net/http包，它提供HTTP客户端和服务器的实现。
2. handler函数是处理HTTP请求的核心。它接收http.ResponseWriter和*http.Request作为参数。
3. 使用http.HandleFunc将根路径/请求与handler函数关联。
4. http.ListenAndServe启动HTTP服务器，在8080端口监听请求。

处理HTTP请求的方法

HTTP方法（如 GET, POST, PUT, DELETE等）定义了客户端向服务器发送请求的方式。在我们的handler函数中，我们可以通过请求对象r来获取请求方法：

func handler(w http.ResponseWriter, r *http.Request) {
    switch r.Method {
    case http.MethodGet:
        fmt.Fprintln(w, "You made a GET request!")
    case http.MethodPost:
        fmt.Fprintln(w, "You made a POST request!")
    // 可根据需要添加其他HTTP方法的处理
    default:
        http.Error(w, "Unsupported request method", http.StatusMethodNotAllowed)
    }
}

路由和参数

在复杂的应用程序中，你将需要支持多个路由和处理请求参数。Go提供了http.ServeMux，让我们能更优雅地管理路由。

以下是一个包含多个路由和路径参数的示例：

package main

import (
    "fmt"
    "net/http"
)

func helloHandler(w http.ResponseWriter, r *http.Request) {
    name := r.URL.Query().Get("name")
    if name == "" {
        name = "World"
    }
    fmt.Fprintf(w, "Hello, %s!", name)
}

func main() {
    http.HandleFunc("/hello", helloHandler)
    fmt.Println("Starting server at :8080")
    err := http.ListenAndServe(":8080", nil)
    if err != nil {
        fmt.Println("Error starting server:", err)
    }
}

在这个例子中，我们创建了一个/hello的路由，可以传递查询参数name，例如访问/hello?name=Go，将返回“Hello, Go!”。

JSON响应

HTTP应用程序中，尤其是API应用，通常需要返回JSON格式的响应。Go的encoding/json包提供了方便的JSON编码和解码功能。下面的示例演示了如何处理JSON请求与响应：

package main

import (
    "encoding/json"
    "net/http"
)

type Message struct {
    Text string `json:"text"`
}

func jsonHandler(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("Content-Type", "application/json")
    msg := Message{Text: "Hello, JSON!"}
    json.NewEncoder(w).Encode(msg)
}

func main() {
    http.HandleFunc("/json", jsonHandler)
    http.ListenAndServe(":8080", nil)
}

此处，我们定义了一个Message结构体，并将其编码为JSON格式返回给客户端。访问/json路径将返回一个JSON对象 {"text": "Hello, JSON!"}。

小结

在本篇中，我们讨论了Go语言中的HTTP编程，包括创建HTTP服务器、处理不同的HTTP方法、路由、查询参数和JSON响应等内容。Go语言的net/http包提供的强大功能，使得构建HTTP服务变得简单并且高效。

在下一篇中，我们将迁移到网络编程的另一个重要方面：TCP/IP编程。我们会探讨如何使用Go语言的TCP功能创建客户端和服务器，以便更深入地理解网络编程的底层实现。