21、Go语言网络与Web开发实战-优快云博客

本文链接：https://blog.youkuaiyun.com/data3/article/details/151205635

Go语言网络与Web开发实战

1. UDP编程基础

1.1 UDP服务器创建

在Go语言中， net.ListenUDP 函数可用于创建UDP服务器。不过，这里可能会让人疑惑， net.UDPConn 为何同时实现了 net.PacketConn 和 net.Conn 接口。毕竟， net.UDPConn 是面向数据包的连接，而 net.Conn 是面向流的连接， net.TCPConn 结构体也实现了 net.Conn 接口。这其实源于最初的伯克利套接字API，在类Unix系统中，套接字是面向流的，UDP和TCP都基于套接字实现，所以它们都实现了 net.Conn 接口。

1.2 UDP客户端创建

1.2.1 使用 `net.Dial` 函数

若要创建一个UDP客户端向UDP服务器发送数据，可使用 net 包中的 Dial 函数连接到UDP服务器，然后使用 net.UDPConn 接口的 Write 方法向连接写入数据。示例代码如下：

package main

import (
    "log"
    "net"
)

func main() {
    conn, err := net.Dial("udp", ":9001")
    if err != nil {
        log.Fatal(err)
    }
    defer conn.Close()
    conn.Write([]byte("Hello from UDP client"))
}

操作步骤如下：
1. 打开一个终端，使用 nc 命令设置一个UDP监听器：

$ nc -l -u 9001

打开另一个终端，运行上述UDP客户端代码，此时服务器端会打印出 “Hello from UDP client”。

若要测试IPv6，可在服务器端使用 -6 标志强制 nc 使用IPv6：

$ nc -l -u -6 9001

运行相同的客户端代码，会看到相同的输出。

1.2.2 使用 `net.DialUDP` 函数

也可以使用 net.DialUDP 函数创建UDP客户端。该函数接受一个 net.UDPAddr 作为参数，因此需要先使用 net.ResolveUDPAddr 函数解析并创建地址，再使用 net.DialUDP 函数创建连接。示例代码如下：

package main

import (
    "log"
    "net"
)

func main() {
    raddr, err := net.ResolveUDPAddr("udp", ":9001")
    if err != nil {
        log.Fatal(err)
    }
    conn, err := net.DialUDP("udp", nil, raddr)
    if err != nil {
        log.Fatal(err)
    }
    defer conn.Close()
    _, err = conn.Write([]byte("Hello from UDP client"))
    if err != nil {
        log.Fatal(err)
    }
}

操作步骤如下：
1. 同样使用 nc 命令在终端设置UDP监听器。
2. 运行上述客户端代码，服务器端会显示相应信息。

2. Web开发基础

2.1 Web应用概述

Web应用无处不在，任何支持开发与人类交互软件的编程语言，都必然支持Web应用开发。Go语言也不例外。Web应用是一种计算机程序，它响应客户端的HTTP请求，并在HTTP响应中向客户端返回HTML。Web服务则是响应非人类用户使用的浏览器（而是其他计算机程序）的HTTP请求的计算机程序，通常返回JSON，也越来越多地返回二进制格式。HTTP是驱动万维网的应用层通信协议，自1990年定义以来，仅经历了三次迭代更改，目前HTTP 1.1是使用最广泛的版本，HTTP 2是当前版本，HTTP 3正在开发中。

2.2 Web应用的组成部分

一个Web应用通常由三部分组成：
| 组成部分 | 描述 |
| ---- | ---- |
| 多路复用器 | 将请求URI与处理函数匹配的路由器 |
| 一个或多个处理程序 | 处理请求并返回响应的函数 |
| 模板引擎 | 将一个或多个模板与数据结合并渲染响应的引擎 |

多路复用器会根据URL路由将请求URI与处理程序匹配。处理函数负责接收请求、处理请求数据并返回响应。模板引擎用于渲染响应体，它可以生成各种格式的内容，如HTML、JSON、XML、纯文本或二进制数据（如图像和PDF）。

2.3 创建简单Web应用

2.3.1 使用标准库

若要创建一个简单的Web应用，响应HTTP请求并返回HTTP响应，可使用 net/http 包。以下是一个简单的 “Hello World” 示例：

package main

import (
    "net/http"
)

func main() {
    http.HandleFunc("/", index)
    http.ListenAndServe(":8000", nil)
}

func index(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("Hello World"))
}

操作步骤如下：
1. 在终端运行以下命令启动服务器：

$ go run main.go

打开浏览器，访问 http://localhost:8000/ ，会看到 “Hello World” 消息。

在上述代码中， http.ListenAndServe 函数用于启动Web服务器，第一个参数是监听地址，格式为 <host>:<port> ；第二个参数是处理程序，若为 nil ，则使用默认的多路复用器 http.DefaultServeMux 。 http.HandleFunc 函数用于注册处理函数，它会调用 http.DefaultServeMux 的 HandleFunc 方法。

2.3.2 使用第三方多路复用器

除了使用标准库的多路复用器，还可以使用第三方多路复用器，如 chi 包。示例代码如下：

package main

import (
    "net/http"
    "github.com/go-chi/chi/v5"
)

func main() {
    mux := chi.NewRouter()
    mux.Get("/", index)
    http.ListenAndServe(":3000", mux)
}

func index(w http.ResponseWriter, r *http.Request) {
    w.Write([]byte("Hello World"))
}

操作步骤与使用标准库类似，只需将 http.ListenAndServe 函数的第二个参数替换为新创建的多路复用器。第三方多路复用器通常更优化、功能更强大，除非只使用标准库，否则建议使用第三方多路复用器。

2.4 处理HTTP请求

2.4.1 提取请求信息

可使用 http.Request 结构体提取HTTP请求的信息，使用 http.ResponseWriter 向客户端发送HTTP响应。 http.Request 结构体包含请求的重要信息和一些有用的方法，重要部分如下：
- URL ：请求行中发送的URL的表示。
- Header ：请求中发送的所有HTTP头的映射。
- Body ：包含请求体的 io.ReadCloser 。
- Form 、 PostForm 和 MultipartForm ：表单数据。

还可以通过 Request 的方法访问请求中的cookie、引用URL和用户代理。

2.4.2 示例代码

以下是几个示例代码，展示如何提取不同类型的请求信息：
- 提取URL信息 ：

package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/hello/world", hello)
    http.ListenAndServe(":8000", nil)
}

func hello(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Method : %s, Host : %s", r.Method, r.Host)
    fmt.Fprintf(w, "Path : %s, Query : %s\n", r.URL.Path, r.URL.Query())
}

运行该代码，在浏览器中访问 http://localhost:8000/hello/world?name=sausheong ，会看到请求的方法、主机、路径和查询信息。
- 提取请求头信息 ：

package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/headers", headers)
    http.ListenAndServe(":8000", nil)
}

func headers(w http.ResponseWriter, r *http.Request) {
    for k, v := range r.Header {
        fmt.Fprintf(w, "%s: %s\n", k, v)
    }
}

运行代码后，在浏览器中访问 http://localhost:8000/headers ，会看到请求头信息。不同浏览器发送的请求头可能不同。
- 提取请求体信息 ：

package main

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

func main() {
    http.HandleFunc("/body", body)
    http.ListenAndServe(":8000", nil)
}

func body(w http.ResponseWriter, r *http.Request) {
    body, _ := io.ReadAll(r.Body)
    fmt.Fprintf(w, "%s", body)
}

使用 curl 命令测试：

$ curl -X POST -d "Hello World" http://localhost:8000/body

服务器会返回请求体的内容。

2.5 处理HTML表单

2.5.1 HTML表单基础

HTML表单通常用于向服务器提交数据。表单元素允许用户输入数据，当用户点击提交按钮或触发表单提交时，数据会被发送到服务器。表单数据以名值对的形式发送，其格式由表单的 enctype 属性指定。默认值为 application/x-www-form-urlencoded ，此时浏览器会将表单数据编码为长查询字符串，名值对用 & 分隔，名和值用 = 分隔。若将 enctype 设置为 multipart/form-data ，每个名值对将转换为一个MIME消息部分。如果发送简单文本数据，使用URL编码表单更好；如果发送大量数据，则使用 multipart/form-data 表单更好。

2.5.2 Go处理HTML表单

在Go中处理HTML表单很简单，可使用 http.Request 的 Form 字段或 FormValue 方法访问表单数据。示例代码如下：
- 使用 Form 字段 ：

package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/form", form)
    http.ListenAndServe(":8000", nil)
}

func form(w http.ResponseWriter, r *http.Request) {
    r.ParseForm()
    for k, v := range r.Form {
        fmt.Fprintf(w, "%s: %s\n", k, v)
    }
}

操作步骤如下：
1. 运行上述代码启动服务器。
2. 使用 curl 命令发送POST请求：

$ curl -X POST -d "name=sau sheong&book=go cookbook" http://localhost:8000/form

会看到输出：

name: [sau sheong]
book: [go cookbook]

使用 FormValue 方法 ：

package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/form_value", formValue)
    http.ListenAndServe(":8000", nil)
}

func formValue(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, r.FormValue("name"))
}

运行相同的 curl 命令，会看到输出：

sau sheong

使用 FormValue 方法无需手动调用 ParseForm 方法，它会自动解析表单数据。

2.6 上传文件到Web应用

2.6.1 上传文件原理

向Web应用上传文件是常见任务，通常通过HTML表单完成。要上传文件，需将表单的 enctype 属性设置为 multipart/form-data 。

2.6.2 示例代码

以下是一个允许用户上传文件的Web应用示例，该应用会显示文件名和文件大小，并将文件保存到本地文件系统：

package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/upload", upload)
    http.ListenAndServe(":8000", nil)
}

func upload(w http.ResponseWriter, r *http.Request) {
    file, fileHeader, err := r.FormFile("uploadfile")
    if err != nil {
        fmt.Println(err)
        return
    }
    // 后续可添加保存文件到本地的代码
    fmt.Fprintf(w, "Filename: %s, Size: %d", fileHeader.Filename, fileHeader.Size)
}

操作步骤如下：
1. 运行上述代码启动服务器。
2. 使用HTML表单或工具（如Postman）上传文件，服务器会显示文件名和文件大小。

综上所述，通过以上内容，我们学习了Go语言中UDP编程和Web开发的基础知识，包括UDP客户端和服务器的创建、Web应用的组成部分、处理HTTP请求、处理HTML表单以及上传文件到Web应用等。这些知识为进一步开发复杂的网络和Web应用奠定了基础。

3. 总结与拓展

3.1 知识总结

在前面的内容中，我们详细学习了Go语言在网络编程和Web开发方面的相关知识，下面通过表格对这些知识进行总结：
| 类别 | 具体内容 | 关键函数/方法 | 示例代码 |
| ---- | ---- | ---- | ---- |
| UDP编程 | UDP服务器创建 | net.ListenUDP | |
| | UDP客户端创建 | net.Dial 、 net.DialUDP 、 net.ResolveUDPAddr | 见前文相关代码 |
| Web开发 | 创建简单Web应用 | http.HandleFunc 、 http.ListenAndServe | 见前文相关代码 |
| | 处理HTTP请求 | http.Request 、 http.ResponseWriter | 见前文相关代码 |
| | 处理HTML表单 | http.Request 的 Form 字段、 FormValue 方法 | 见前文相关代码 |
| | 上传文件到Web应用 | r.FormFile | 见前文相关代码 |

3.2 拓展思路

3.2.1 UDP编程拓展

并发处理 ：在实际的UDP服务器开发中，可能会有多个客户端同时发送请求。可以使用Go的goroutine来实现并发处理，提高服务器的性能。以下是一个简单示例：

package main

import (
    "fmt"
    "log"
    "net"
)

func handleUDPConnection(conn *net.UDPConn) {
    buffer := make([]byte, 1024)
    n, addr, err := conn.ReadFromUDP(buffer)
    if err != nil {
        log.Println("Error reading from UDP connection:", err)
        return
    }
    fmt.Printf("Received message from %s: %s\n", addr, string(buffer[:n]))
    // 可以在这里添加更多处理逻辑
}

func main() {
    addr, err := net.ResolveUDPAddr("udp", ":9001")
    if err != nil {
        log.Fatal(err)
    }
    conn, err := net.ListenUDP("udp", addr)
    if err != nil {
        log.Fatal(err)
    }
    defer conn.Close()

    for {
        go handleUDPConnection(conn)
    }
}

3.2.2 Web开发拓展

数据库集成 ：在Web应用中，通常需要与数据库进行交互。可以使用Go的数据库驱动来连接和操作数据库，如MySQL、PostgreSQL等。以下是一个简单的使用 database/sql 包连接MySQL数据库的示例：

package main

import (
    "database/sql"
    "fmt"
    "log"
    "net/http"

    _ "github.com/go-sql-driver/mysql"
)

func main() {
    db, err := sql.Open("mysql", "user:password@tcp(127.0.0.1:3306)/dbname")
    if err != nil {
        log.Fatal(err)
    }
    defer db.Close()

    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        var name string
        err := db.QueryRow("SELECT name FROM users LIMIT 1").Scan(&name)
        if err != nil {
            http.Error(w, err.Error(), http.StatusInternalServerError)
            return
        }
        fmt.Fprintf(w, "Hello, %s!", name)
    })

    log.Fatal(http.ListenAndServe(":8000", nil))
}

中间件使用 ：在Web开发中，中间件可以用于处理一些通用的任务，如日志记录、身份验证等。以下是一个简单的日志中间件示例：

package main

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

func loggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        log.Printf("Received request: %s %s", r.Method, r.URL.Path)
        next.ServeHTTP(w, r)
    })
}

func main() {
    http.Handle("/", loggingMiddleware(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Hello, World!")
    })))

    log.Fatal(http.ListenAndServe(":8000", nil))
}

3.3 流程图展示

下面是一个简单的Web应用处理HTTP请求的流程图：

graph TD;
    A[客户端发送HTTP请求] --> B[Web服务器接收请求];
    B --> C{多路复用器匹配处理程序};
    C -->|匹配成功| D[调用处理函数];
    C -->|匹配失败| E[返回404错误];
    D --> F[处理请求数据];
    F --> G[生成响应];
    G --> H[返回响应给客户端];

通过以上的总结和拓展，我们不仅对Go语言的网络编程和Web开发知识有了更系统的认识，还了解了如何进一步拓展这些知识，开发出更复杂、更强大的应用程序。希望这些内容能帮助你在Go语言的学习和实践中取得更好的成果。